QA Spider MCPサーバー:Cursor、Claude、Codexからサイトを修正

カスタムコネクターは、Claudeアカウントを通じて、claude.ai、Claude Desktop、モバイルアプリで使えます。

1. 個人プラン:「Customize」を開き、「Connectors」で「+ Add」を押して、「Add custom connector」を選びます。TeamとEnterpriseでは、オーナーが「Organization settings」の「Connectors」、「Add」、「Custom」、「Web」から追加します。
2. 名前をQA Spiderにして、アドレスを貼り付けます:https://www.qaspider.com/api/mcp
3. 「Connect」を押してQA Spiderのアカウントでサインインし、同意画面でチームと権限を選びます。
4. キーを使いたい場合は、「Request headers」で固定ヘッダーを1つ追加します。Authorizationに、下に表示されている値を指定します。

https://www.qaspider.com/api/mcp

Authorization: Bearer qsp_YOUR_KEY

Claudeはお使いのコンピューターではなくAnthropicのクラウドから接続するため、サーバーにはインターネットから到達できる必要があります。QA Spiderは到達できます。

無料のClaudeアカウントでは、カスタムコネクターを1つ追加できます。

claude_desktop_config.jsonファイルはローカルサーバー用の別の仕組みです。リモートサーバーにはコネクターの画面を使ってください。

提供元のドキュメントで確認しました。

Web版のChatGPTは、リモートMCPサーバーを開発者モードのアプリとして使えます。

1. Web版のChatGPTで、開発者モードをオンにし(「設定」の「セキュリティとログイン」)、プラグインの画面の+ボタンでアプリを作成します。OpenAIはこれらの画面名をたびたび変更します。現在の名称は下の提供元のページで確認してください。
2. リモートMCPサーバーを選び、アドレスを貼り付けます:https://www.qaspider.com/api/mcp
3. 認証にOAuthを選び、QA Spiderのアカウントでサインインして、チームと権限を選びます。
4. 新しいアプリは「下書き」に表示され、個々のツールをオンまたはオフにできます。

https://www.qaspider.com/api/mcp

Web版で、Pro、Plus、Business、Enterprise、Educationのアカウントで利用できます。

OpenAIのドキュメントでは、これらのアプリの認証はOAuthまたは認証なしとされ、ベアラーキーは挙げられていません。ここではサインインを使ってください。

読み取り専用と表示されていないツールは、ChatGPTが確認を求めます。

提供元のドキュメントで確認しました。

Anthropicのコーディングエージェント。ターミナルとIDEで使えます。

1. 下の追加コマンドを、ターミナルで実行します。
2. Claude Codeを起動して/mcpと入力します。qaspiderを選び、ブラウザーでのサインインに従って、チームと権限を選びます。
3. キーを使いたい場合は、代わりに2つ目のコマンドを、ダッシュボードのキーで実行します。

claude mcp add --transport http qaspider https://www.qaspider.com/api/mcp

claude mcp add --transport http qaspider https://www.qaspider.com/api/mcp \
  --header "Authorization: Bearer qsp_YOUR_KEY"

{
  "mcpServers": {
    "qaspider": {
      "type": "http",
      "url": "https://www.qaspider.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${QASPIDER_KEY}"
      }
    }
  }
}

--scope userを付けるとすべてのプロジェクトで使え、--scope projectを付けるとチーム用に.mcp.jsonが書き込まれます。既定では現在のプロジェクト内に限られます。

.mcp.jsonは${VAR}を展開するため、ファイルはコミットし、キーはシェルの環境に置いてください。

提供元のドキュメントで確認しました。

Codex CLI、IDE拡張機能、ChatGPTデスクトップアプリは、1つの設定ファイルを共有します。

1. ~/.codex/config.tomlを開き、下のブロックを追加します。
2. キーを使う場合:Codexを起動するシェルでexport QASPIDER_KEY=qsp_YOUR_KEYを実行します。Codexはそれをベアラートークンとして送信します。
3. サインインを使う場合:urlの行だけを残し、ログインコマンドを実行して、ブラウザーでのサインインを承認します。

[mcp_servers.qaspider]
url = "https://www.qaspider.com/api/mcp"
bearer_token_env_var = "QASPIDER_KEY"

[mcp_servers.qaspider]
url = "https://www.qaspider.com/api/mcp"

codex mcp login qaspider

Codexは、サーバーが対応していれば動的クライアント登録を使います。QA Spiderは対応しています。

提供元のドキュメントで確認しました。

Googleのオープンソースのターミナルエージェント。リモートサーバーにはhttpUrlを使います。

