連接您的 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 Code
在終端中運行:
claude mcp add --transport http platoforms https://mcp.platoforms.com
然後啟動新的 Claude Code 會話,輸入 /mcp,選擇 platoforms,然後選擇 Authenticate。在打開的瀏覽器窗口中登錄 PlatoForms 並點擊 允許。
試試看,請求類似 「使用 PlatoForms 工具,我以誰的身份登錄?」 的內容。Claude 應該會回覆您的帳戶電子郵件和團隊名稱。
連接 OpenAI Codex
當前版本的 OpenAI Codex 支持遠程 MCP 伺服器的 OAuth 登錄。PlatoForms 使用公共 OAuth 客戶端和 PKCE,因此您的密碼和 API 密鑰不會與 Codex 共享。
- 在
~/.codex/config.toml的頂部(任何[mcp_servers.*]部分之外)添加一個固定的 OAuth 回調端口:
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 斷開帳戶連接。
這些 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 令牌,然後按照下面的工具步驟操作。
您的 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 提供商處理,因此僅在符合您的合規要求時啟用。
您的助理可以做什麼
- 讀取。列出和搜索表單,閱讀表單字段定義,列出和閱讀提交,為生成的 PDF 和附件創建過期下載連結。
- 寫入。提交表單條目並創建預填邀請連結。僅限連結:助理無法從您的帳戶發送電子郵件。
- 創建。從描述中創建新的 AI 設計的網頁表單和 PDF 文件。
速率限制適用於您的計劃 API 配額之上,每個助理創建的邀請都會保留在您的邀請列表中以供審核。