Account and organization 1 分钟阅读

使用 PaperOffice 与 Claude、ChatGPT、Grok 和 Cursor（MCP）：完整指南

连接器具备的功能

MCP（模型上下文协议）是一项开放标准，AI 助手借此使用另一系统的工具。PaperOffice 为此提供远程 MCP 服务器。连接后，像 Claude 这样的助手即可在您的 PaperOffice 工作区中处理文档：搜索、阅读、摘要、提取数据、上传、重命名、移动、请求签名及启动工作流，所有操作均受您 PaperOffice 权限的约束。

无需安装任何软件。助手通过 URL 连接，您使用 PaperOffice 账户登录，随后 PaperOffice 工具将出现在聊天界面中。

支持的助手及连接器 URL

  • Claude（claude.ai、Claude 桌面版、Claude Code）：https://mcp.paperoffice.ai/claude，通过 OAuth 2.1 登录。
  • ChatGPT：https://mcp.paperoffice.ai/chatgpt，通过 OAuth 2.1 登录。
  • Grok：https://mcp.paperoffice.ai/grok，通过 OAuth 2.1 登录。
  • Cursor：https://mcp.paperoffice.ai/cursor，使用个人用户令牌或组令牌。

这些配置文件指向同一服务器，仅在工具范围上有所不同。

所需条件

  • 一个 PaperOffice 账户，且至少包含一个工作区。
  • 账户中需开通 Credits。工具调用按 API 调用计费。
  • 允许连接器的助手计划，例如 Claude Pro、Max、Team 或 Enterprise。在 Team 和 Enterprise 计划中，管理员可能需要先启用连接器。

连接 Claude

  1. 在 claude.ai 中，打开 设置 → Connectors。
  2. 选择 添加自定义连接器，输入名称 PaperOffice 和 URL https://mcp.paperoffice.ai/claude。保持客户端 ID 和密钥为空；OAuth 登录将自动启动。
  3. 选择 连接 并使用您的 PaperOffice 账户登录。审查请求的访问权限并确认。
  4. 在聊天中，为当前会话启用 PaperOffice 工具。

Claude 桌面版使用与 claude.ai 相同的连接器列表。在 Claude Code 中，通过 claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude 添加服务器，并通过 /mcp 完成登录。

首次测试：询问“我可以访问哪些 PaperOffice 工作区？” Claude 应列出您的工作区。

连接 ChatGPT 和 Grok

在 设置 → Connectors 中打开，添加一个名为 PaperOffice 的自定义连接器，URL 为 https://mcp.paperoffice.ai/chatgpt，并选择 OAuth 作为认证方式，然后连接并登录。根据您的套餐，可能需要启用开发者模式才能使用自定义连接器。ChatGPT 配置文件是经过精心筛选的工具集合；例如，它不包含签名和流程工具。

打开 grok.com/connectors，创建一个 URL 为 https://mcp.paperoffice.ai/grok 的自定义连接器，并在首次连接时使用您的 PaperOffice 账户登录。Grok 配置文件同样是一个经过精心筛选的工具集合。

使用令牌连接 Cursor

  1. 登录 PaperOffice 应用并打开 账户 → API。
  2. 创建用户令牌或使用管理员提供的组令牌。您可以随时在 API 页面查看并复制该令牌；请妥善保管。
  3. 将服务器添加到 Cursor 的 mcp.json 文件中，URL 为 https://mcp.paperoffice.ai/cursor，并将令牌作为 Bearer 令牌置于 Authorization 头部。
  4. 重启 Cursor 或重新加载 MCP 服务器。

切勿将包含真实令牌的 mcp.json 文件提交到代码库。REST API 的密钥和可发布密钥对 MCP 处于屏蔽状态。

权限：助手获得的权限绝不会超过您拥有的权限

助手以已登录的 PaperOffice 用户的权限运行。工作区成员资格、角色、共享文件夹、保留规则（WORM）和法律保留均保持不变。在 PaperOffice 中为只读的用户，在助手中同样保持只读。