1. 下のコマンドを実行するか、~/.gemini/settings.json(ユーザー)または.gemini/settings.json(プロジェクト)にエントリーを追加します。
2. 接続キーを使います:Gemini CLIのドキュメントではこのためにheadersが示されており、OAuthは自分で登録したクライアントIDがある場合に限られます。

gemini mcp add --transport http -H "Authorization: Bearer qsp_YOUR_KEY" qaspider https://www.qaspider.com/api/mcp

{
  "mcpServers": {
    "qaspider": {
      "httpUrl": "https://www.qaspider.com/api/mcp",
      "headers": {
        "Authorization": "Bearer qsp_YOUR_KEY"
      }
    }
  }
}

設定ファイルにはキーが平文で保存されます。リポジトリ内のものではなく、ユーザーレベルのファイルを使ってください。

提供元のドキュメントで確認しました。

WarpターミナルのエージェントはURLベースのMCPサーバーを使えます。

1. 「Settings」、「Agents」、「MCP servers」を開き(またはコマンドパレットで「Open MCP Servers」を検索)、「+ Add」を押します。
2. Streamable HTTPまたはSSEサーバー(URL)を選び、下のJSONを貼り付けます。

{
  "qaspider": {
    "url": "https://www.qaspider.com/api/mcp",
    "headers": {
      "Authorization": "Bearer qsp_YOUR_KEY"
    }
  }
}

WarpのドキュメントではOAuthを内蔵したサーバーにブラウザーでのサインインが説明されています。始まらない場合はキーを使ってください。

提供元のドキュメントで確認しました。

AIコードエディター。1つのファイルですべてのMCPサーバーを管理します。

1. すべてのプロジェクトでQA Spiderを使うには~/.cursor/mcp.jsonを、1つのプロジェクトだけなら、その中の.cursor/mcp.jsonを開きます。
2. 下のエントリーを追加します。Cursorは${env:NAME}を環境から読み取るため、キーがファイルに入ることはありません。
3. 変数を設定し(export QASPIDER_KEY=qsp_YOUR_KEY)、Cursorを再起動します。
4. キーの代わりにサインインを使うには、headersブロックを省き、Cursorが求めたらブラウザーでのサインインを承認します。

{
  "mcpServers": {
    "qaspider": {
      "url": "https://www.qaspider.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:QASPIDER_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "qaspider": {
      "url": "https://www.qaspider.com/api/mcp"
    }
  }
}

サインインが始まらない場合は、キーを使ってください。Cursorのドキュメントには、自動のサインインではなく、固定のOAuth認証情報が記載されています。

提供元のドキュメントで確認しました。

GoogleのエージェントファーストなIDE。リモートサーバーにはurlではなくserverUrlを使います。

1. 「Settings」の「Customizations」からMCPの設定を開きます(グローバルファイルは~/.gemini/config/mcp_config.json、プロジェクトでは.agents/mcp_config.jsonも使えます)。
2. 下のエントリーを追加します。serverUrlを使ってください。Antigravityは、リモートサーバーにurlやhttpUrlを受け付けません。
3. キーの代わりにサインインを使うには、headersを省き、「Installed MCP Servers」のQA Spiderの横にある「Authenticate」を押します。

{
  "mcpServers": {
    "qaspider": {
      "serverUrl": "https://www.qaspider.com/api/mcp",
      "headers": {
        "Authorization": "Bearer qsp_YOUR_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "qaspider": {
      "serverUrl": "https://www.qaspider.com/api/mcp"
    }
  }
}

このファイルにはキーが平文で保存されます。リポジトリには入れないでください。

提供元のドキュメントで確認しました。

Copilotのエージェントモードを使うVisual Studio Code。

1. コマンドパレットから「MCP: Open User Configuration」を実行します(またはプロジェクトに.vscode/mcp.jsonを作成します)。
2. 下のエントリーを追加します。inputsブロックにより、VS Codeがキーを一度だけ尋ねて保存するため、キーがファイルに入ることはありません。
3. 代わりにサインインを使うには、headersとinputsを省きます。VS Codeは初回の利用時にブラウザーを開きます。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "qaspider-key",
      "description": "QA Spider connection key",
      "password": true
    }
  ],
  "servers": {
    "qaspider": {
      "type": "http",
      "url": "https://www.qaspider.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:qaspider-key}"
      }
    }
  }
}

{
  "servers": {
    "qaspider": {
      "type": "http",
      "url": "https://www.qaspider.com/api/mcp"
    }
  }
}

VS Codeでは、最上位のキーはmcpServersではなくserversです。

提供元のドキュメントで確認しました。

Cascadeエージェントのエディター。リモートサーバーにはserverUrlを使います。

1. CascadeのMCP設定からmcp_config.jsonを開きます(ファイルの場所はシステムごとに提供元のページに記載があります)。
2. 下のエントリーを追加し、環境にQASPIDER_KEYを設定します。Windsurfはheaders内の${env:NAME}を読み取ります。

