Minds Team

ChatGPT、Claude、Cursor、VS Code向けMinds MCP設定ガイド

ChatGPT、Claude、Claude Code、Codex、Gemini CLI、Cursor、VS Code、Windsurf、OpenRouter、Open WebUI、およびAPIキー認証を使用したMinds MCPサーバーの設定方法。

以下のどのクライアントでも、同じ 31 個の公開ツールを利用できます。この数は稼働中のサーバーから取得しています。接続先サーバーの tools/list 応答を基準にしてください。

本ガイドでは、市場調査向けMinds MCPサーバーを、リモートツールをサポートするAIクライアントに接続する方法を解説します。サーバーURLには https://getminds.ai/mcp を使用してください。

ChatGPT

Web 版 ChatGPT を使ってください。利用可否と権限はアカウントとワークスペースによって異なります。OpenAI の最新 MCP 設定ガイドを参照してください。

  1. Plugins を開き、Add → Create MCP App を選びます。表示されない場合は、開発者モードを有効にするか、ワークスペース管理者にカスタム MCP アプリの許可を依頼してください。
  2. 名前を Minds とし、Server URL に https://getminds.ai/mcp を入力、Authentication で OAuth を選び、リスクの注意事項を確認して Create をクリックします。
  3. Continue to Minds をクリックし、Minds アカウントにサインインして Allow を選びます。
  4. 新しい会話で @Minds と入力し、Audiences の一覧を依頼します。広範な Studies は実行前に内容の確認と明示的な承認が必要です。

アカウントのプラグインディレクトリに Minds が表示される場合は、Plugins から追加し、同じ手順でサインインすることもできます。

ChatGPT デスクトップアプリでは、Plugins を開いて Add → Add MCP server を選びます。タイプを Streamable HTTP、URL を https://getminds.ai/mcp に設定して Save をクリックし、Restart を実行してから Authenticate を選んで Minds にサインインします。

ChatGPT 設定ガイド では、プラグインディレクトリとデスクトップアプリの方法も含めて各画面を説明しています。

対応する Web 環境では会話内に結果を表示できます。モバイル環境で表示されるウィジェットは、対話操作の代わりに Minds で続けるリンクを提供します。

Claude（claude.aiおよびClaude Desktop）

リモートコネクター（ウィジェット対応はクライアントによる）

カスタムコネクターは claude.ai と Claude Desktop で同じように動作し、両者の間で同期されます。

  1. Customize → Connectors を開き、+ をクリックして Add custom connector を選びます。
  2. リモートMCPサーバーのURLとして https://getminds.ai/mcp を入力し、Add をクリックします。
  3. Connect をクリックし、Mindsアカウントにサインインして Allow を選びます。
  4. 会話内で + → Connectors から Minds を有効にします。

Pro プランと Enterprise プランでは、まずオーナーが Organization settings → Connectors でコネクターを追加します。その後、各メンバーが Customize → Connectors で自分の Minds アカウントを接続します。

オプションB: ローカルコネクター（APIキー、テキストのみ）

設定ファイル（macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "mindsai": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://getminds.ai/mcp",
        "--header",
        "Authorization: Bearer minds_YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktopを再起動します。ツールはすぐに機能しますが、ローカルコネクターではインタラクティブウィジェットは利用できません。

Claudeにおけるウィジェットのサポート

公開ツールは、構造化テキストとクリック可能なリンクを返します。明示的な統合向けに、ほかの正規ライフサイクルツールも呼び出し可能になっています。詳しくはツールリファレンスをご覧ください。ウィジェット表示はクライアントとバージョンに依存するため、統合は構造化結果とテキスト結果だけでも完全に利用できる必要があります。

Claude Code (CLI)

claude mcp add --transport http minds https://getminds.ai/mcp

Claude Code で /mcp を実行し、minds を選択して Authenticate を選ぶと OAuth でサインインできます。API キーは任意です。API キーを使う場合は、コマンドに --header "Authorization: Bearer minds_YOUR_API_KEY" を追加します。

Codex

Codex CLI の場合:

codex mcp add minds --url https://getminds.ai/mcp
codex mcp login minds

codex mcp login を実行すると Minds のサインインページが開きます。Codex は Client ID Metadata Document で自身を登録するため、クライアント ID やシークレットは不要です。

Codex アプリまたは IDE 拡張機能では、Settings → MCP servers を開いて Add server を選び、Streamable HTTP を選択して https://getminds.ai/mcp を入力します。保存して再起動し、Authenticate を選びます。

