Curriculo ATS MCP 服务器
将您的 Curriculo ATS 连接到 Claude、Cursor 和任何支持 Streamable HTTP 的 MCP 客户端,或者通过自定义 GPT 连接到 ChatGPT。用简单的语言请求审核候选人、移动流程、回复申请者、安排面试和提取分析。您的 AI 客户端直接在您的 ATS 中完成工作。
| 端点 | 传输 | 认证 | 范围 | 工具 |
|---|---|---|---|---|
https://mcp.curriculo.me/mcp | Streamable HTTP | OAuth 2.1 或个人访问令牌 | ats:read, ats:write | 25 |
服务器是远程托管的,因此无需本地安装或运行。将任何 MCP 客户端指向该端点,进行一次身份验证后,客户端将获得读取和实时处理您招聘数据的工具。
[!警告] 与公共 API 不同的产品,具有不同的认证。 MCP 与 Curriculo ATS 对接,用户登录。公共 API
key_无法访问这些工具,公共 API 不会接触到您的 ATS。
什么是 Curriculo ATS MCP 服务器?
Curriculo ATS MCP 服务器是一个托管的端点, https://mcp.curriculo.me/mcp,允许 Claude、ChatGPT、Cursor 和其他 MCP 客户端读取和处理您的 Curriculo ATS。您使用 OAuth 或个人访问令牌登录一次,然后用简单的语言要求审核候选人、移动阶段、回复申请者或安排面试。
快速入门
在每个 MCP 客户端中使用此端点:
https://mcp.curriculo.me/mcp最快的路径是 Claude 的连接器流程:
- 打开 Claude,然后 自定义,接着 连接器.
- 点击 添加自定义连接器 并粘贴上面的服务器 URL。
- 完成 OAuth 登录 当被提示时。Claude 连接到您的组织。
- 开始聊天并问,例如:"我未填补的职位各个阶段有什么?"
[!提示] 新来的吗?按步骤跟随 教程:在 Claude中运行您的 ATS,该教程介绍如何连接、根据 AI 的匹配评分候选人,以及从聊天中安排面试。
连接客户端
任何支持 Streamable HTTP 的客户端都可以。使用 OAuth 2.1 进行身份验证,或发送包含在 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"在 Claude 代码中运行 /mcp 以检查状态或触发 OAuth 登录。
光标
在光标侧边栏中打开 自定义 并添加此内容到 mcp.json:
{
"mcpServers": {
"curriculo": {
"url": "https://mcp.curriculo.me/mcp"
}
}
}光标显示 需要登录。单击它以运行 OAuth 同意流程,工具变为绿色。
VS Code 和其他客户端
任何没有本地远程 MCP 支持的客户端都可以使用 mcp-remote 桥接:
{
"mcpServers": {
"curriculo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp"]
}
}
}要无头身份验证,附加一个标头参数:
"args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp",
"--header", "Authorization: Bearer YOUR_CURRICULO_PAT"]ChatGPT(自定义 GPT 操作)
ChatGPT 通过与操作结合的自定义 GPT 进行连接,使用一个与 25 个 MCP 工具相对应的 REST 接口。
在 ChatGPT 中,创建一个 GPT 并打开 配置,然后 操作,接着 创建新操作.
从此 URL 导入架构:
https://mcp.curriculo.me/api/v2/mcp/openapi.json将 认证 设置为 OAuth,使用来自
https://mcp.curriculo.me/api/v2/ats/oauth/register的客户端 ID 和密钥,以及架构中的这些值:设置 值 授权 URL https://mcp.curriculo.me/api/v2/ats/oauth/authorize令牌 URL https://mcp.curriculo.me/api/v2/ats/oauth/token范围 ats:read ats:write保存,然后登录到 Curriculo ATS,并在 GPT 首次调用操作时批准访问。
认证
有两种方式进行认证,两者都解析为一个组织中的用户。
OAuth 2.1(推荐)
交互式客户端(Claude、Cursor、ChatGPT)使用带有授权码流的 OAuth 2.1。支持动态客户端注册,公共客户端需要 PKCE(S256),重定向 URI 必须为 https。您登录到 Curriculo ATS,批准连接,客户端存储一个短期令牌并自动刷新。使用 Claude 和 Cursor 时,无需复制或手动旋转密钥。服务器元数据发布在 https://mcp.curriculo.me/.well-known/oauth-authorization-server.
个人访问令牌
对于 CLI 或无头设置,在 ATS 中生成令牌并作为验证头发送:
- 在 ats.curriculo.me 登录.
- 前往 设置,开发者,个人访问令牌.
- 创建一个令牌,选择其过期时间,并复制它。它只显示一次。
- 将其作为
Authorization: Bearer <token>,按照上面的设置步骤所示。
范围
令牌携带一个或两个范围。
| 范围 | 允许 |
|---|---|
ats:read | 列出并阅读职位、申请者、收件箱、面试和分析(尚未强制执行:任何令牌均可使用每个工具)。 |
ats:write | 创建和更改数据:移动阶段、发送电子邮件、安排面试、更新职位。 |
[!提示] 不确定某个令牌的作用?调用
whoami工具。它返回经过身份验证的用户、组织、身份验证方法和授予的范围。
工具参考
二十五个工具。访问类型告诉你风险:
- 仅读取 看起来。
- 写入 更改 ATS 数据。
- 写入+ 更改数据并触及外部:电子邮件发出、邀请被发送或 AI 职位开始。
二十五个工具中有十七个是只读的。七个写入+ 工具具有外部后果;助理是否在使用它们之前确认意图取决于你的客户端。没有工具会删除记录,但 reprocess_resume 会覆盖存储的 AI 评估。
职位
| 工具 | 访问 | 功能 | 参数 |
|---|---|---|---|
list_jobs | 读取 | 按您组织中的最新职位列出。可选状态过滤器。 | status, page, limit |
get_job | 读取 | 获取一个职位的详细信息,包括其漏斗阶段和申请者数量。 | jobId (必填) |
create_job | 写入+ | 创建一个职位并立即开放:它是实时的并且接受申请,而不是草稿。默认阶段为潜在客户 + 申请、筛选、面试、报价。仅需要一个标题。 | title (必填), description, location, locations, location_ack_required, type, work_mode, headcount, must_have_skills, preferred_skills, salary_min, salary_max, salary_currency, salary_period, salary_public, ask_salary, experience_min, experience_max, experience_public, ask_experience |
update_job_status | 写+ | 更改工作的状态(草稿、开放、暂停、关闭、归档)。它不会向候选人发送电子邮件。请慎重使用。 | jobId, status (两个必填) |
申请者
| 工具 | 访问 | 它的功能 | 参数 |
|---|---|---|---|
list_applicants | 读取 | 列出申请者,选项可针对一个工作职位,包括标记、拒绝和归档过滤器。 | jobId, starred, rejected, archived, page, limit |
get_applicant | 读取 | 一个申请者的完整信息:当前阶段、职位链接、备注和活动历史。 | applicantId (必填) |
search_candidates | 读取 | 对您活跃的候选人进行通俗语言搜索。返回带有匹配技能和每个技能及事实和推理的排名匹配项。 | query (必填), jobId, timestamp, page, limit |
move_applicant_stage | 写+ | 将某人移动到另一个阶段。触发该阶段的自动化;达到录用人数时,可能会自动关闭该职位。 | applicantId, funnelId (必填), reason |
add_applicant_note | 写 | 添加备注,选项可标记为通过或失败决定及其所属的轮次。默认私密。 | applicantId, content (必填), noteType, decisionFlag, roundName |
get_applicant_resume_text | 读取 | 解析后的简历内容,包括文本和字段,不附带文件。 | applicantId (必填) |
get_applicant_evaluation | 阅读 | AI评估:适合度分数、标签、摘要和差距状态。 | applicantId (必填) |
reprocess_resume | 写+ | 在CV上重新运行AI管道(评估、索引;仅在尚未解析的情况下进行解析)。在后台运行。 | applicantId (必填) |
收件箱和电子邮件
| 工具 | 访问 | 它的功能 | 参数 |
|---|---|---|---|
get_applicant_email_thread | 阅读 | 与一个候选人的完整对话,双向。 | applicantId (必填) |
list_inbox_emails | 阅读 | 列出入站邮件,按职位、状态或文本搜索筛选。 | jobId, status, search, page, limit |
get_inbox_stats | 阅读 | 处理计数和总数。 | 无 |
reply_to_applicant_email | 写+ | 从Curriculo的发送邮箱或您的组织的收件箱(接收到的对话)中回复现有线程。无需邮箱连接。 | applicantId, body (必填), subject |
send_bulk_email | 写+ | 从Curriculo的发送邮箱发送一条消息给一个或多个候选人,用于外联或状态更新。不需要邮箱连接。 | applicantIds, subject, messageBody (所有必需) |
面试
| 工具 | 访问 | 它的功能 | 参数 |
|---|---|---|---|
list_interviews | 读取 | 按职位、申请人、状态、类型或日期范围列出面试。 | jobId, applicantId, status, type, dateFrom, dateTo, page, limit |
schedule_interview | 写+ | 预定面试,添加面试官并创建反馈链接。连接日历时,它还会创建事件,邀请候选人并生成视频链接:通过Google日历的Google Meet,通过Microsoft日历的Microsoft Teams。 meetingProvider: ZOOM 生成不带Zoom链接的面试,无论如何都会保存面试。 | applicantId, jobId, title, scheduledStart, scheduledEnd (必需), type, location, meetingProvider, participantIds, externalInterviewers, timezone, instructions |
分析
| 工具 | 访问 | 它的功能 | 参数 |
|---|---|---|---|
get_analytics | 读取 | 总数、阶段细 breakdown、热门职位和来源组合(所有时间),加上默认按月的日期范围内的逐期变化。 | dateFrom, dateTo |
get_dashboard | 读取 | 收件箱加上每个职位的漏斗细 breakdown,显示当前活动的所有人。 | 无 |
自动化和导入
| 工具 | 访问 | 它的功能 | 参数 |
|---|---|---|---|
list_job_automations | 阅读 | 列出在工作中配置的自动化:电子邮件、面试安排、标签和通知。 | jobId (必需) |
get_automation_executions | 阅读 | 自动化的运行历史。 | automationId (必需), page, limit |
get_import_batch | 阅读 | 候选人导入的进度:计数和任何错误。 | batchId (必需) |
账户
| 工具 | 访问 | 它的功能 | 参数 |
|---|---|---|---|
whoami | 阅读 | 确认助手作为哪个用户和组织工作,以及身份验证方法和授予的范围。在任何会话中值得首先运行。 | 无 |
电子邮件工具从Curriculo的发送邮箱发送,因此它们可以在没有连接邮箱的情况下工作。面试安排也可以在没有日历的情况下工作:它仍然保存面试,但视频面试没有会议链接,邀请也不会发送。
示例提示
连接后,用简单的语言提问。客户选择正确的工具。
- "告诉我我所有开放职位每个阶段的情况,并标记任何停滞不前的内容。"
- "寻找具有团队领导经验的高级 React 工程师,并总结前五名。"
- "将 Priya 迁移到第二轮面试,并草拟回复询问她下周的可用时间。"
- "安排与这位候选人的 45 分钟视频面试,时间定在周四下午 2 点 ET,并添加 Google Meet 链接。"
- "申请者数量与上个月相比如何变化,哪个职位转化效果最好?"




