连接您的 AI 助手 (MCP)
标签页
PlatoForms 支持 模型上下文协议 (MCP). 这一开放标准让 ChatGPT、Claude、Cursor 和 OpenAI Codex 等 AI 助手可以直接与您的 PlatoForms 账户协作。连接后,您可以简单地让您的助手执行以下操作:
- “我接收表单的最新提交说了什么?” . 它会找到表单,读取答案,并可以提供一个限时的 PDF 下载链接。
- “将此测试条目提交到我的反馈表单。”
- “创建一个客户电子邮件已预填的订单表单链接。”
- “为我们的社区研讨会创建一个活动注册表单。” . AI 会根据您的描述构建一个全新的表单(或 PDF 文档);打开它返回的链接,观看设计的呈现。
要使用 MCP,您需要一个 具有 API 访问权限的 PlatoForms 账户。新账户在 15 天免费试用期间包含 API 访问权限。助手操作使用您可用的 API 配额,并受额外速率限制。
您的助手仅获得您授予的访问权限。每个操作都通过与 PlatoForms 应用相同的权限和计划检查。对于启用了 HIPAA 合规的团队,AI 助手访问默认关闭 . 团队所有者可以在查看下面的 数据使用和受限数据 部分后将其打开。
PlatoForms MCP 服务器地址是:
https://mcp.platoforms.com
连接 ChatGPT
-
在 ChatGPT 中打开 插件 并搜索 PlatoForms,或打开 PlatoForms 插件页面。
-
选择 安装,然后登录 PlatoForms。
-
选择只读或读写访问权限,然后选择 允许。
-
在聊天中,输入
@PlatoForms并询问类似 “列出我发布的表单及其提交计数。” 的问题。
您的 PlatoForms 密码不会与 ChatGPT 共享。您可以随时撤销连接。
连接 Claude(单击)
适用于 Web 和 Claude 桌面版的 Claude。
-
在 Claude 中,打开 设置 > 连接器 并点击 添加自定义连接器。
-
输入
https://mcp.platoforms.com作为服务器 URL 并确认。 -
Claude 会打开一个 PlatoForms 登录页面。登录并点击 允许。
-
完成 . 询问 Claude 类似 “列出我的 PlatoForms 表单。” 的问题。
您可以随时从 Claude 的连接器设置中断开连接。
多个团队: MCP 授权您在连接时登录的账户 . 而不是当前在 PlatoForms 仪表板中选择的团队。如果您需要连接特定团队,请先退出 PlatoForms,然后以该团队的账户重新登录,然后开始连接。
连接 Claude Code
在终端中运行:
claude mcp add --transport http platoforms https://mcp.platoforms.com
然后开始一个新的 Claude Code 会话,输入 /mcp,选择 platoforms,并选择 认证。在打开的浏览器窗口中登录 PlatoForms 并点击 允许。
要尝试一下,询问类似 “使用 PlatoForms 工具,我以谁的身份登录?” 的问题 . Claude 应该会回复您的账户电子邮件和团队名称。
连接 OpenAI Codex
当前版本的 OpenAI Codex 支持远程 MCP 服务器的 OAuth 登录。PlatoForms 支持 OAuth 发现、动态客户端注册和 PKCE,因此您的密码和 API 密钥不会与 Codex 共享。
- 添加 PlatoForms 作为 MCP 服务器:
codex mcp add platoforms --url https://mcp.platoforms.com
- 开始 OAuth 登录:
codex mcp login platoforms
-
Codex 会打开一个 PlatoForms 登录页面。登录并点击 允许。
-
开始一个新的 Codex 会话并询问 “使用 PlatoForms 工具,我以谁的身份登录?”
您可以使用 codex mcp logout platoforms 断开账户连接。
PlatoForms 发布了 Codex 需要的 OAuth 元数据和支持的范围,因此正常设置不需要固定的回调端口、客户端 ID、资源或显式范围列表。具有特殊回调要求的托管环境可以使用 Codex 的可选 OAuth 设置。请参阅 OpenAI 的 Codex MCP 文档。
使用 API 密钥连接(替代方案)
推荐 Claude 和 OpenAI Codex 使用 OAuth。Cursor、脚本、旧客户端和其他兼容 MCP 的工具可以改为使用 PlatoForms API 密钥连接。在 PlatoForms 中,打开 账户 > API 并复制您的 API 令牌,然后按照下面的工具步骤进行操作。
您的 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) 面板并点击 启用 或 禁用。
对于未启用 HIPAA 合规的团队,AI 助手访问默认开启。对于启用了 HIPAA 合规的团队,它默认关闭,并保持关闭状态,直到团队所有者将其打开。您不需要禁用 HIPAA 模式即可使用 MCP。
在为启用了 HIPAA 的团队开启此功能之前,请阅读 数据使用和受限数据。通过 MCP 发送到第三方 AI 提供商的数据不在 PlatoForms 商业伙伴协议 (BAA) 的覆盖范围内。
故障排除
错误 462
您的计划的 API 配额已用完。请升级您的计划或等待下一个计费周期重置配额。
错误 403 . 权限被拒绝
此错误出现在两种不同的情况下:
- 实际权限问题 . 连接的账户无权访问请求的资源(例如,由不同团队拥有的表单)。
- 资源未找到 . 传递给工具的表单 ID 或提交 ID 不存在。请仔细检查 ID 并重试。
如果您确信 ID 正确且账户有访问权限,请尝试断开并重新连接以确保 OAuth 会话是最新的。
您的助手可以做什么
- 读取 . 列出和搜索表单,读取表单字段定义,列出和读取提交内容,为生成的 PDF 和附件创建到期下载链接。
- 写入 . 提交表单条目并创建预填的邀请链接。仅限链接:助手永远无法从您的账户发送电子邮件。
- 创建 . 从描述中创建新的 AI 设计的网页表单和 PDF 文档。
速率限制适用于您的计划的 API 配额之上,每个助手创建的邀请都会在您的邀请列表中可见以供审核。
有关每个示例提示、返回的内容以及您的助手无法执行的操作,请参阅 向您的 AI 助手询问什么。
数据使用和受限数据
PlatoForms 仅向连接的助手发送您请求的操作所需的工具输入和结果。根据工具的不同,这可能包括您的账户身份、表单名称和字段定义、提交数据、生成文档的元数据和限时文件链接。MCP 服务是 PlatoForms API 的无状态中继,不会在请求完成后保留表单或提交内容的单独副本。它不会接收您的完整 AI 聊天记录。
您连接的 AI 提供商接收工具输入和结果,并根据其自己的条款、隐私政策、保留规则和账户设置进行处理。在连接之前,请查看这些政策:
请勿使用 MCP 集成来收集、提交或处理受 PCI DSS 约束的支付卡数据、政府标识符、密码、API 密钥、认证秘密或 MFA/一次性代码。
受保护的健康信息 (PHI)。 对于启用了 HIPAA 合规的团队,MCP 默认关闭,团队所有者可以将其打开。通过 MCP 发送到第三方 AI 提供商的数据不在 PlatoForms 商业伙伴协议的覆盖范围内。如果您在启用了 HIPAA 的团队上启用 MCP,作为受保护实体,您有责任确定披露是否符合 HIPAA 规则,并直接与您连接的 AI 提供商达成任何所需的协议。
ChatGPT 的公共 PlatoForms 插件不得用于收集、提交、检索或以其他方式处理 PHI。