API キーを使う場合は、~/.codex/config.toml の [mcp_servers.minds] に bearer_token_env_var = "MINDS_API_KEY" を設定し、その環境変数にキーをエクスポートします。

Gemini CLI

~/.gemini/settings.json にサーバーを追加します:

{
  "mcpServers": {
    "minds": { "httpUrl": "https://getminds.ai/mcp" }
  }
}

または gemini mcp add --transport http minds https://getminds.ai/mcp を実行します。Gemini CLI はサーバーから OAuth を検出し、初回利用時にサインインページを開きます。/mcp auth minds を実行することもできます。

Google Antigravity

サーバーを ~/.gemini/config/mcp_config.json（ワークスペースの場合は .agents/mcp_config.json）に追加します。Antigravity では serverUrl が必要で、url や httpUrl は使えません。

{
  "mcpServers": {
    "minds": { "serverUrl": "https://getminds.ai/mcp" }
  }
}

または agy mcp add --type http minds https://getminds.ai/mcp を実行します。サインインするには Settings → Customizations を開き、minds の横の Authenticate を選んで、サインイン後に表示されるコードを貼り付けます。プラグインのインストールと API キーについては Google Antigravity で Minds を使う を参照してください。

Cursor

  1. ~/.cursor/mcp.json、またはプロジェクト内の .cursor/mcp.json にサーバーを追加します:
{
  "mcpServers": {
    "minds": { "url": "https://getminds.ai/mcp" }
  }
}
  1. Cursor に求められたら認証を行い、Minds にサインインします。

VS Code (GitHub Copilot)

  1. コマンドパレットから MCP: Add Server を実行し、HTTP を選んで https://getminds.ai/mcp を入力します。または .vscode/mcp.json に追加します:
{
  "servers": {
    "minds": { "type": "http", "url": "https://getminds.ai/mcp" }
  }
}
  1. サーバーを起動し、求められたら VS Code による Minds へのサインインを許可します。その後、Copilot Chat のエージェントモードに Minds のツールが表示されます。

Windsurf

Cascade パネルで … メニューを開き、Open MCP config file を選びます。mcpServers の下に Minds を追加します:

{
  "mcpServers": {
    "minds": { "serverUrl": "https://getminds.ai/mcp" }
  }
}

ファイルを保存し、Windsurf に求められたら Minds にサインインします。API キーを使う場合は、エントリに "headers": { "Authorization": "Bearer ${env:MINDS_API_KEY}" } を追加します。

OpenRouter、Open WebUI、およびOpenAI互換ゲートウェイ

認証はMCPリクエストを実行するクライアントと、転送される認証情報によって決まります。モデル提供元のAPIキーではMindsに認証できません。

OAuthトークンの転送

OpenAIのResponses APIはMCPツールの authorization フィールドで既存のOAuthアクセストークンを受け付けます。アプリケーションが認可と更新を別途処理し、各リクエストでトークンを渡します。OpenAIのMCP認証ガイドを参照してください。

Open WebUI / OpenRouter

https://getminds.ai/mcp へのStreamable HTTP接続を設定します。選択したクライアントや実行モードがOAuthの完了とトークン転送に対応しない場合、設定 → APIキーでMindsのキーを作成し、クライアントの安全な保存先を使ってBearer認証を設定します。list_audiences でテストします。OpenRouterなどのゲートウェイでは現在のMCP対応と記述形式を確認してください。OpenAI互換のChat CompletionsだけではリモートMCP対応は保証されません。

OpenAI Responses APIの例

この例は環境変数からMindsのAPIキーを読みます。OAuthの場合、アプリケーションで有効なMindsトークンを取得してから、headers を "authorization": os.environ["MINDS_OAUTH_ACCESS_TOKEN"] に置き換えてください。

import os
from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-5.2",
    input="List my Audiences",
    tools=[{
        "type": "mcp",
        "server_label": "minds",
        "server_url": "https://getminds.ai/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['MINDS_API_KEY']}"},
        "allowed_tools": ["list_audiences"],
        "require_approval": "never",
    }],
)
print(response.output_text)

APIキー認証

プログラムによるアクセス、またはOAuthをサポートしていないクライアントの場合：

  1. Mindsの Settings → API Keys に移動します。
  2. 新しいAPIキーを作成します（minds_ で始まります）。
  3. Bearerトークンとして渡します: Authorization: Bearer minds_your_key_here

Scopes

