MCP / OAuth

在你日常使用的 AI 助手中创建 Pi 演示文稿

从想法、内容或资料开始；主题和页数可选。创建后查询进度，再在 Pi 查看和编辑已保存的演示文稿。

选择你的 AI 助手查看使用示例

PI DevPI Dev 插件开发验证中；当前可按以下步骤添加 Pi MCP 远程连接。

选择客户端

从你正在使用的 AI 助手接入

直接从客户端开始：选择客户端即可查看接入步骤和官方指南。

Codex查看步骤

接入方式：使用以下 Codex 命令添加 Pi MCP 远程连接；需要连接账号时，再由你本人完成浏览器授权。

打开官方指南

在终端保存 Pi MCP 远程连接：

codex mcp add pi --url https://pi-mcp.deepvinci.tech/api/v1/mcp

需要连接 Pi 账号时，请由你本人在浏览器完成授权：
```
codex mcp login pi --oauth-client-registration dcr
```

Claude Desktop查看步骤

接入方式：在 Claude Desktop 中将 Pi 添加为账号级远程连接。

打开官方指南

打开 Customize > Connectors > + Add > Add custom connector。
添加远程 Pi 地址：https://pi-mcp.deepvinci.tech/api/v1/mcp
出现提示时，请由你本人在浏览器完成账号级授权。

Cursor查看步骤

接入方式：在 Cursor 的 MCP 设置或适用的项目/用户 mcp.json 中添加 Pi，并按 Cursor 提示完成 OAuth。

打开官方指南

在 Cursor 的 MCP 设置中添加远程服务，或在适用的 mcp.json 使用：

{
  "mcpServers": {
    "pi": {
      "url": "https://pi-mcp.deepvinci.tech/api/v1/mcp"
    }
  }
}

Cursor 提示 OAuth 时，请由你本人在浏览器完成。保存连接后，可在后续获得授权的请求中使用。

OpenCode查看步骤

接入方式：在 opencode.json 中添加 Pi 远程 MCP；需要连接账号时，再运行授权命令。

打开官方指南

在 opencode.json 中添加：

{
  "mcp": {
    "pi": {
      "type": "remote",
      "url": "https://pi-mcp.deepvinci.tech/api/v1/mcp"
    }
  }
}

需要连接账号时，运行：
```
opencode mcp auth pi
```

WorkBuddy查看步骤

接入方式：请按当前 WorkBuddy 连接器指南添加 Pi 远程连接。

打开官方指南

按当前 WorkBuddy 连接器指南保存远程 Pi 地址：https://pi-mcp.deepvinci.tech/api/v1/mcp
凭证由 WorkBuddy 管理；客户端请求时，请由你本人在浏览器完成 OAuth。

DeepSeek Harness (dsh)查看步骤

接入方式：当当前 dsh 版本支持所需 OAuth 流程时，请按其已文档化的远程 HTTP MCP 流程添加 Pi 远程连接。

打开官方指南

按 dsh 已文档化的远程 HTTP MCP 方式保存此地址：https://pi-mcp.deepvinci.tech/api/v1/mcp
凭证由 dsh 管理；当前 dsh 版本请求时，请由你本人在浏览器完成 OAuth。

其他客户端查看步骤

接入方式：请选择支持远程 Streamable HTTP MCP 和标准 OAuth 的客户端，再按其已文档化的流程添加 Pi 连接。

按该客户端已文档化的流程保存 https://pi-mcp.deepvinci.tech/api/v1/mcp。
按该客户端已文档化的步骤操作；凭证由客户端管理，并在请求时由你本人完成浏览器 OAuth。

让助手协助添加 Pi

将此安装提示复制给当前助手。它会保存 Pi MCP 连接并保留已有连接；如需浏览器 OAuth，请由你本人完成。

请根据以下内容为当前客户端安装 Pi MCP：指南：https://pi.deepvinci.tech/mcp/connect.md 远程端点：https://pi-mcp.deepvinci.tech/api/v1/mcp 请按当前客户端的文档流程保存 Pi MCP 连接，并保留已有连接。若名为 `pi` 的连接已指向此端点，请保留它；若指向其他端点，请先征求我的确认。保存连接即完成本次请求。如需 OAuth，请等待我在浏览器中本人完成。工具调用、创建文档、生成内容和使用额度按后续请求及其授权执行；凭证由客户端管理。

从想法到已保存的 Pi 演示文稿

从内容开始创建，主题和页数均可选；随后查询进度。需要时可查看或调整已保存的大纲；更新大纲不承诺自动改写已完成的演示文稿。

从想法、文字内容或宿主整理的资料开始。请求创建即授权该次生成使用正常额度；主题和页数省略时由 Pi 选择。查询原任务，再回到 Pi 查看和编辑。

保存的大纲可按需查看或调整；调整大纲不会自动改写已生成的演示文稿。

查看 Pi 工具名

pi_get_status
pi_list_themes
pi_create_document
pi_get_task
pi_get_outline
pi_update_outline

使用示例

告诉助手你希望 Pi 做什么

准备好后直接请求创建；该请求即授权此次生成使用正常可用额度。主题、页数、状态查询和主题浏览均为可选，附件内容由宿主整理为文本。

查询商务主题

请只查询适合商务演示的主题，不生成演示文稿。

创建一份演示稿

创建一份中文《泰坦尼克号》演示稿，约 8 页，仅自己可查看。我授权本次使用正常可用额度生成；不要充值，也不要重复生成。

查询刚才的任务

查询刚才提到的 Pi 任务，不创建新任务或演示文稿。

常见问题与完整指南

账号与额度：使用客户端标准 OAuth，凭证由客户端管理。可先查询账户状态、主题和任务。自然语言主题推荐可能产生 embedding 提供商成本。余额或准入结果不是最终价格，最终计费以实际执行为准。创建仅在你明确授权后使用正常可用额度，绝不自动充值。
使用工具时，请按客户端的 OAuth、刷新、发现和加载流程操作。出现登录、发现或加载问题时，使用客户端已文档化的连接刷新、工具重载或新建会话流程；不要按名称前缀推断工具。
结果不明或等待额度时：先查询原任务或幂等键，不要重建或重复提交。开启自动恢复时，充值可能恢复任务；停止轮询不等于取消。

查看完整接入指南