統合
AIエージェント向けMCP
MCP経由でClaude、Codex、OpenCode、OpenClaw、Hermesをプラットフォームに接続する方法。
ドキュメントのセクション
MCPは、外部のAIエージェントに、プラットフォームを操作できるアクセス権を提供します:分析の閲覧、サーベイの支援、ユーザーに代わっての操作実行が可能です。接続には、Streamable HTTPエンドポイントを使用します:
https://<プラットフォームのドメイン>/mcp
初回アクセス時、ブラウザでOAuthログインが開きます。アクセスを要求しているクライアントと、要求されたスコープを確認できます。承認後、トークンはMCPクライアント自体が保持するため、シークレットを手動でコピーする必要はありません。
1つのエンドポイントですべての組織にアクセスできます。アクティブな組織は認証済みセッションから取得され、エージェントが組織の切り替えに対応している場合は、利用可能な別の組織を選択できます。
Claude
Claude CodeにHTTP MCPサーバーを追加してください:
claude mcp add --transport http platform https://<プラットフォームのドメイン>/mcp
Claude Codeを開き、/mcpを実行して、ブラウザでOAuthログインを完了してください。ターミナルからログインを開始する場合は、次のコマンドを使用してください:
claude mcp login platform
Codex
Streamable HTTPサーバーを追加してください:
codex mcp add platform --url https://<プラットフォームのドメイン>/mcp
次に、OAuthログインを実行してください:
codex mcp login platform
Codex CLIでは、/mcpで接続状態を確認できます。
OpenCode
サーバーをopencode.jsonに追加してください:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"platform": {
"type": "remote",
"url": "https://<プラットフォームのドメイン>/mcp",
"enabled": true
}
}
}
初回使用時、OpenCodeは認証を求めます。OAuth認証を手動で開始するには、次のコマンドを実行してください:
opencode mcp auth platform
OpenClaw
MCPサーバーをStreamable HTTPとして登録し、OAuthを有効にしてください:
openclaw mcp add platform \
--url https://<プラットフォームのドメイン>/mcp \
--transport streamable-http \
--auth oauth
ログインを実行して、接続を確認してください:
openclaw mcp login platform
openclaw mcp doctor platform --probe
loginコマンドが確認コードを返した場合は、次のコマンドでログインを完了してください:
openclaw mcp login platform --code <code>
設定ファイルを手動で編集する場合の形式は次のとおりです:
{
"mcp": {
"servers": {
"platform": {
"url": "https://<プラットフォームのドメイン>/mcp",
"transport": "streamable-http",
"auth": "oauth"
}
}
}
}
Hermes
~/.hermes/config.yamlにサーバーを追加してください:
mcp_servers:
platform:
url: "https://<プラットフォームのドメイン>/mcp"
auth: oauth
Hermesを起動してください。初回接続時、HermesはブラウザでOAuth認証を開始し、以降のセッション用にトークンを保存します。すでに開いているセッションで設定を変更した場合は、次を実行してください:
/reload-mcp
アクセス
エージェントは、承認済みのスコープのみを取得できます:
analytics:read— サーベイ、結果、分析、改善点の閲覧。surveys:write— サーベイの作成、編集、公開。org:manage— 組織、設定、メンバーの管理。
スコープはユーザーの役割を置き換えるものではありません。ユーザーの役割が組織内でその操作を許可していない場合、エージェントもその操作を実行できません。
レート制限
MCPへのリクエストにはレート制限が適用されます:
- MCPエンドポイント
/mcp:トークンまたはIPごとに毎分300リクエスト。 - OAuth認可:IPとclient_idの組み合わせにつき5分間に20リクエスト(IPごとに120リクエスト)。
制限を超えた場合、サーバーは待機時間(retryAfter)を示すrate_limitedエラーを返します。
プライバシー
MCPは、プラットフォームのルールを迂回したメンバー回答の開示を行いません。生の回答は誰も見ることはできず、外部に出るのは、回答数が十分にある場合(5件以上)に限り、匿名化されたデータと集計結果のみです。データが少ない場合、エージェントが受け取る結果は制限されます。
通常のスクリプトやサーバーサイドの統合には、APIトークンを使用してください。MCPは、tools、resources、prompts、OAuth、個別スコープを重視するAIエージェント向けです。