QA Spider MCP 服务器：在 Cursor、Claude 和 Codex 中修复你的网站

自定义连接器可通过您的 Claude 账号在 claude.ai、Claude Desktop 和移动应用中使用。

1. 个人套餐：打开“自定义”，进入“连接器”，点击 + 添加，选择“添加自定义连接器”。Team 和 Enterprise 套餐由所有者在“组织设置”的“连接器”中依次选择“添加”“自定义”“Web”。
2. 将其命名为 QA Spider，并粘贴地址：https://www.qaspider.com/api/mcp
3. 点击“连接”，使用您的 QA Spider 账号登录，然后在授权页面选择团队和权限。
4. 想用密钥？在“请求头”下添加一个固定请求头：Authorization，值见下方。

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

Authorization: Bearer qsp_YOUR_KEY

Claude 从 Anthropic 的云端发起连接，而不是从您的电脑，因此服务器必须能从互联网访问。QA Spider 满足这一点。

免费 Claude 账号可添加一个自定义连接器。

claude_desktop_config.json 文件是用于本地服务器的另一种机制；远程服务器请使用连接器界面。

已对照厂商文档核实。

网页版 ChatGPT 可以把远程 MCP 服务器作为开发者模式应用使用。

1. 在网页版 ChatGPT 中开启开发者模式（设置，安全与登录），然后在插件页面点击 + 按钮创建应用。OpenAI 经常更改这些界面的名称；下方的官方页面有最新名称。
2. 选择远程 MCP 服务器，并粘贴地址：https://www.qaspider.com/api/mcp
3. 认证方式选择 OAuth，然后用您的 QA Spider 账号登录，并选择团队和权限。
4. 新应用会出现在“草稿”下，您可以在那里逐个开启或关闭工具。

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

网页版支持 Pro、Plus、Business、Enterprise 和 Education 账号。

OpenAI 的文档只列出这类应用可使用 OAuth 或无认证，不支持 Bearer 密钥，因此请在这里使用登录方式。

对于任何未标记为只读的工具，ChatGPT 会要求您确认。

已对照厂商文档核实。

Anthropic 推出的编程智能体，可用于终端和 IDE。

1. 在终端中运行下面的添加命令。
2. 启动 Claude Code，输入 /mcp。选择 qaspider，按提示在浏览器中登录，然后选择团队和权限。
3. 想用密钥？改用第二条命令，并填入控制台中的密钥。

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}，因此可以提交该文件，而把密钥保留在 shell 环境中。

已对照厂商文档核实。

Codex CLI、IDE 扩展和 ChatGPT 桌面应用共用一个配置文件。

1. 打开 ~/.codex/config.toml 并添加下面的配置块。
2. 使用密钥：在启动 Codex 的 shell 中执行 export QASPIDER_KEY=qsp_YOUR_KEY。Codex 会把它作为 Bearer 令牌发送。
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 只能配合您自行注册的 client 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. 打开“设置”，进入 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 代码编辑器。所有 MCP 服务器都在一个文件中配置。

1. 打开 ~/.cursor/mcp.json，可在所有项目中使用 QA Spider；或使用某个项目内的 .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。远程服务器使用 serverUrl，而不是 url。

1. 打开“设置”，进入“自定义”，再打开 MCP 配置（全局文件为 ~/.gemini/config/mcp_config.json；项目可使用 .agents/mcp_config.json）。
2. 添加下面的条目。请使用 serverUrl：Antigravity 的远程服务器不接受 url 或 httpUrl。
3. 如果想用登录代替密钥，请省略 headers，然后在“已安装的 MCP 服务器”下点击 QA Spider 旁的“认证”。

{
  "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 中，顶层键是 servers（不是 mcpServers）。

已对照厂商文档核实。

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”，或使用“设置”，AI，MCP 服务器。
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": []
    }
  }
}

该文件以明文保存您的密钥；请保持 autoApprove 为空，这样 Cline 会在每次调用工具前询问。

已对照厂商文档核实。

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. 打开“设置”，进入“工具”，AI Assistant，Model Context Protocol (MCP)，点击“添加”并粘贴下面的 JSON。
2. 远程服务器需要支持 Streamable HTTP 的较新版 AI Assistant。如果“添加”拒绝该 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 开发的。一旦您的客户端直接支持远程服务器，就不要再用它了。

已对照厂商文档核实。