メインコンテンツへ移動

統合

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エージェント向けです。