Whalesync MCP Server

什么是 Whalesync MCP Server？

Whalesync MCP Server 是 Whalesync 官方的远程 MCP 端点，让 Claude、ChatGPT、Cursor 和 VS Code 中的 AI 代理代你创建、配置和监控 Whalesync 同步与 Live Export，使用浏览器登录而不是 API 密钥。

Whalesync 在 Airtable、Notion、Webflow、HubSpot、Salesforce、Google Sheets、Postgres、Supabase 等工具之间保持数据同步。设置同步需要选择数据表、映射字段并留意问题。有了 MCP 服务器，你可以描述想要的同步（“让我的 Airtable 产品表与 Webflow CMS 保持同步”），由代理构建草稿，而仍由人在 Whalesync 应用中批准。该服务器使用与 Whalesync REST API 相同的资源、ID 和错误码。

如何使用 Whalesync MCP Server？

你需要一个 Whalesync 账号。客户端只需要服务器地址：

https://api.whalesync.com/mcp

配置中没有任何密钥。代理第一次调用服务器时，浏览器会打开 Whalesync 的授权页面：登录、查看所请求的权限并点击 Connect。

Claude Code

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

首次使用时会打开浏览器登录（也可以通过 /mcp 发起）。

Claude Desktop 和 claude.ai

Whalesync 已收录在 Claude 连接器目录中：在 Settings > Connectors > Browse connectors 中找到它并点击 Connect。如果你的组织限制目录连接器，可以使用 URL https://api.whalesync.com/mcp 添加自定义连接器。Claude 会在首次使用时打开 Whalesync 登录页。

Cursor

将以下内容添加到 ~/.cursor/mcp.json，或项目中的 .cursor/mcp.json：

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

VS Code

Whalesync 文档给出的命令：

code --add-mcp '{"name":"whalesync","type":"http","url":"https://api.whalesync.com/mcp"}'

也可以在 .vscode/mcp.json 中用 "type": "http" 和该 URL 添加同一服务器。

ChatGPT、Codex 和 Grok

Whalesync 也已上架 ChatGPT 应用目录，其文档还介绍了 Codex（codex mcp add whalesync --url https://api.whalesync.com/mcp，然后 codex mcp login whalesync）和 Grok 自定义连接器的配置。

Whalesync MCP Server 的主要功能

• 由 Whalesync 官方托管，无需安装。
• 通过浏览器 OAuth 授权，无需 API 密钥；你可以授予比客户端请求更弱的权限范围，但不能更强。
• 三种权限范围：read（查看同步、映射、状态、操作记录、问题和记录）、operate（增加暂停、激活、重试和 Live Export 运行）和 readwrite（增加创建、编辑和删除同步、映射与 Live Export）。
• 同步工具以 sync_ 开头（例如 sync_list、sync_create、sync_get_status），Live Export 工具以 live_export_ 开头。
• sync_whats_next 和 live_export_whats_next 告诉代理当前设置进度以及下一步该做什么。
• 人工介入步骤：连接 OAuth 应用、批准新建或编辑过的同步、批准被暂扣的删除，始终在浏览器中完成。
• 已连接的代理列在 Settings > MCP 中，可在那里撤销。

Whalesync MCP Server 的使用场景

• 根据描述构建同步：“在我的 Airtable Products 表和 Webflow Products 集合之间创建双向同步，并映射对应字段。”
• 监控健康状况：“我的同步有失败的吗？列出未解决的问题及其原因。”
• 修复与重试：在 operate 权限下，让代理重试问题，或在你修复字段时暂停同步。
• 记录核查：“这条记录的同步状态如何？删除审核队列里有待处理的内容吗？”
• Live Export：让代理设置 Live Export、选择源数据表、设定计划并触发运行。

Whalesync MCP Server 常见问题排查

• 401 或授权过期：从客户端重新连接。如果该连接已不在 Settings > MCP 中，说明它已被撤销，重新连接会再次走授权流程。
• 授权页显示“Connection request has expired”：距离客户端发起连接已超过十分钟。请从客户端重试。
• 同步无法启动：新建和编辑过的同步必须由人在 Whalesync 应用中审核并批准。代理会把审核链接发给你。
• 代理无法修改任何内容：检查你授予的权限范围。read 连接只能查看；如需编辑，请重新连接并授予 readwrite。
• 速率限制：每个用户每分钟最多 120 个请求。