Curriculo ATS MCP 服务器文档

将您的 Curriculo ATS 连接到 Claude、Cursor 和任何与 MCP 兼容的 AI 客户端。Curriculo ATS MCP 服务器是一个远程托管的服务器，地址为 https://mcp.curriculo.me/mcp，无需安装。使用 OAuth 2.1 或个人访问令牌进行一次身份验证，客户端即可获得 25 种工具，实时读取和处理您的招聘数据。

来源: https://curriculo.me/docs/mcp/ (Curriculo ATS)

属性	值
端点	https://mcp.curriculo.me/mcp
传输	可流式传输 HTTP
身份验证	OAuth 2.1 + 个人访问令牌 (PAT)
范围	ats:read, ats:write
工具	25

Curriculo ATS MCP 服务器是一个远程托管服务器，无需在本地安装或运行。只需将任意 MCP 客户端指向端点，进行一次身份验证，客户端即可获得一组实时读取和处理您招聘数据的工具。

快速入门

在任何地方使用以下端点: https://mcp.curriculo.me/mcp

最快的路径是 Claude 的一键连接器流程：

打开 Claude，然后进入设置，接着选择连接器。
点击添加自定义连接器，粘贴上述服务器 URL。
当提示时完成 OAuth 登录。Claude 将连接到您的组织。
开始聊天并询问，例如，"我开放职位的每个阶段有何进展？"

新来的吗？请按照逐步教程：在 Claude 中运行您的 ATS。

连接客户端

服务器支持流式 HTTP，并支持交互式 OAuth 和通过 Authorization: Bearer 头部的个人访问令牌。

Claude

在 Claude（网页版或桌面版）中，进入设置、连接器、添加自定义连接器，然后输入：

https://mcp.curriculo.me/mcp

点击添加，完成 OAuth 登录，然后打开连接器以启用您希望 Claude 使用的特定工具。

Claude 代码

使用单条命令添加服务器（OAuth 在浏览器中通过 /mcp 打开）：

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp

或者直接通过头部传递个人访问令牌：

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp \
  --header "Authorization: Bearer YOUR_CURRICULO_PAT"

Cursor

打开 Cursor 设置，工具与 MCP，新的 MCP 服务器，并将此添加到 mcp.json：

{
  "mcpServers": {
    "curriculo": {
      "url": "https://mcp.curriculo.me/mcp"
    }
  }
}

VS Code / 其他

任何没有本地远程 MCP 支持的客户端都可以使用 mcp-remote 桥接：

{
  "mcpServers": {
    "curriculo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp"]
    }
  }
}

身份验证

有两种身份验证方式。两者都解析为具有作用域权限的单个组织中的用户。

OAuth 2.1（推荐）

交互式客户（Claude，Cursor）使用动态客户端注册的 OAuth。您登录到 Curriculo，批准连接，然后客户端会存储一个自动刷新短期令牌。

个人访问令牌 (PAT)

对于 CLI 或无头设置，在 ATS 中生成令牌并作为 Bearer 头部发送：

登录到 ats.curriculo.me。
转到设置，API 与集成，个人访问令牌。
创建一个令牌，选择其作用域，然后复制（仅显示一次）。
作为 Authorization: Bearer <token> 传递。

范围

ats:read: 列出和读取职位、申请者、收件箱、面试、分析。
ats:write: 创建和更改数据：移动阶段、发送电子邮件、安排面试、更新职位。

调用 whoami 工具以确认经过身份验证的用户、组织、身份验证方法和授予的范围。

工具参考（25 种工具）

读取工具不会更改数据。写入工具创建或修改记录，可能会触发电子邮件、日历事件或自动化。

职位（4）

list_jobs (读取): 列出您组织中的职位，最新更新优先。参数：状态、页面、限制。
get_job (读取): 通过 UUID 获取一个职位的完整详情，包括漏斗阶段和申请者数量。参数：jobId（必需）。
create_job (写入): 创建具有默认漏斗阶段的职位发布。仅标题是必需的；以草稿形式打开。参数：标题（必需）、描述、地点、类型、人数、必备技能、优选技能、薪资范围/最大值、薪资货币。
update_job_status (写入): 更改职位状态（DRAFT / OPEN / PAUSED / CLOSED / ARCHIVED）。参数：jobId、状态（两者必需）。

申请者（8）

list_applicants (读取): 列出申请者，可选择按职位进行过滤，带星标/拒绝/归档过滤器。参数：jobId、星标、拒绝、归档、页面、限制。
get_applicant (读取): 申请者完整详情：漏斗阶段、职位链接、笔记、活动历史。参数：applicantId（必需）。
search_candidates (读取): 对所有候选人进行语义搜索。参数：查询（必需）、jobId、时间戳、页面、限制。
move_applicant_stage (写入): 将申请者移动到另一个漏斗阶段。触发漏斗自动化。参数：applicantId、funnelId（必需）、原因。
add_applicant_note (写入): 向申请者添加备注。参数：applicantId、内容（必需）、noteType、decisionFlag、roundName。
get_applicant_resume_text (读取): 解析的简历文本和结构化数据。参数：applicantId（必需）。
get_applicant_evaluation (读取): AI 代理图评估：适合度评分、AI 标签、摘要、差距状态。参数：applicantId（必需）。
reprocess_resume (写入): 重新运行简历管道（解析 + 评估 + 图谱摄取）。参数：applicantId（必需）。

