--- title: "ChatGPT、Claude、Cursor、VS Code向けMinds MCP設定ガイド" description: "ChatGPT、Claude Desktop、Cursor、VS Code、OpenRouter、Open WebUI、およびAPIキー認証を使用したMinds MCPサーバーの設定方法。" canonical_url: "https://getminds.ai/mcp/ja/setup" last_updated: "2026-08-13T13:01:24.625Z" --- # ChatGPT、Claude、Cursor、VS Code向けMinds MCP設定ガイド 本ガイドでは、[市場調査向けMinds MCPサーバー](/mcp/overview)を、リモートツールをサポートするAIクライアントに接続する方法を解説します。サーバーURLには `https://getminds.ai/mcp` を使用してください。 ## ChatGPT 1. **ChatGPT** → **Settings**（設定） → **Connected Apps**（接続済みのアプリ）に移動します。 2. 「Minds」を検索するか、MCP URLを追加します: `https://getminds.ai/mcp` 3. **Connect**（接続）をクリックし、OAuth経由で認証します（Mindsアカウントにログイン）。 4. チャットを開始します。ChatGPTにMindsの作成、パネルの実行、結果の分析を指示してください。 ChatGPTはインタラクティブなウィジェットをインラインでレンダリングします。グループ化された回答を含むパネル結果、棒グラフ、クリック可能なMindのアバターがチャット内に直接表示されます。 ## Claude Desktop ### オプションA: リモートコネクター（推奨、インタラクティブウィジェット対応） 1. Claude Desktopを開き、**Customize** → **Connectors**（または **Settings** → **Connections**）に移動します。 2. 新しいリモートコネクターとして `https://getminds.ai/mcp` を追加します。 3. プロンプトが表示されたらOAuth経由で認証します（Mindsアカウントにログイン）。 4. 認証後、ツールが自動的に表示されます。 ### オプションB: ローカルコネクター（APIキー、テキストのみ） 設定ファイル（macOSでは `~/Library/Application Support/Claude/claude_desktop_config.json`）に以下を追加します。 ```json { "mcpServers": { "mindsai": { "command": "npx", "args": [ "-y", "mcp-remote", "https://getminds.ai/mcp", "--header", "Authorization: Bearer minds_YOUR_API_KEY" ] } } } ``` Claude Desktopを再起動します。ツールはすぐに機能しますが、ローカルコネクターではインタラクティブウィジェットは利用できません。 ### Claudeにおけるウィジェットのサポート 公開される15個のツールは、構造化テキストとクリック可能なリンクを返します。明示的な統合向けに、さらに18個の正規ライフサイクルツールが登録されています。ウィジェット表示はクライアントとバージョンに依存するため、統合は構造化結果とテキスト結果だけでも完全に利用できる必要があります。 ## Claude Code (CLI) ```bash claude mcp add --transport http mindsai https://getminds.ai/mcp \ --header "Authorization: Bearer minds_YOUR_API_KEY" ``` ## Cursor 1. CursorのSettings（設定） → **MCP** を開きます。 2. 次のURLで新しいサーバーを追加します: `https://getminds.ai/mcp` 3. プロンプトが表示されたらアクセスを承認します。 ## VS Code (GitHub Copilot) 1. VS CodeのSettings（設定） → **Extensions**（拡張機能） → **GitHub Copilot** → **MCP Servers** を開きます。 2. 新しいサーバーとして `https://getminds.ai/mcp` を追加します。 3. プロンプトが表示されたら承認します。 ## OpenRouter、Open WebUI、およびOpenAI互換ゲートウェイ ホストではなく**モデルプロバイダー**がサーバー側でMCP呼び出しを実行する環境（例: OpenRouter経由でアクセスする `openai/*` モデル、OpenAIのResponses APIの直接利用、または *Native function-calling*（ネイティブ関数呼び出し）モードのOpen WebUIなど）では、**必ずAPIキー認証を使用する必要があります**。この経路ではOAuthはサポートされていません。 ### なぜここではOAuthが機能しないのか Open WebUIがネイティブモードで `openai/gpt-5.2` エージェントを実行する場合、リクエストの一部としてMCPツール記述子をOpenAIやOpenRouterに送信します。その後、OpenAIのサーバー側MCPランナー（Azure上で動作、`User-Agent: python-httpx/*` で識別可能）が、当社の `/mcp` エンドポイントを直接呼び出します。このランナーはツールの登録時に設定された**静的**なヘッダーのみを付与し、MCP OAuthハンドシェイク（RFC 9728 / 8414 / 7591）は実行しません。そのため、Open WebUIの「*OAuth , システムユーザーのアクセストークンを転送する*」モードは機能しません（ユーザーのトークンがOpen WebUIから外に出ることはありません）。 結果として、Mindsは `Authorization` ヘッダーのないリクエストを受信し、以下を返します。 ```text 401 Unauthorized www-authenticate: Bearer resource_metadata="https://getminds.ai/.well-known/oauth-protected-resource" {"error":{"code":-32001,"message":"Authentication required. Connect your Minds account via OAuth or provide an API key."}} ``` ### Open WebUIの設定方法 1. [Settings → API Keys](/settings/api-keys) でAPIキーを生成します（フォーマットは `minds_…`）。 2. Open WebUIで、**Admin → Settings → Tools → + Connection** の順に移動します。 3. 以下を設定します。 - **Type**: `Streamable HTTP (MCP)` - **URL**: `https://getminds.ai/mcp` - **Authentication**: `Bearer` *（OAuthではありません）* - **Token**: 生成した `minds_…` キー 4. 接続を保存します。 5. エージェントの *Werkzeuge / Tools* タブで、**Get Minds** ツールを紐付けます。 6. エージェントにMindsの一覧を表示するよう指示して、テストを行います。 `Authentication: OAuth` のままでも、Open WebUI自体がツールを実行し（すなわち *Function calling = Default* であり、*Native* ではない）、**かつ**上流のモデルにツールの結果を再プロンプトできる場合に限り、呼び出しは成功します。しかし、ほとんどのユーザーはネイティブモードを希望するため、Bearerキーを使用してください。 ### OpenRouterでの直接利用（プログラムによる呼び出し） OpenRouterのチャット完了（chat completions）APIを呼び出してMinds MCPサーバーを紐付ける場合は、ツール記述子の静的な `headers` フィールドにAPIキーを渡します。 ```json { "type": "mcp", "server_label": "minds", "server_url": "https://getminds.ai/mcp", "headers": { "Authorization": "Bearer minds_YOUR_API_KEY" } } ``` OpenAIのResponses APIを直接呼び出す場合も同様です。 ```python from openai import OpenAI client = OpenAI() client.responses.create( model="gpt-5.2", input="List my Minds", tools=[{ "type": "mcp", "server_label": "minds", "server_url": "https://getminds.ai/mcp", "headers": {"Authorization": f"Bearer {os.environ['MINDS_API_KEY']}"}, }], ) ``` ## APIキー認証 プログラムによるアクセス、またはOAuthをサポートしていないクライアントの場合： 1. Mindsの [Settings → API Keys](/settings/api-keys) に移動します。 2. 新しいAPIキーを作成します（`minds_` で始まります）。 3. Bearerトークンとして渡します: `Authorization: Bearer minds_your_key_here` ## OAuthディスカバリー MCP統合を構築する開発者向けに、OAuthメタデータは以下で提供されています。
エンドポイント 説明
/.well-known/oauth-protected-resource 保護されたリソースのメタデータ (RFC 9728)
/.well-known/oauth-authorization-server 認可サーバーのメタデータ (RFC 8414)
/oauth/register 動的クライアント登録 (RFC 7591)
PKCE (S256) を使用したOAuth 2.1が必要です。パブリッククライアント (`token_endpoint_auth_method: "none"`) がサポートされています。 ## トラブルシューティング ### 「Authentication required」エラー OAuth認可フローが完了していることを確認してください。MCPクライアントを切断して再接続し、再認可を行ってください。 **OpenRouter、ネイティブモードのOpen WebUI、またはOpenAIのResponses APIを直接**使用してMindsを呼び出している場合、その経路ではOAuthはサポートされていません。モデルプロバイダーのサーバー側MCPランナーはOAuthハンドシェイクを実行できません。MCP接続を `minds_…` キーを使用した **Bearer / APIキー認証** に切り替えてください。詳細は上記の [OpenRouter、Open WebUI、およびOpenAI互換ゲートウェイ](#openrouter-open-webui-and-openai-compatible-gateways) を参照してください。 ### Claude DesktopのOAuthが完了しない OAuthのポップアップは開くものの完了しない場合は、APIキーを使用する方法（上記のオプションB）をお試しください。Claude DesktopのリモートコネクターのOAuthは、動作が不安定な場合があります。 ### Mindが見つからない `sparkName` を使用する際は、名前が対象のMindと高い精度で一致していることを確認してください。システムはあいまいマッチングを使用しますが、一定以上の類似度スコアが必要です。 ### Mindがまだトレーニング中 新しいMindは、トレーニングが完了するまでに少し時間がかかる場合があります。チャットを開始する前に、`get_mind_status` を使用してトレーニングが完了しているか確認してください。 ### パネル質問のタイムアウト グループ数が多いパネル質問は、2分以上かかる場合があります。グループ数を減らすか、質問をシンプルにしてみてください。 ### PDFエクスポートの準備ができていない PDFレポートは非同期で生成されます。`get_panel_status` を使用してエクスポートのステータスを確認してください。生成には通常30〜60秒かかります。