每个工具都带有标题，并提示其仅读取还是修改内容。助手会利用这些提示在行动前征求您的同意。删除、清空回收站和发送签名请求被标记为破坏性操作，因此会要求确认。已删除的文档首先移至 PaperOffice 回收站，并可在应用中恢复。

账户设置、计费、用户管理和 API 密钥的创建无法通过连接器进行。它们仍保留在 PaperOffice 应用中。

数据流：助手看到的内容以及 PaperOffice 接收到的内容

  1. 您在助手中输入请求。
  2. 助手决定调用哪个 PaperOffice 工具，并将参数（例如搜索词或文档 ID）发送给 PaperOffice MCP 服务器。
  3. PaperOffice 以您的权限运行该调用并返回结果，例如一份文档的文本或文件名列表。
  4. 结果成为您与助手对话的一部分，并按照助手提供商的条款进行处理。

PaperOffice 不会接收您的聊天记录、提示词或助手的回答。只有工具调用本身会到达服务器：工具名称、参数、时间和用户。PaperOffice 不会自行将文档上传至助手提供商；提供商仅接收助手所请求的内容。

每次工具调用都会记录时间、用户和 Credits。管理员可在 API 与开发人员 → API 使用情况 中查看这些调用。

计费

通过连接器进行的每次工具调用均在 Credits 中计费，与相应的 API 调用完全相同。没有单独的连接器订阅。某些状态和健康查询不收费；详细信息请参阅 API 文档。当 Credits 用完时，调用将被拒绝并显示明确消息；不会删除任何数据。更多信息请参阅关于计费和 Credits 的指南：PaperOffice AI 中的计费和 Credits。

撤销访问权限

  1. 在助手中，移除或断开 PaperOffice 连接器的连接。助手将立即停止使用它；已包含 PaperOffice 结果的对话将保留该文本。
  2. 在 PaperOffice 中，打开 账户 → API。助手连接将带有 MCP 徽章显示在令牌列表中。请在此处删除该连接的令牌。
  3. 对于 Cursor，请在同一页面上轮换或删除令牌。

撤销访问权限不会删除任何数据。

故障排除

  • 登录窗口未打开：请允许助手弹出窗口，并尝试使用隐私浏览器窗口。在 Team 或 Enterprise 计划中，请咨询管理员是否已启用连接器。
  • 已连接，但未显示任何 PaperOffice 工具：请为对话启用这些工具，或开始新对话。
  • 工具调用期间出现“未经授权”：连接已被撤销或过期。请重新连接。如果使用令牌，请检查其是否为用户或组令牌。
  • 助手未找到文档：请先询问工作区列表。已连接的用户可能无法访问您期望的工作区。最近上传的文档需要一点时间才能完成处理。
  • Credits 不足：请在 PaperOffice 应用中充值或启用自动充值。

仍遇到问题？请提交支持工单，并附上所用助手和计划、确切的消息、带时区的时间，以及可能的话，不含个人数据的截图。

IT 团队建议

  • 允许访问的域名：mcp.paperoffice.ai、api.paperoffice.ai 和 app.paperoffice.ai。所有流量均使用 HTTPS；无需向您的网络建立入站连接。
  • 从试点开始：一个工作区和只读角色。在试点完成后，按工作区启用写入角色。
  • 在前几周定期审查 API 使用情况。

常见问题

  • 我必须安装任何软件吗？不需要。助手通过连接 URL 来工作。
  • 助手能看到我所有的文档吗？只能看到您的 PaperOffice 用户有权查看的内容。
  • PaperOffice 会读取我的聊天记录吗？不会。只有工具调用会发送至 PaperOffice。
  • 连接器是否有单独的订阅费用？没有。调用费用将像 API 调用一样在 Credits 中计费。
  • 如何终止访问？在助手中移除连接器，并在“账户 → API”下删除该连接的令牌。