> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code の MCP 設定

> ネイティブのリモート MCP の設定、ブラウザでの認証、ツールの検証、トラブルシューティング

このページでは、Claude Code でのネイティブ MCP を扱います。リモートのサービスは Streamable HTTP とブラウザの OAuth を使い、EvoLink CLI は必要ありません。コマンドやスキルを実行する場合は、別の [CLI ガイド](https://evolink.ai/docs/ja/cli/claude-code.md)を使ってください。

## リモート MCP を接続する

ネイティブツールを使う場合は、**Streamable HTTP + OAuth** と、次のサーバー URL を使います：

```text theme={null}
https://mcp.evolink.ai/mcp
```

CLI のインストールは必要ありません。既存の設定をバックアップし、EvoLink の部分だけをマージして、ほかのサービスはそのまま残してください。コマンドによる登録か、手動での登録のどちらかを選びます。

**1. HTTP サーバーを追加する**

Claude Code がインストールされているターミナルで、次を実行します：

```bash theme={null}
claude mcp add --transport http --scope user evolink https://mcp.evolink.ai/mcp
```

`--scope user` を指定すると、現在のユーザーは、プロジェクトをまたいでこの接続を利用できます。追加できたことは、設定が書き込まれたことを示すだけです。

**2. Claude Code の中でログインする**

Claude Code の会話で、次のセッションコマンドを入力し、EvoLink の認証操作を選択します：

```text theme={null}
/mcp
```

ブラウザでのログインと承認を完了してから、Claude Code で接続を確認します。このセッションコマンドは、通常のシェルコマンドではありません。

**3. ツールを確認し、無料で検証する**

```bash theme={null}
claude mcp list
```

求められた場合は、承認待ちのプロジェクト接続を Claude Code の中で承認します。新しいセッションで、下記の検証用プロンプトを送信し、実際の残高とモデルが返ることを確認してください。

プロジェクト単位で設定する場合は、`.mcp.json` にマージします：

```json theme={null}
{
  "mcpServers": {
    "evolink": {
      "type": "http",
      "url": "https://mcp.evolink.ai/mcp"
    }
  }
}
```

このブロックを `.claude/settings.local.json` に入れないでください。ユーザースコープは、上記のコマンドが管理します。[Claude Code のドキュメント](https://code.claude.com/docs/en/mcp)を参照してください。

認証が済んだら、エージェントのチャットで次を送信します：

```text theme={null}
EvoLink でアカウントの残高を確認し、利用可能な画像モデルを検索してください。まだ生成しないでください。
```

**成功の目安**：`check_balance` と `search_models` の実際の呼び出しが結果を返すこと。これらのツールは、実際の MCP 接続で検証してください。

## アップデート、切断、トラブルシューティング

ホスト型の MCP サーバーは、EvoLink が更新します。設定を変更したら、実際に使っているクライアントのセッションを再読み込みしてください。必要に応じて、そのクライアントの OAuth 操作から再認証します。切断するには、ホストの MCP 設定で EvoLink を無効にするか、ログアウトするか、削除してください。ほかのサーバーはそのまま残します。

| 症状 | 対処 |
| - | - |
| URL を追加したのにツールがない | 接続を有効にし、認証を完了して、再読み込みし、組織のポリシーを確認します |
| 401、または認証を求められる | この MCP 接続を再認証し、元のタスク ID を保持します |
| 403、またはツールが拒否される | ホストの権限、アカウントやキーの状態、ネットワークのエラーを確認します |
| タイムアウト、またはレスポンスを受け取れない | 生成し直すのではなく、元の操作を照会して復旧します |
| リンクだけが表示される、またはプレビューがグレーになる | 自動的に作り直さずに、オリジナルファイルを開いて渡します |

[MCP の料金、アクセス、トラブルシューティング](https://evolink.ai/docs/ja/mcp/billing.md#faq)を参照してください。送信の前に、[制作のワークフロー](https://evolink.ai/docs/ja/mcp/overview.md#workflows)を読んでください。呼び出しの形は、[MCP ツールリファレンス](https://evolink.ai/docs/ja/mcp/tools.md)にあります。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.