OAuth クライアントは、OpenID の基本スコープ（openid、email、profile）と以下の Minds スコープを要求します。Minds の同意画面では、Allow を選ぶ前に各スコープの内容が製品上の言葉で表示されます。スコープを指定しないクライアントには、すべてのスコープが付与されます。

Scopeアクセス
openidConfirm who you are
emailSee your email address
profileSee your name and profile picture
sparks:readSee your Minds and Audiences
sparks:writeCreate and edit Minds and Audiences
sparks:chatAsk your Minds and Audiences questions
flows:readSee your Studies and their results
flows:writeCreate Studies and run research in them

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") がサポートされています。

ネイティブクライアントはループバックのリダイレクト URI（http://127.0.0.1、http://localhost、http://[::1]）を登録できます。ポートは照合されないため、クライアントは空いている任意のポートで待ち受けられます（RFC 8252）。クライアントは Client ID Metadata Document も使用できます。これはメタデータを公開する https URL を client_id として使う方式です（client_id_metadata_document_supported: true）。トークンエンドポイントは、リクエスト本文の client_id、または空のシークレットによる HTTP Basic 認証を受け付けます。

トラブルシューティング

「Authentication required」エラー

OAuth認可フローが完了していることを確認してください。MCPクライアントを切断して再接続し、再認可を行ってください。

MCPを実行するコンポーネントが有効なMindsのBearer認証情報を転送していることを確認してください。OAuthを再接続するか、管理元のクライアントでトークンを更新します。トークン転送に対応しない場合はAPIキーを使用します。提供元のキーやホストへのログインはMindsの認証情報の代わりにはなりません。

Minds では開ける Study、Audience、Mind に "Not authorized" と表示される

MCP クライアントが、そのアイテムを所有するアカウントとは別の Minds アカウントでサインインしています。エラーには接続中のアカウントが表示されます。所有者のアカウントでクライアントを接続し直すか、接続中のアカウントとアイテムを共有してください。

Claude DesktopのOAuthが完了しない

OAuthのポップアップは開くものの完了しない場合は、APIキーを使用する方法（上記のオプションB）をお試しください。Claude DesktopのリモートコネクターのOAuthは、動作が不安定な場合があります。

Mindが見つからない

mindName を使用する際は、名前が対象のMindと高い精度で一致していることを確認してください。システムはあいまいマッチングを使用しますが、一定以上の類似度スコアが必要です。

Mindがまだトレーニング中

新しいMindは、トレーニングが完了するまでに少し時間がかかる場合があります。チャットを開始する前に、get_mind_status を使用してトレーニングが完了しているか確認してください。

パネル質問のタイムアウト

グループ数が多いパネル質問は、2分以上かかる場合があります。グループ数を減らすか、質問をシンプルにしてみてください。

PDFエクスポートの準備ができていない

エクスポートは非同期です。同じ studyId と、export_study が返した正確な exportKind、exportFormat、exportJobId を指定して get_study_status をポーリングします。ジョブ状態とダウンロードURLを確認してください。所要時間は変動します。ポーリングのタイムアウトは重複エクスポートの許可ではありません。

結果の読み込みが続く、またはデータが不足している

結果ウィジェットはホストの更新を受け取り、許可された環境では回数を制限して状態を自動取得します。継続的なトークンのストリーミングを保証するものではありません。それ以外では、表示された更新操作を使うか、既存の Study の状態を質問するか、返された Minds リンクを開いてください。

直接の質問には get_study_status、承認済み計画には get_study_run を使います。同じ studyId を維持してください。読み込みやタイムアウトを理由に再実行してはいけません。部分回答と回答範囲の不足を明示してください。質問の処理が終わっても、すべての Mind が回答したとは限りません。

n8nワークフロー

n8n用Mindsコミュニティノード を使用して、Studyの作成、リサーチプランのプレビュー、Studyや保存されたサマリーの取得、またはAI Agentへの操作の公開を行います。セルフホスト版n8nに n8n-nodes-minds をインストールし、Minds APIキーを接続します。パッケージはnpmで公開されていますが、n8nの検証は審査中のため、n8n Cloudではまだ利用できません。リサーチの確認と開始はMinds上で個別に行ってください。

Minds© 2026 Minds. あなたのターゲットオーディエンス。AIを活用し、透明な根拠に基づいています。数分で構築できます。
Minds は以下に参加しています
ESOMARGreenBookInsight PlatformsCapterraG2CSSDA Best UX Design AwardCSSDA Best Innovation AwardCSSDA Best UI Design Award