CATS MCP by usefulapi

CATS MCP 服务

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://cats-ats.usefulapi.io/mcp。
• Claude Code：claude mcp add --transport http cats-ats https://cats-ats.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code：添加到 VS Code。
• **Cursor 和其他客户端：**将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "cats-ats": {
      "url": "https://cats-ats.usefulapi.io/mcp"
    }
  }
}

只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 CATS 凭据。

分步设置说明、凭据查找位置和常见问题解答：https://usefulapi.io/cats-ats/

工具

工具	类型	功能
cats_get_site	读取	获取 CATS 站点
cats_list_users	读取	列出用户
cats_list_candidates	读取	列出候选人
cats_get_candidate	读取	获取候选人
cats_search_candidates	读取	搜索候选人
cats_filter_candidates	读取	筛选候选人
cats_list_candidate_pipelines	读取	列出候选人的招聘流程
cats_list_candidate_activities	读取	列出候选人的活动
cats_list_candidate_tasks	读取	列出候选人的任务
cats_list_candidate_attachments	读取	列出候选人的附件（元数据）
cats_list_jobs	读取	列出职位
cats_get_job	读取	获取职位
cats_search_jobs	读取	搜索职位
cats_list_job_pipelines	读取	列出职位的招聘流程
cats_list_job_statuses	读取	列出职位状态
cats_list_pipelines	读取	列出招聘流程
cats_get_pipeline	读取	获取招聘流程
cats_filter_pipelines	读取	筛选招聘流程
cats_get_pipeline_status_history	读取	获取招聘流程状态历史
cats_list_workflows	读取	列出招聘流程工作流
cats_list_workflow_statuses	读取	列出工作流状态
cats_list_companies	读取	列出公司
cats_get_company	读取	获取公司
cats_search_companies	读取	搜索公司
cats_list_contacts	读取	列出联系人
cats_get_contact	读取	获取联系人
cats_search_contacts	读取	搜索联系人
cats_list_tasks	读取	列出任务
cats_get_task	读取	获取任务
cats_list_activities	读取	列出活动
cats_add_candidate_activity	写入	为候选人添加活动（备注）
cats_create_task	写入	创建任务
cats_change_pipeline_status	写入	将候选人移至其他招聘流程状态
cats_create_candidate	写入	创建候选人
cats_usage_status	元数据	使用情况（免费套餐用量计数）
cats_request_feature	元数据	申请新增功能
cats_upgrade	元数据	升级到 Pro 或 Pro+
cats_cancel_subscription	元数据	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应在执行前征求确认）；meta 工具用于报告用量、管理订阅或提交功能请求。

定价

套餐	价格	限额
Free（每个已连接的 CATS 站点）	$0	每月 50 次工具调用
Pro（每个已连接的 CATS 站点）	$9/月 或 $90/年（免费 2 个月）	不限量*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 cats_upgrade 订阅（该工具会返回 Stripe Checkout 链接）。你可以随时使用 cats_cancel_subscription 取消：Pro 将持续至付费周期结束，当前周期不予退款；在此之前运行 cats_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。

许可证

MIT

访问、个人数据与限制

在 CATS 的 Administration → API Keys 中创建 v3 API 密钥。旧版 Transaction Codes 无法使用。生成表单不提供只读范围选择器。仅授权 UsefulAPI 和你选择的 AI 客户端处理你有权分享的数据。CATS 账户资格与供应商收费独立于 UsefulAPI 套餐。此独立连接器不声称获得供应商批准或认可。

候选人/联系人记录包含个人信息。请勿将此工作流用于政府颁发的身份证件、健康数据、个人财务信息或其他 CATS Prohibited Data。已知的凭据及敏感财务/健康字段和 HAL 链接块会经过过滤；客户仍须检查自由文本和自定义字段。工具结果会传送至你选择的 AI 客户端和大模型提供商，其隐私和数据保留政策同样适用。在 CATS 中撤销 API 密钥即可停止供应商访问；断开 UsefulAPI 即可终止此连接。

CATS 说明其 API 请求限制为滚动 500 次/小时；但未明确计数范围。集合页面默认返回 25 条，最多 100 条。身份验证上限为 10 秒/64 KiB；操作回复上限为 30 秒/8 MiB。计费依据已验证的 CATS 站点 ID，因此在同一站点内轮换密钥不会改变账户身份。

变更与自动化

以下四种写入操作都要求 confirm:true：创建候选人、记录候选人活动、创建任务或更改流程状态。分配的任务可能会通知用户。活动备注不会发出电子邮件/SMS 发送请求，即使其活动类型为 email 或 text_message 也是如此。独立配置的账户自动化和 Webhook 仍可能响应变更。

流程状态变更会读取工作流/状态元数据，明确请求抑制返回的所有触发器（fire:false），并发送 create_activity=false。若状态已是当前状态，则不会执行写入。预检读取并非原子锁，因此仍可能发生并发变更；独立 Webhook 不会被抑制。不会提供电子邮件发送、删除、附件下载、批量导出端点或 Webhook 管理工具。

不会自动重放任何供应商请求。创建操作必须返回文档规定的 201，且 Location 记录 ID 必须匹配；确认不一致或不确定时会报错。重试写入前，请先检查 CATS。仅日期任务/活动日期会以 UTC 午夜发送。

验证

已根据当前 API 参考和本地模拟，对 34 个供应商工具进行了检查。通过实际的自有试用读取验证了账户身份和 HAL 响应结构，其中包括供应商提供的示例记录。未测试真实客户招聘记录或业务写入。当前条款允许客户指定第三方软件，且供应商发布了外部 API 密钥设置指南；这并不表示 CATS 审核过 UsefulAPI。

参考：API v3、条款、外部密钥设置。