客户端配置指南

先选择连接方式

千问办公和 WorkBuddy 已经上架八爪鱼连接器，推荐直接在连接器市场搜索「八爪鱼」，通过 OAuth 完成授权：

千问办公

查看连接器搜索、授权和验证步骤。

WorkBuddy

查看连接、OAuth 授权及在对话中启用的方法。

如果客户端没有上架八爪鱼连接器，再按下方方式手动添加通用 HTTP MCP。

通用 MCP 服务地址

https://mcp.bazhuayu.com

手动添加时的认证方式：API Key（Header：Authorization: Bearer <API Key>）。API Key 创建见获取 API Key；不要省略 Bearer 前缀，也不要把 API Key 写成 OAuth 凭据或放入 x-api-key。

Agent 对话安装

QClaw、豆包专业版等能够自行管理工具配置的 Agent，可直接通过对话添加八爪鱼 MCP。推荐使用获取 API Key页面提供的完整提示词，让 Agent 写入 Authorization 请求头（值为 Bearer <API Key>）、刷新工具列表并完成连接测试。WorkBuddy 已有内置连接器时，优先使用上方 OAuth 接入。

对这类 Agent，应明确要求使用 API Key 时将请求头配置为 Authorization，值为 Bearer <API Key>。不支持自主配置的客户端，请继续按下方平台步骤手动操作。

ChatGPT

打开 ChatGPT → Settings → Connectors（或「连接器」）。
添加 MCP 连接器，URL 填写 https://mcp.bazhuayu.com 或 https://mcp.octoparse.com。
在自定义 Headers 中填写 Authorization 和 Bearer <你的 API Key>；若该入口不支持自定义 Header，请使用该产品支持 HTTP MCP Headers 的配置方式。
在新对话中启用该连接器后测试搜索模板。

Claude（桌面 / Web）

Settings → Connectors → Add connector。
输入 MCP URL：https://mcp.bazhuayu.com 或 https://mcp.octoparse.com。
在连接器的 Headers / API Key 配置中填写 Authorization，值使用 Bearer <你的 API Key>；若当前入口不能配置 Header，请改用该客户端的本地 MCP 配置方式。
在对话中确认已勾选八爪鱼 MCP 工具。

Claude Code

编辑 ~/.claude/settings.json：

{
  "mcpServers": {
    "octoparse": {
      "type": "http",
      "url": "https://mcp.bazhuayu.com",
      "headers": {
        "Authorization": "Bearer 你的APIKey"
      }
    }
  }
}

详见获取 API Key。

Cursor

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

{
  "mcpServers": {
    "octoparse": {
      "type": "http",
      "url": "https://mcp.bazhuayu.com",
      "headers": {
        "Authorization": "Bearer 你的APIKey"
      }
    }
  }
}

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

Gemini

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

在 Settings → MCP / Extensions / Connectors 中添加 HTTP MCP 服务。
URL：https://mcp.bazhuayu.com 或 https://mcp.octoparse.com。
在 Headers 中配置 Authorization: Bearer <你的 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 使用 Authorization: Bearer <你的 API Key>。

OpenClaw

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

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

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

验证连接

连接成功后，当前主入口应公开以下 12 个工具。部分客户端会翻译显示名称，但工具标识应保持不变：

search_templates
execute_task
get_task_status
export_data
search_tasks
start_or_stop_task
redeem_coupon_code
search_platform_content
list_platforms
ecommerce_data_task
describe_ecommerce_dataset
query_collected_reviews

建议先发送「列出数据中心当前支持的平台」进行只读联调。也可以搜索模板；不要用创建任务、启停任务或兑换优惠码来测试连接。如果工具列表不完整，请刷新 MCP 工具列表、断开后重新连接或重启客户端。实际可用工具以当前连接后的发现结果为准。

概述

快速入门