PlatoForms User Guide

What's new? API Docs

连接您的 AI 助手 (MCP)

标签页

PlatoForms 支持 模型上下文协议 (MCP)。这是一个开放标准，允许像 Claude、Cursor 和 OpenAI Codex 这样的 AI 助手直接与您的 PlatoForms 账户协作。连接后，您可以简单地让您的助手：

“我接收表单的最新提交说了什么？”。它会找到表单，读取答案，并可以为您提供一个限时的 PDF 下载链接。
“提交这个测试条目到我的反馈表单。”
“创建一个带有客户电子邮件预填的订单表单链接。”
“为一家物理治疗诊所创建客户接收表单。”。AI 会根据您的描述构建一个全新的表单（或 PDF 文档）；打开它返回的链接，观看设计出现。

您的助手只能获得您授予的访问权限。每个操作都通过与 PlatoForms 应用相同的权限和计划检查，处于 HIPAA 模式的团队无法连接，除非团队所有者明确启用 AI 助手访问。

PlatoForms MCP 服务器地址是：

https://mcp.platoforms.com

连接 Claude（单击即可）

适用于网络版和桌面版 Claude。

在 Claude 中，打开设置 > 连接器 并点击 添加自定义连接器。
输入 https://mcp.platoforms.com 作为服务器 URL 并确认。
Claude 会打开一个 PlatoForms 登录页面。登录并点击允许。
完成。可以问 Claude 类似 “列出我的 PlatoForms 表单。” 的问题。

您可以随时从 Claude 的连接器设置中断开连接。

连接 Claude 代码

在终端中运行：

claude mcp add --transport http platoforms https://mcp.platoforms.com

然后启动一个新的 Claude 代码会话，输入 /mcp，选择 platoforms，然后选择认证。在打开的浏览器窗口中登录 PlatoForms 并点击允许。

试试看，问类似 “使用 PlatoForms 工具，我登录的是谁？” 的问题。Claude 应该会回复您的账户电子邮件和团队名称。

连接 OpenAI Codex

当前版本的 OpenAI Codex 支持远程 MCP 服务器的 OAuth 登录。PlatoForms 使用一个带有 PKCE 的公共 OAuth 客户端，因此您的密码和 API 密钥不会与 Codex 共享。

在 ~/.codex/config.toml 顶部附近添加一个固定的 OAuth 回调端口（在任何 [mcp_servers.*] 部分之外）：

mcp_oauth_callback_port = 8765

添加 PlatoForms 作为 MCP 服务器：

codex mcp add platoforms \
  --url https://mcp.platoforms.com \
  --oauth-client-id platoforms-mcp \
  --oauth-resource https://mcp.platoforms.com

启动 OAuth 登录：

codex mcp login platoforms --scopes read,write

Codex 会打开一个 PlatoForms 登录页面。登录并点击允许。
启动一个新的 Codex 会话并询问 “使用 PlatoForms 工具，我登录的是谁？”

您可以使用 codex mcp logout platoforms 断开账户连接。

Note

这些 OAuth 选项在当前的 Codex 版本中可用。如果 Codex 不识别 --oauth-client-id 或 --oauth-resource，请更新 Codex 或使用下面的 API 密钥方法。参见 OpenAI 的 Codex MCP 文档。

使用 API 密钥连接（替代方案）

建议 Claude 和 OpenAI Codex 使用 OAuth。Cursor、脚本、旧客户端和其他 MCP 兼容工具可以改为使用 PlatoForms API 密钥连接。在 PlatoForms 中，打开账户 > API 并复制您的 API 令牌，然后按照下面的步骤为您的工具进行设置。

Warning

您的 API 密钥具有团队所有者的完整 API 访问权限——请像对待密码一样对待它。优先使用一键连接功能。

Cursor

将服务器添加到 ~/.cursor/mcp.json（如果文件不存在则创建）：

{
  "mcpServers": {
    "platoforms": {
      "url": "https://mcp.platoforms.com",
      "headers": {
        "Authorization": "Bearer <your API key>"
      }
    }
  }
}

重启 Cursor（或重新加载其 MCP 服务器）并让它列出您的 PlatoForms 表单。

OpenAI Codex（API 密钥）

在无法使用基于浏览器的 OAuth 时用于自动化。如果您已经配置了上面的 OAuth 连接，请先使用 codex mcp remove platoforms 移除它。

将服务器添加到 ~/.codex/config.toml（如果文件不存在则创建）：

[mcp_servers.platoforms]
url = "https://mcp.platoforms.com"
bearer_token_env_var = "PLATOFORMS_API_KEY"

Codex 从 bearer_token_env_var 指定的环境变量中读取 API 密钥，因此在启动 Codex 之前确保其可用——例如，通过在 shell 配置文件中添加以下行：

export PLATOFORMS_API_KEY="<your API key>"

重启 Codex 并让它列出您的 PlatoForms 表单。

其他 MCP 工具

任何支持远程（可流式 HTTP）服务器的 MCP 兼容工具都可以连接。使用 https://mcp.platoforms.com 作为服务器 URL。如果工具支持 PlatoForms OAuth，请使用其浏览器登录流程；否则，将您的 API 密钥作为 Bearer 授权头发送。

开启或关闭 AI 助手访问

团队所有者可以为整个团队开启或关闭 AI 助手访问。

在 PlatoForms 中，打开账户 > API。
找到 AI 助手访问 (MCP) 面板并点击启用或禁用。