如何通过 MCP 将 Clay 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Clay、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Clay + Cursor

在任意 AI 智能体中使用 Clay 的 GTM 数据：搜索 Clay 的人物和公司数据库，对最多 100 个条目运行 Clay 托管或自定义的数据丰富函数，在 Enterprise 套餐中查询 Clay 表格，搜索 Workflow 运行记录并查看积分余额。使用个人 Clay API 密钥；隐私删除在安装时关闭。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

CLAY_API_KEY

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个 Clay 账户。

1. 在 Clay 中打开 API and CLI 的 API keys 标签页（https://app.clay.com/workspaces/~/api-and-cli?tab=api-keys），创建一个密钥。该密钥以你的用户身份、按你的工作区权限执行操作。
2. 把它粘贴到 CLAY_API_KEY。它通过 clay-api-key 请求头发送。
3. 使用自定义函数时，在 Clay 中打开该函数，进入 Details，启用 API 访问，并复制它的 t_... id。
4. 安装连接器并运行 clay_get_me：它返回你的用户和工作区，并确认密钥可用。clay_get_credit_balance 显示剩余积分；读取余额不消耗积分。

搜索人物和公司数据库：

1. 每个会话调用一次 clay_get_search_query_reference，获取可查询的人物和公司字段、运算符和语法。
2. clay_create_search 用以 select from people 或 select from companies 开头的查询启动搜索，例如 select from companies where people.exists(is_current = true and job_title is_similar_to ("VP Sales"))，并返回 search_id。不支持计数查询和职位搜索。
3. 用该 id 调用 clay_get_search_results 是一个有状态的迭代器：每次调用返回下一页，只要 has_more 为 true，AI 就继续调用。人物结果包含姓名、所在地和匹配的工作经历；公司结果包含域名、行业、规模、营收和 LinkedIn URL。

搜索结果计入你套餐的结果上限：免费套餐每次搜索 50 条、每 30 天 100 条；付费套餐每次请求 500 条。超出上限时 Clay 返回 402 并指明是哪项上限。

用函数丰富数据：

1. clay_run_routine 对 1 到 100 个条目运行 Clay 托管函数或已开启 API 访问的自定义函数：传入例程 id（function:t_...）和形如 {"id": "row-1", "inputs": {"domain": "clay.com"}} 的条目。id（最多 64 个字符）由你自定，会随结果一起返回。webhook_id 可在运行结束时通知已注册的 Clay Webhook。运行会消耗 Clay 积分，所以 AI 在启动前会告诉你要运行哪个函数、处理多少条目。
2. 用 routine_run_id 调用 clay_get_run_results：运行中返回 HTTP 202 和 status: in_progress，结束后返回 200、status: complete 和 data。结果按 id 而不是按顺序与输入对应；已完成的运行也可能包含失败的条目，finished 也计入失败的条目。AI 每隔几秒查询一次，而不是密集循环。
3. clay_get_batch_run_results 跟踪从 Clay CLI 或 API 启动的批量运行；批量运行完成后返回结果文件的 result_url。

表格（Enterprise 套餐）：clay_query_tables 读取已知表格的行，支持选择字段、筛选、排序、分组和关联；表格 id 在表格的 URL 中（.../tables/t_...）。每个单元格都带有 status：success（附 value）、empty、error（附 error），或等待中的状态（running、queued、retry、rate_limited、awaiting_callback）。扫描过程中发生变化的行可能被返回两次，所以 AI 会按 id 去重。

Workflow（测试版）：clay_get_runs_query_reference 提供运行查询的语法，然后 clay_query_workflow_runs 查找运行记录（select 查询按从新到旧返回运行记录，count 查询返回数量）。查询最多 2000 个字符；数据可能有几秒延迟。

安装时关闭：clay_privacy_delete_people 根据隐私请求（例如 GDPR 删除请求）从 Clay Audiences 中删除人物，按邮箱、LinkedIn slug（/in/ 后面的部分，而不是 URL）或电话匹配，每次调用 1 到 100 个标识。该操作无法撤销，因此由工作区管理员在需要时开启；开启后先用 dry_run: true 统计匹配人数，再用 clay_get_privacy_deletion_status 跟踪任务，任务结束后最多五天内都可查询状态。

分页：集合在还有后续页面时返回 data 和 cursor，AI 会把游标传回。表格查询默认每页 50 行（最多 100），运行结果默认 20 条（最多 100），搜索页面默认 20 条（付费套餐最多 500，免费和试用套餐最多 50）。

常见错误：错误都带有 message。401 或 403 表示密钥错误或无访问权限，402 表示达到搜索结果上限，404 表示 id 未知或函数未开启 API 访问，409 或 422 表示请求状态或输入无效。429 是工作区的速率限制：等待 Retry-After 中的秒数后再试。

不能做的事：Clay Public API 没有列出表格或函数、创建表格或写入行的端点。行仍然通过表格的入站 Webhook 写入，函数和表格的 id 需要从 Clay 应用中复制。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Clay 的工具。

可用工具

示例提示

• “我们还剩多少 Clay 积分？”
• “找出德国员工 50 到 200 人的软件公司中的销售副总裁，给我看前 20 位。”
• “对这五个域名运行我们的公司数据丰富函数 function:t_abc123，运行完成后给我看结果。”
• “从表格 t_0te9i4tZEHwc9hihBXu 中列出已填写域名的公司，按域名排序。”
• “过去 24 小时内我们有哪些 Clay Workflow 运行失败了？”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot