客户端配置指南

服务地址

https://mcp.bazhuayu.com

认证方式：OAuth 2.1（推荐）或 API Key（Header：x-api-key）。API Key 创建见获取 API Key。

Agent 对话安装

WorkBuddy、QClaw、豆包专业版等能够自行管理工具配置的 Agent，可直接通过对话添加八爪鱼 MCP。推荐使用获取 API Key页面提供的完整提示词，让 Agent 写入 x-api-key 请求头、刷新工具列表并完成连接测试。

对这类 Agent，应明确要求本次接入仅使用 API Key，不要把 Key 配置成 OAuth 凭据或 Authorization: Bearer。不支持自主配置的客户端，请继续按下方平台步骤手动操作。

ChatGPT

打开 ChatGPT → Settings → Connectors（或「连接器」）。
添加 MCP 连接器，URL 填写 https://mcp.bazhuayu.com 或 https://mcp.octoparse.com。
选择 OAuth 完成八爪鱼登录，或使用 API Key（若界面支持自定义 Header）。
在新对话中启用该连接器后测试搜索模板。

Claude（桌面 / Web）

Settings → Connectors → Add connector。
输入 MCP URL：https://mcp.bazhuayu.com 或 https://mcp.octoparse.com。
通过 OAuth 授权八爪鱼账户。
在对话中确认已勾选八爪鱼 MCP 工具。

Claude Code

编辑 ~/.claude/settings.json：

{
  "mcpServers": {
    "octoparse": {
      "type": "http",
      "url": "https://mcp.bazhuayu.com",
      "headers": {
        "x-api-key": "你的APIKey"
      }
    }
  }
}

或使用 OAuth 流程（以 Claude Code 当前版本文档为准）。详见获取 API Key。

Cursor

编辑 ~/.cursor/mcp.json（Windows 为 %USERPROFILE%\.cursor\mcp.json）：

{
  "mcpServers": {
    "octoparse": {
      "type": "http",
      "url": "https://mcp.bazhuayu.com",
      "headers": {
        "x-api-key": "你的APIKey"
      }
    }
  }
}

保存后重启 Cursor，在 Settings → MCP 中确认服务在线。

Gemini

若使用的 Gemini 客户端或 IDE 扩展支持 MCP 连接器：

在 Settings → MCP / Extensions / Connectors 中添加 HTTP MCP 服务。
URL：https://mcp.bazhuayu.com 或 https://mcp.octoparse.com。
OAuth 登录八爪鱼，或在 Headers 中配置 x-api-key。
在对话中启用八爪鱼工具后测试 list_platforms 或 search_templates。

具体入口名称因 Gemini 集成产品（Google AI Studio、第三方 IDE 插件等）而异，以当前客户端文档为准。

VS Code（GitHub Copilot）

安装支持 MCP 的 Copilot 扩展版本。
在 settings.json 或 MCP 配置文件中添加与 Cursor 相同的 mcpServers 块。
URL 使用 https://mcp.bazhuayu.com，Header 使用 x-api-key。

OpenClaw

OpenClaw 可作为 MCP 客户端连接八爪鱼（出站 MCP），命令形态因版本而异，典型流程：

确保 OpenClaw Gateway 已运行。
注册八爪鱼 MCP 服务（URL：https://mcp.bazhuayu.com，并配置 API Key）。
使用 openclaw mcp list 确认工具已加载。

QClaw 用户也可使用 QClaw 图形界面配置，无需命令行。

验证连接

连接成功后，服务端应公开以下 10 个工具。部分客户端会翻译显示名称，但工具标识应保持不变：

search_templates
search_tasks
execute_task
export_data
start_or_stop_task
redeem_coupon_code
search_platform_content
list_platforms
ecommerce_data_task
query_collected_reviews

建议先发送「列出数据中心当前支持的平台」进行只读联调。也可以搜索模板；不要用创建任务、启停任务或兑换优惠码来测试连接。如果仍只看到旧的 6 个工具，请刷新 MCP 工具列表、断开后重新连接，或重启客户端。服务支持 tools.listChanged，但客户端是否自动响应更新取决于其实现。

概述

快速入门