跳到内容

Curriculo ATS MCP 服务器

本页内容

将您的 Curriculo ATS 连接到 Claude、Cursor 和任何支持 Streamable HTTP 的 MCP 客户端,或者通过自定义 GPT 连接到 ChatGPT。用简单的语言请求审核候选人、移动流程、回复申请者、安排面试和提取分析。您的 AI 客户端直接在您的 ATS 中完成工作。

端点传输认证范围工具
https://mcp.curriculo.me/mcpStreamable HTTPOAuth 2.1 或个人访问令牌ats:read, ats:write25

服务器是远程托管的,因此无需本地安装或运行。将任何 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 的连接器流程:

  1. 打开 Claude,然后 自定义,接着 连接器.
  2. 点击 添加自定义连接器 并粘贴上面的服务器 URL。
  3. 完成 OAuth 登录 当被提示时。Claude 连接到您的组织。
  4. 开始聊天并问,例如:"我未填补的职位各个阶段有什么?"

[!提示] 新来的吗?按步骤跟随 教程:在 Claude中运行您的 ATS,该教程介绍如何连接、根据 AI 的匹配评分候选人,以及从聊天中安排面试。

连接客户端

任何支持 Streamable HTTP 的客户端都可以。使用 OAuth 2.1 进行身份验证,或发送包含在 Authorization: Bearer 标头中的个人访问令牌。常用客户端的设置如下。

Claude

在 Claude(网页或桌面),前往 自定义,连接器,添加自定义连接器,然后输入:

https://mcp.curriculo.me/mcp

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

Claude 聊天构建器打开到连接器;Curriculo ATS 在连接器中列出,带有添加连接器。
在 Claude 中添加 Curriculo 连接器:自定义 → 连接器 → 添加自定义连接器。

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 接口。

  1. 在 ChatGPT 中,创建一个 GPT 并打开 配置,然后 操作,接着 创建新操作.

  2. 从此 URL 导入架构:

    https://mcp.curriculo.me/api/v2/mcp/openapi.json
  3. 将 认证 设置为 OAuth,使用来自 https://mcp.curriculo.me/api/v2/ats/oauth/register 的客户端 ID 和密钥,以及架构中的这些值:

    设置值
    授权 URLhttps://mcp.curriculo.me/api/v2/ats/oauth/authorize
    令牌 URLhttps://mcp.curriculo.me/api/v2/ats/oauth/token
    范围ats:read ats:write
  4. 保存,然后登录到 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 中生成令牌并作为验证头发送:

  1. 在 ats.curriculo.me 登录.
  2. 前往 设置,开发者,个人访问令牌.
  3. 创建一个令牌,选择其过期时间,并复制它。它只显示一次。
  4. 将其作为 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 链接。"
  • "申请者数量与上个月相比如何变化,哪个职位转化效果最好?"
Claude 回复招聘分析:5 个空缺职位,153 名申请者按阶段分类
询问pipeline数量;客户调用你 ATS 上的分析工具。
Claude 总结十位高级前端申请者的解析角色和经验
在深入简历之前,先总结今天的申请者。
Claude 确认两位候选人进入筛选阶段,并展示一封筛选邀请邮件草案
将候选人移至筛选并草拟邀请 - 仅在确认地址后发送。面试安排需要连接的 Google 或 Microsoft 日历。
Claude 提出基于一位候选人简历项目的三个筛选问题
从已经在 ATS 中的简历生成筛选问题。

写入工具有实际副作用:发送电子邮件、改变管道、关闭职位。保持工具审批开通,直到你信任工作流程。

安全性

  • 范围访问。 每个令牌绑定到一个用户和组织。助手看到的一切仅限于你自己的组织。
  • 最小特权。 范围尚未强制执行;在客户的工具设置中关闭写入工具以进行分析。
  • 随时撤回。 个人访问令牌可以在 设置中撤回,开发者. OAuth 连接可以从客户的连接器设置中移除。
  • 传输安全性。 所有流量都是通过 Streamable HTTP 的 HTTPS。绝不要将令牌粘贴到不可信的客户端或以明文方式分享。

部分的 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 确认用户、组织和范围。

此页面对您有帮助吗?

更新于