{
  "mcpServers": {
    "qaspider": {
      "serverUrl": "https://www.qaspider.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:QASPIDER_KEY}"
      }
    }
  }
}

提供元のページには、各トランスポートでOAuthに対応するとありますが手順は示されていないため、このページではキーの方法を説明しています。

提供元のドキュメントで確認しました。

Zedエディターは、リモートサーバーをcontext_serversに記載します。

1. 「zed: open settings file」を実行するか、「Settings」の「AI」の「MCP Servers」を使います。
2. 下のエントリーを追加します。Authorizationヘッダーがなければ、Zedが標準のMCPサインインを開始します。

{
  "context_servers": {
    "qaspider": {
      "url": "https://www.qaspider.com/api/mcp",
      "headers": {
        "Authorization": "Bearer qsp_YOUR_KEY"
      }
    }
  }
}

{
  "context_servers": {
    "qaspider": {
      "url": "https://www.qaspider.com/api/mcp"
    }
  }
}

設定ファイルにはキーが平文で保存されます。Zedの設定は同期やコミットされることが多いため、サインインをおすすめします。

提供元のドキュメントで確認しました。

VS CodeとJetBrains向けのCline拡張機能。

1. ClineでMCP Serversアイコンを開き、「Configure」、「Configure MCP Servers」の順に選びます。
2. 下のエントリーを追加します。typeはstreamableHttpに設定してください。省略すると、古いSSEトランスポートが選ばれます。

{
  "mcpServers": {
    "qaspider": {
      "type": "streamableHttp",
      "url": "https://www.qaspider.com/api/mcp",
      "headers": {
        "Authorization": "Bearer qsp_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

このファイルにはキーが平文で保存されます。ツールを呼び出すたびにClineが確認するよう、autoApproveは空にしてください。

提供元のドキュメントで確認しました。

Continue拡張機能。MCPはエージェントモードでのみ動作します。

1. プロジェクトに.continue/mcpServers/qaspider.yamlを作成します。
2. 下のファイルを貼り付け、キーをQASPIDER_KEYという名前のContinueのシークレットとして保存します。
3. Continueをエージェントモードに切り替えます。MCPのツールはチャットモードでは使えません。

name: QA Spider
version: 0.0.1
schema: v1
mcpServers:
  - name: QA Spider
    type: streamable-http
    url: https://www.qaspider.com/api/mcp
    requestOptions:
      headers:
        Authorization: "Bearer ${{ secrets.QASPIDER_KEY }}"

提供元のドキュメントで確認しました。

IntelliJ IDEA、PyCharm、WebStorm、その他のJetBrains IDE。

1. 「Settings」、「Tools」、「AI Assistant」、「Model Context Protocol (MCP)」を開き、「Add」を押して下のJSONを貼り付けます。
2. リモートサーバーには、Streamable HTTPに対応した最近のAI Assistantのリリースが必要です。「Add」でURLが拒否される場合は、IDEを更新するか、下のmcp-remoteブリッジを使ってください。

{
  "mcpServers": {
    "qaspider": {
      "url": "https://www.qaspider.com/api/mcp",
      "headers": {
        "Authorization": "Bearer qsp_YOUR_KEY"
      }
    }
  }
}

JetBrainsはこのファイルの環境変数を展開しないため、キーはIDEの設定に保存されます。

提供元のドキュメントで確認しました。

ローカル(stdio)サーバーしか起動できないクライアント向け。オープンソースのmcp-remoteパッケージが、QA Spiderをそのように見せます。

1. Node.jsが必要です。クライアントのMCP設定に、下のエントリーを追加します(Claude Desktop、Cursor、Windsurfがローカルサーバーに使うのと同じmcpServersの形式です)。
2. ヘッダーがなければ、mcp-remoteがブラウザーを開いてサインインさせ、トークンはお使いのコンピューターに保存されます。
3. キーを使う場合は、環境変数で渡します。ヘッダーはAuthorization:${QASPIDER_AUTH}と、コロンの後にスペースを入れずに書いてください。クライアントによってはargs内のスペースが壊れるためで、環境変数内のスペースは問題ありません。

{
  "mcpServers": {
    "qaspider": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.qaspider.com/api/mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "qaspider": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.qaspider.com/api/mcp",
        "--header",
        "Authorization:${QASPIDER_AUTH}"
      ],
      "env": {
        "QASPIDER_AUTH": "Bearer qsp_YOUR_KEY"
      }
    }
  }
}

mcp-remoteはQA Spiderが作ったものではない、別のオープンソースプロジェクトです。クライアントがリモートサーバーに直接対応したら、すぐに外してください。

提供元のドキュメントで確認しました。