---
title: AIエージェント向けMCP
description: MCP経由でClaude、Codex、OpenCode、OpenClaw、Hermesをプラットフォームに接続する方法。
type: doc
locale: ja
canonical: 'https://yoseno.com/ja/docs/integrations/mcp-agent'
updated: '2026-07-30'
---

# AIエージェント向けMCP

MCP経由でClaude、Codex、OpenCode、OpenClaw、Hermesをプラットフォームに接続する方法。

MCPは、外部のAIエージェントに、プラットフォームを操作できるアクセス権を提供します：分析の閲覧、サーベイの支援、ユーザーに代わっての操作実行が可能です。接続には、Streamable HTTPエンドポイントを使用します：

```txt
https://<プラットフォームのドメイン>/mcp
```

初回アクセス時、ブラウザでOAuthログインが開きます。アクセスを要求しているクライアントと、要求されたスコープを確認できます。承認後、トークンはMCPクライアント自体が保持するため、シークレットを手動でコピーする必要はありません。

1つのエンドポイントですべての組織にアクセスできます。アクティブな組織は認証済みセッションから取得され、エージェントが組織の切り替えに対応している場合は、利用可能な別の組織を選択できます。

## Claude

Claude CodeにHTTP MCPサーバーを追加してください：

```bash
claude mcp add --transport http platform https://<プラットフォームのドメイン>/mcp
```

Claude Codeを開き、`/mcp`を実行して、ブラウザでOAuthログインを完了してください。ターミナルからログインを開始する場合は、次のコマンドを使用してください：

```bash
claude mcp login platform
```

## Codex

Streamable HTTPサーバーを追加してください：

```bash
codex mcp add platform --url https://<プラットフォームのドメイン>/mcp
```

次に、OAuthログインを実行してください：

```bash
codex mcp login platform
```

Codex CLIでは、`/mcp`で接続状態を確認できます。

## OpenCode

サーバーを`opencode.json`に追加してください：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "platform": {
      "type": "remote",
      "url": "https://<プラットフォームのドメイン>/mcp",
      "enabled": true
    }
  }
}
```

初回使用時、OpenCodeは認証を求めます。OAuth認証を手動で開始するには、次のコマンドを実行してください：

```bash
opencode mcp auth platform
```

## OpenClaw

MCPサーバーをStreamable HTTPとして登録し、OAuthを有効にしてください：

```bash
openclaw mcp add platform \
  --url https://<プラットフォームのドメイン>/mcp \
  --transport streamable-http \
  --auth oauth
```

ログインを実行して、接続を確認してください：

```bash
openclaw mcp login platform
openclaw mcp doctor platform --probe
```

`login`コマンドが確認コードを返した場合は、次のコマンドでログインを完了してください：

```bash
openclaw mcp login platform --code <code>
```

設定ファイルを手動で編集する場合の形式は次のとおりです：

```json
{
  "mcp": {
    "servers": {
      "platform": {
        "url": "https://<プラットフォームのドメイン>/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}
```

## Hermes

`~/.hermes/config.yaml`にサーバーを追加してください：

```yaml
mcp_servers:
  platform:
    url: "https://<プラットフォームのドメイン>/mcp"
    auth: oauth
```

Hermesを起動してください。初回接続時、HermesはブラウザでOAuth認証を開始し、以降のセッション用にトークンを保存します。すでに開いているセッションで設定を変更した場合は、次を実行してください：

```txt
/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トークン](https://yoseno.com/ja/docs/integrations/api-tokens.md)を使用してください。MCPは、tools、resources、prompts、OAuth、個別スコープを重視するAIエージェント向けです。

## 関連ページ

- [APIトークン](https://yoseno.com/ja/docs/integrations/api-tokens.md) — パーソナルトークンと \`/api/v1\` へのベアラーアクセス。
- [クレジットと制限](https://yoseno.com/ja/docs/account/billing-plans.md) — クレジット、購入、サブスクリプション、そして残高不足時のAI機能の動作。
- [REST API](https://yoseno.com/ja/docs/integrations/rest-api.md) — トークン、Bearerアクセス、リクエスト例、OpenAPIリファレンスへのリンク。

## 続きを読む

- [REST API](https://yoseno.com/ja/docs/integrations/rest-api.md) — トークン、Bearerアクセス、リクエスト例、OpenAPIリファレンスへのリンク。