写入工具有实际副作用:发送电子邮件、改变管道、关闭职位。保持工具审批开通,直到你信任工作流程。
安全性
- 范围访问。 每个令牌绑定到一个用户和组织。助手看到的一切仅限于你自己的组织。
- 最小特权。 范围尚未强制执行;在客户的工具设置中关闭写入工具以进行分析。
- 随时撤回。 个人访问令牌可以在 设置中撤回,开发者. OAuth 连接可以从客户的连接器设置中移除。
- 传输安全性。 所有流量都是通过 Streamable HTTP 的 HTTPS。绝不要将令牌粘贴到不可信的客户端或以明文方式分享。
部分的 Curriculo ATS MCP 中心,链接设置指南、工具参考和连接器文档。
接下来的步骤
- 通过 MCP的 Slack 进行联络:使用这些来自 Slack 的工具。
- 电子邮件代理设置指南:连接你的招聘邮箱和日历。
- Curriculo ATS MCP 中心:设置指南和连接器文档。
常见问题和故障排除
我需要安装或托管任何东西吗?
不。该服务器完全托管在 https://mcp.curriculo.me/mcp。将您的客户端指向该 URL 并进行身份验证。
哪些客户支持?
任何支持通过 Streamable HTTP 远程服务器的 MCP 客户端,使用 OAuth 2.1 或个人访问令牌:Claude(网页和桌面)、Claude Code、Cursor、VS Code 等。没有原生远程支持的客户端可以使用 mcp-remote 桥接。ChatGPT 通过具有操作的自定义 GPT 连接。
我的工具显示需要登录或无法连接。
重新运行 OAuth 流程(在 Claude Code 中,输入 /mcp;在 Cursor 中,点击 需要登录)。如果您使用个人访问令牌,请确认头部完全是 Authorization: Bearer <token> 并且该令牌未被撤销或过期。
电子邮件工具需要连接的邮箱吗?
不。send_bulk_email 和 reply_to_applicant_email 是从 Curriculo 的发送邮箱发出的。当该邮箱收到对话时,回复将从您组织的邮箱发出。要从您自己的地址发送,通常请参阅电子邮件代理设置指南。
schedule_interview 创建 Zoom 链接吗?
不。视频链接来自连接的日历:与 Google 的 Google Meet,与 Microsoft 的 Microsoft Teams。没有日历,面试将保存而没有链接。
我如何限制 AI 的功能?
使用您客户端的每个工具权限设置来禁用特定的写入工具。
它针对哪个组织?
与您的令牌相关联的一个。随时调用 whoami 确认用户、组织和范围。
更新于