# 在 AI 助手中,用 Pi 创建演示文稿 连接 Pi 后可创建演示文稿、查询进度,并回到 Pi 编辑。 ## 端点 https://pi-mcp.deepvinci.tech/api/v1/mcp 传输:Streamable HTTP。认证:OAuth with PKCE 和服务的动态客户端注册(DCR)流程。 ## 手动安装及其他方式 ### Codex 使用以下 Codex 命令添加 Pi MCP 远程连接;需要连接账号时,再由你本人完成浏览器授权。 官方指南: https://learn.chatgpt.com/docs/extend/mcp 1. 在添加 Pi 前,先辨认用户范围内实际生效的用户级、项目级或插件级配置来源。比较完整 MCP URL,而不是域名标签:仅当任意名称下的已有连接与此 URL 完全一致时才复用。已有完全匹配时,跳过下方所有添加或保存步骤。否则保持已有连接不变,并选择未使用的本地别名,例如从目标域名派生。无法安全辨认实际生效来源时应询问。请将下方所有示例中的 PI_CONNECTION_NAME 替换为选定名称;不要直接执行这个占位符。仅更改选定连接:绝不替换整个配置文件或修改其他连接。不要读取、打印、复制或写入凭证。 2. 仅当没有已有连接使用此完整 MCP URL 时,才在终端保存远程连接: ``` codex mcp add PI_CONNECTION_NAME --url https://pi-mcp.deepvinci.tech/api/v1/mcp ``` 3. 需要连接 Pi 账号时,请由你本人在浏览器完成授权: ``` codex mcp login PI_CONNECTION_NAME --oauth-client-registration dcr ``` ### Claude Desktop 在 Claude Desktop 中将 Pi 添加为账号级远程连接。 官方指南: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp 1. 在添加 Pi 前,先辨认用户范围内实际生效的用户级、项目级或插件级配置来源。比较完整 MCP URL,而不是域名标签:仅当任意名称下的已有连接与此 URL 完全一致时才复用。已有完全匹配时,跳过下方所有添加或保存步骤。否则保持已有连接不变,并选择未使用的本地别名,例如从目标域名派生。无法安全辨认实际生效来源时应询问。请将下方所有示例中的 PI_CONNECTION_NAME 替换为选定名称;不要直接执行这个占位符。仅更改选定连接:绝不替换整个配置文件或修改其他连接。不要读取、打印、复制或写入凭证。 2. 仅当没有已有连接使用此完整 MCP URL 时,才打开 Customize > Connectors > + Add > Add custom connector。 3. 仅当没有已有连接使用此完整 MCP URL 时,才添加远程 Pi 地址:https://pi-mcp.deepvinci.tech/api/v1/mcp 4. 若 Claude 在安装时要求 OAuth,请主动启动其原生授权流程,由用户本人完成账号级授权;不要用本地 JSON 配置替代。宿主没有可调用的原生流程时,说明具体下一步。 ### Cursor 在 Cursor 的 MCP 设置或适用的项目/用户 mcp.json 中添加 Pi,并按 Cursor 提示完成 OAuth。 官方指南: https://cursor.com/docs/mcp 1. 在添加 Pi 前,先辨认用户范围内实际生效的用户级、项目级或插件级配置来源。比较完整 MCP URL,而不是域名标签:仅当任意名称下的已有连接与此 URL 完全一致时才复用。已有完全匹配时,跳过下方所有添加或保存步骤。否则保持已有连接不变,并选择未使用的本地别名,例如从目标域名派生。无法安全辨认实际生效来源时应询问。请将下方所有示例中的 PI_CONNECTION_NAME 替换为选定名称;不要直接执行这个占位符。仅更改选定连接:绝不替换整个配置文件或修改其他连接。不要读取、打印、复制或写入凭证。 2. 仅当没有已有连接使用此完整 MCP URL 时,才在 Cursor MCP 设置中添加远程服务,或在适用的 mcp.json 中使用: ``` { "mcpServers": { "PI_CONNECTION_NAME": { "url": "https://pi-mcp.deepvinci.tech/api/v1/mcp" } } } ``` 3. 若 Cursor 在安装时要求 OAuth,请启动其原生授权流程,由用户本人完成 OAuth。宿主没有可调用的原生流程时,说明具体下一步。保存配置不代表工具已可用。 ### OpenCode 在 opencode.json 中添加 Pi 远程 MCP;需要连接账号时,再运行授权命令。 官方指南: https://opencode.ai/docs/mcp-servers/ 1. 在添加 Pi 前,先辨认用户范围内实际生效的用户级、项目级或插件级配置来源。比较完整 MCP URL,而不是域名标签:仅当任意名称下的已有连接与此 URL 完全一致时才复用。已有完全匹配时,跳过下方所有添加或保存步骤。否则保持已有连接不变,并选择未使用的本地别名,例如从目标域名派生。无法安全辨认实际生效来源时应询问。请将下方所有示例中的 PI_CONNECTION_NAME 替换为选定名称;不要直接执行这个占位符。仅更改选定连接:绝不替换整个配置文件或修改其他连接。不要读取、打印、复制或写入凭证。 2. 仅当没有已有连接使用此完整 MCP URL 时,才将以下内容添加到 opencode.json: ``` { "mcp": { "PI_CONNECTION_NAME": { "type": "remote", "url": "https://pi-mcp.deepvinci.tech/api/v1/mcp" } } } ``` 3. 需要连接账号时,运行: ``` opencode mcp auth PI_CONNECTION_NAME ``` ### WorkBuddy 请按当前 WorkBuddy 连接器指南添加 Pi 远程连接。 官方指南: https://www.workbuddy.ai/docs/zh/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Connector 1. 在添加 Pi 前,先辨认用户范围内实际生效的用户级、项目级或插件级配置来源。比较完整 MCP URL,而不是域名标签:仅当任意名称下的已有连接与此 URL 完全一致时才复用。已有完全匹配时,跳过下方所有添加或保存步骤。否则保持已有连接不变,并选择未使用的本地别名,例如从目标域名派生。无法安全辨认实际生效来源时应询问。请将下方所有示例中的 PI_CONNECTION_NAME 替换为选定名称;不要直接执行这个占位符。仅更改选定连接:绝不替换整个配置文件或修改其他连接。不要读取、打印、复制或写入凭证。 2. 仅当没有已有连接使用此完整 MCP URL 时,才按当前 WorkBuddy 官方指南保存远程 Pi 地址:https://pi-mcp.deepvinci.tech/api/v1/mcp 3. 凭证由 WorkBuddy 管理;客户端请求时,请由你本人在浏览器完成 OAuth。 ### DeepSeek Harness (dsh) 当当前 dsh 版本支持所需 OAuth 流程时,请按其已文档化的远程 HTTP MCP 流程添加 Pi 远程连接。 官方指南: https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/mcp/mcp-client/README.zh.md 1. 在添加 Pi 前,先辨认用户范围内实际生效的用户级、项目级或插件级配置来源。比较完整 MCP URL,而不是域名标签:仅当任意名称下的已有连接与此 URL 完全一致时才复用。已有完全匹配时,跳过下方所有添加或保存步骤。否则保持已有连接不变,并选择未使用的本地别名,例如从目标域名派生。无法安全辨认实际生效来源时应询问。请将下方所有示例中的 PI_CONNECTION_NAME 替换为选定名称;不要直接执行这个占位符。仅更改选定连接:绝不替换整个配置文件或修改其他连接。不要读取、打印、复制或写入凭证。 2. 仅当没有已有连接使用此完整 MCP URL 时,才按 dsh 的官方远程 HTTP MCP 方法保存此地址:https://pi-mcp.deepvinci.tech/api/v1/mcp 3. 凭证由 dsh 管理;当前 dsh 版本请求时,请由你本人在浏览器完成 OAuth。 ### 其他客户端 请选择支持远程 Streamable HTTP MCP 和标准 OAuth 的客户端,再按其已文档化的流程添加 Pi 连接。 1. 在添加 Pi 前,先辨认用户范围内实际生效的用户级、项目级或插件级配置来源。比较完整 MCP URL,而不是域名标签:仅当任意名称下的已有连接与此 URL 完全一致时才复用。已有完全匹配时,跳过下方所有添加或保存步骤。否则保持已有连接不变,并选择未使用的本地别名,例如从目标域名派生。无法安全辨认实际生效来源时应询问。请将下方所有示例中的 PI_CONNECTION_NAME 替换为选定名称;不要直接执行这个占位符。仅更改选定连接:绝不替换整个配置文件或修改其他连接。不要读取、打印、复制或写入凭证。 2. 仅当没有已有连接使用此完整 MCP URL 时,才按该客户端的官方流程保存 https://pi-mcp.deepvinci.tech/api/v1/mcp。 3. 按该客户端已文档化的步骤操作;凭证由客户端管理,并在请求时由你本人完成浏览器 OAuth。 ## Pi 能做什么 创建演示文稿、查询任务、选择主题,以及查看和保存大纲。 ### `pi_create_document` — 创建演示文稿 根据想法或准备好的文本创建新的演示文稿。 ### `pi_get_task` — 查询生成进度 查询已有任务的进度和交付结果。 ### `pi_list_themes` — 查找演示主题 浏览可用主题,或按视觉偏好查找候选主题。 ### `pi_get_status` — 查看账户状态 查看当前账户的额度和生成准入状态。 ### `pi_get_outline` — 查看演示文稿大纲 读取已保存的大纲及其版本。 ### `pi_update_outline` — 修改并保存大纲 保存大纲修改,不改写已完成的演示文稿页面。 ## 设置 Pi MCP 连接 本指南覆盖保存连接,以及安装需要时启动宿主管理的账号授权。设置方式因客户端而异;列出客户端不代表兼容其所有版本。保存端点不代表已授权工具调用、创建文档、生成或使用额度。客户端负责 OAuth、合格令牌刷新、工具发现、工具加载和凭证管理;Pi 不接管这些客户端职责。 确认用户范围内实际生效的用户级、项目级或插件级配置来源、客户端版本及其已文档化的远程 MCP 与 OAuth 流程。比较完整 MCP URL,而不是域名标签。任意名称下的已有连接其完整 URL 与目标完全一致时,可直接复用,不要改写。URL 不同时,保留旧连接并选择未使用的本地别名,可从目标域名派生。目标未指定时,不要随机选择某个 Pi 连接;无法安全辨认实际生效来源时应询问。 只有在用户明确要求替换时,才更改同名但 URL 不同的连接。仅更改选定来源中的该连接,保留仍适用的非认证设置,不要将端点专属的授权头、凭证引用、OAuth 客户端或 scope 参数转移到新 URL。凭证仍由宿主管理,不得读取、复制或写入。若无法安全原位替换,建议新增连接,并在停用旧连接前等待授权。 ## 账号授权与工具可用性 将安装、授权和工具可用性作为独立阶段报告。连接设置包括保存端点和在安装需要时启动宿主管理的 OAuth。Agent 应主动使用宿主的原生登录入口或授权 challenge;由宿主打开系统浏览器或受保护的原生认证窗口,用户本人登录并同意。宿主没有可调用入口时,说明具体手动步骤。不要将授权转移到 Agent 可操控的普通内置浏览器。Agent 不自行注册客户端、拼接授权链接、另建 PKCE、交换或注入 token、读取或代填凭证、读取 Cookie,也不代替用户点击同意。Pi 无法控制或强制宿主选择浏览器。 安装后,需要时按宿主已文档化的连接刷新、工具重载或会话重启流程操作,再报告当前阶段。不要仅为证明配置已保存而调用 `pi_list_themes`。安装需要 OAuth 时,按上述方式由 Agent 通过宿主启动授权,而不是等待用户自行寻找登录入口。安装不需要 OAuth 时,等用户首次请求使用 Pi 再连接账号。复用有效连接,或让宿主无需用户交互地刷新合格访问令牌。仍需授权时,由 Agent 启动宿主流程,用户完成登录与同意。 OAuth 发现、客户端注册、PKCE、刷新和凭证保存由宿主负责。PI 工具不可用时应报告连接问题,不能改用浏览器自动化或直连业务 HTTP 创建、推进或恢复生成。这些指引不代表 Pi 能控制宿主浏览器。 授权后,仅在 OAuth、发现或加载异常证据表明确有需要时,按客户端文档刷新连接、重新加载工具或重启会话。以客户端实际发现的工具为准。用户请求只读验证时,可调用一次 `pi_list_themes`;成功后,在后续获得授权的请求中使用已发现的工具。仅在获得创建授权的请求中使用 `pi_create_document`。 ## 安全使用 Pi - 获准生成后,只创建一次,再用 `pi_get_task` 查询原任务。状态和主题查询可选,不是创建前置。省略 `share_permission` 默认采用 1:完成后按已获授权开放只读分享,持链接者可阅读;显式 0 不开放链接分享,但不取消既有成员和协作者权限。请求 1 时由宿主取得 `pi:documents:share`,不得静默更改请求。展示结果时,只有后端确认内容已就绪且匿名可读,才优先在宿主面板展示;其他情况提供实际链接,结果仅在用户请求时通过外部浏览器打开。此结果展示规则不适用于 OAuth 授权。未完成内容只报进度,不能称为成稿。登录或展示失败不授权借用其他浏览器身份、修改 ACL 或重新生成。 - 从想法、准备好的内容或宿主整理的文本创建;宿主会将附件整理为可用文本,Pi 不承诺直接读取任意文件。主题和页数均可省略:省略时由 Pi 选择默认值,显式支持值优先。 - `pi_get_task` 查询已有任务。`pi_get_outline` 读取已保存大纲。`pi_update_outline` 在请求时调整已保存大纲;它不承诺自动改写已完成的演示文稿。 ## 主题选择与语义推荐 - 浏览主题是可选步骤。用户给出视觉或模板偏好并希望获得推荐时,使用 `preferences.query`(1-300 个字符)调用 `pi_list_themes`,比较返回的名称和预览,并使用真实 `theme_ref`。尊重用户明确选择的主题;未提供主题时,让 Pi 选择可见默认主题,不要编造引用。 - 语义搜索使用 `offset=0`,从有界搜索中最多返回 10 个可见候选。候选不保证匹配。应说明 `no_match`、不可用预览、不适合的候选或推荐失败;仅在用户授权范围内使用替代方案。它不创建文档或任务,但可能产生 embedding 提供商成本。不要自动重试或分页语义搜索。较旧部署可能不支持 `preferences.query`;应报告该限制,而不是声称已匹配。 ## 账号和工作空间连续性 - 首次使用时,在首次成功的 Pi 工具结果中内部保留非凭证 `auth_context`;不要仅为取得它而新增状态或主题预检。文本 JSON 和 structuredContent 工具结果均包含相同的 `auth_context`;后续调用仅传入该原始值作为 `expected_auth_context`。不要要求用户查看摘要。刷新或登录后不要静默替换它。若返回 `auth_context_changed`,停止并要求确认账号和工作空间。若客户端不能使用此工具 schema,则无法保证身份安全恢复。不要猜测参数或声称可自动恢复。 ## 额度、恢复与未知结果 - 用户请求创建演示文稿,即授权该次生成使用正常可用额度及已披露的默认 `share_permission=1`,不涉及历史文档。余额或准入不是最终价格;不要承诺不支持的费用上限、购买积分、充值或重复确认同一授权。只在完成后尝试分享,并重新核验 OAuth 和工作空间权限;用户已关闭的分享不会重开。缺少 scope 时由宿主申请同意,不得静默改成 0。仅批准 OAuth 或保存连接不构成生成授权。 - 若任务处于 `awaiting_credits`,保留并查询该原任务。启用自动恢复时(execute 和 recovery 均启用),充值可能自动恢复它;这不保证调度器正在运行。停止轮询不等于取消。写入结果未知时,仅核对原任务或幂等键。不要创建替代任务、再次提交操作、重试创建或更改幂等键。503 是服务失败:不要循环 OAuth 登录。 - 将非终态任务视为等待服务给出的 `poll_after_ms` 延迟。若它为 `0`、已停止、处于人工复核或受预算限制,不要忙轮询、推断已完成或提交替代任务。仅在服务或用户指示下一次读取时查询原任务。 - 保存连接后,可在后续获得授权的 Pi 请求中使用;客户端负责 OAuth 和工具流程。 - 任务引用、幂等键或 `auth_context` 始终绑定原连接。不要通过其他服务查询、重放或恢复它。 ## 告诉助手你希望 Pi 做什么 - 根据这份内容创建一份中文产品发布演示文稿,目标内容页数为 10 页。 - 先给我看简洁的商务演示主题,暂时不要创建演示文稿。 - 读取这份演示文稿已保存的大纲,将市场分析移到产品介绍前面并保存大纲。不要创建新的演示文稿。 ## 常见问题与完整指南 - 费用:只有你请求创建后才会使用正常可用额度。余额或准入结果不是最终价格;自然语言主题推荐可能产生服务提供商成本。 - 分享:新演示文稿默认请求匿名只读分享,成功开放后持链接者可阅读;实际权限以结果为准,既有工作空间成员和协作者权限仍然有效。 - 附件:Pi 不直接读取任意文件。宿主助手会先将支持的附件内容整理为可用文本。 - 编辑和导出:请回到 Pi 网站编辑页面或导出文件;MCP 不提供页面编辑或文件导出工具。 - 停止查询:停止轮询不等于取消任务。结果不明或等待额度时,请查询原任务或幂等键,不要再创建一个任务。