收件箱与电子邮件（5）

get_applicant_email_thread (读取): 申请者的完整电子邮件线程。参数：applicantId（必需）。
list_inbox_emails (读取): 列出组织收件箱中的邮件。参数：jobId、状态、搜索、页面、限制。
get_inbox_stats (读取): 收件箱统计摘要：未读计数和总数。参数：无。
reply_to_applicant_email (写入): 回复申请者，通过最新的入站邮件进行线程处理。需要连接的 Gmail。参数：applicantId、正文（必需）、主题。
send_bulk_email (写入): 向一个或多个申请者发送电子邮件。需要连接的 Gmail。参数：applicantIds、主题、消息正文（均为必需）。

面试（2）

list_interviews (读取): 列出面试。参数：jobId、applicantId、状态、类型、dateFrom、dateTo、页面、限制。
schedule_interview (写入): 安排面试，生成反馈链接，和（使用 Gmail）同步日历事件并通知所有人。参数：applicantId、jobId、标题、计划开始、计划结束（必需），此外还有类型、地点、会议提供商、参与者 ID、外部面试者、时区、说明。

分析（2）

get_analytics (读取): 组织分析概览：申请者总数、周期变化、按阶段划分的管道、热门职位、来源混合。默认为过去 30 天。参数：dateFrom、dateTo。
get_dashboard (读取): 收件箱加上每个职位的活跃申请者漏斗细分。参数：无。

自动化与导入（3）

list_job_automations (读取): 列出为职位配置的漏斗自动化。参数：jobId（必需）。
get_automation_executions (读取): 单个自动化的执行历史，分页面显示。参数：automationId（必需）、页面、限制。
get_import_batch (读取): 候选人导入批次的状态：进展、每个文件状态、错误。参数：batchId（必需）。

账户（1）

whoami (读取): 返回经过身份验证的用户、组织、身份验证方法和授予的范围。参数：无。

示例提示

"告诉我我开放职位的每个阶段的情况，并标记任何停滞不前的情况。"
"找出具有团队领导经验的高级 React 工程师并总结前五名。"
"将 Priya 移至第二次面试，并草拟回复询问她下周的可用性。"
"在星期四下午 2 点与此候选人安排 45 分钟的视频面试，并添加一个 Google Meet 链接。"
"申请者数量与上个月相比如何变化，哪个职位的转化率最高？"

写入工具具有实际的副作用（发送电子邮件、改变管道、关闭职位）。在您信任工作流之前，保持工具批准处于开启状态，并仅在您希望进行分析时授予 ats:read。

常见问题与故障排除

我需要安装或托管任何东西吗？

不。服务器完全托管在 https://mcp.curriculo.me/mcp。只需将您的客户端指向 URL 并进行身份验证。

支持哪些客户端？

任何支持流式 HTTP 的 MCP 客户端：Claude（网页/桌面）、Claude 代码、Cursor、VS Code 等。没有本地远程支持的客户端可以使用 mcp-remote 桥接。

我的工具显示“需要登录”或无法连接。

重新运行 OAuth 流程（在 Claude 代码中，键入 /mcp；在 Cursor 中，单击需要登录）。如果您使用 PAT，请确认头部完全是 Authorization: Bearer <token>，并且令牌没有被撤回或过期。

电子邮件或面试工具返回错误。

电子邮件和日历工具（reply_to_applicant_email，send_bulk_email，schedule_interview 的电子邮件部分）需要在组织中有一个活动的 Gmail 连接。请在 ATS 中连接 Gmail，然后重试。

如何限制 AI 能做什么？

颁发仅具有 ats:read 分析访问的令牌，并使用客户端的每个工具权限设置禁用特定的写入工具。

它作用于哪个组织？

与您的令牌关联的组织。随时调用 whoami 确认用户、组织和范围。

安全性

作用域访问。 每个令牌绑定到一个用户和组织，并带有明确的 ats:read / ats:write 范围。
最小权限。 授予完成工作的最小范围；对于分析，优先使用只读令牌。
随时撤销。 个人访问令牌可以在设置、API 与集成中撤销；OAuth 连接可以从客户端的连接器设置中删除。
传输安全性。 所有流量均通过流式 HTTP 的 HTTPS 传输。切勿将令牌粘贴到不受信任的客户端中或以明文形式共享。

规范 HTML 版本: https://curriculo.me/docs/mcp/