Curriculo ATS MCP 服务器

On this page

快速入门
连接客户
身份验证
工具参考
示例提示
FAQ 和故障排除
安全

将您的 Curriculo ATS 连接到 Claude、Cursor 和任何支持流式 HTTP 的 MCP 客户端，或通过自定义 GPT 连接到 ChatGPT。使用简单语言来审查候选人、移动流程、回复申请人、安排面试和拉取分析数据。您的 AI 客户端直接在您的 ATS 中执行工作。

端点	运输	身份验证	范围	工具
`https://mcp.curriculo.me/mcp`	流式 HTTP	OAuth 2.1 或个人访问令牌	`ats:read`, `ats:write`	25

服务器是远程托管的，因此无需安装或在本地运行。将任何 MCP 客户端指向端点，进行一次身份验证，客户端即可获得读取和实时操作招聘数据的工具。

与公共API不同的产品，具有不同的身份验证。 MCP与Curriculo ATS进行通信，用户签名。公共API key_ 无法访问这些工具，公共API也无法访问您的ATS。

快速入门

在所有地方使用此端点：

https://mcp.curriculo.me/mcp

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

打开 Claude，然后设置，然后 连接器.
点击 添加自定义连接器 ，并粘贴上述服务器URL。
完成 OAuth 签名 流程，当提示时。Claude 连接到您的组织。
开始聊天，询问例如“我的开放职位的每个阶段都有什么？”

新手？按照一步一步的教程：在 Claude中运行您的 ATS，带有截图，指导连接、按 AI 适合度对候选人进行排名，并从聊天中安排面试。

连接客户

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

克劳德

在克劳德（网页或桌面版）中，前往设置，连接器，添加自定义连接器，然后输入：

https://mcp.curriculo.me/mcp

点击添加，完成 OAuth 登录，然后打开连接器以启用您想要克劳德使用的特定工具。

克劳德代码

使用单个命令添加服务器。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"

在克劳德代码中运行 /mcp 以检查状态或触发 OAuth 登录。

光标

打开 光标设置，工具与 MCP，新 MCP 服务器 并将其添加到 mcp.json:

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

光标显示 需要登录。点击它以运行 OAuth 同意流程，工具将变成绿色。

VS 代码和其他客户端

任何没有原生远程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与操作连接，使用一个REST界面来镜像25个MCP工具。

在ChatGPT中，创建一个GPT并打开配置，然后操作，然后 创建新操作.

从这个URL导入模式:

https://mcp.curriculo.me/api/v2/mcp/openapi.json

将 身份验证 设置为 OAuth，使用模式中的这些值:

设置值
授权URL https://mcp.curriculo.me/api/v2/ats/oauth/authorize
令牌URL https://mcp.curriculo.me/api/v2/ats/oauth/token
范围 ats:read ats:write (或仅 ats:read)
保存，然后登录到Curriculo并在GPT首次调用操作时批准访问。

设置	值
授权URL	`https://mcp.curriculo.me/api/v2/ats/oauth/authorize`
令牌URL	`https://mcp.curriculo.me/api/v2/ats/oauth/token`
范围	`ats:read ats:write` (或仅 `ats:read`)

身份验证

两种身份验证方式。两者都解析为一个组织中的用户，具有范围权限。

OAuth 2.1（推荐）

交互式客户端（Claude、Cursor、ChatGPT）使用OAuth 2.1的授权码流。支持动态客户端注册，PKCE（S256）是公共客户端所必需的，重定向URI必须是https。您登录到Curriculo，批准连接，客户端存储一个短期令牌，它会自动刷新。没有需要手动复制或轮换的密钥。服务器元数据在 https://mcp.curriculo.me/.well-known/oauth-authorization-server.

个人访问令牌

对于CLI或无头设置，生成一个令牌在ATS并将其作为bearer头发送：

在 ats.curriculo.me登录.
前往设置，API & 集成，个人访问令牌.
创建令牌，选择其范围，并复制它。它只显示一次。
将其作为 Authorization: Bearer <token>传递，如上述设置步骤中所示。

范围

令牌携带一种或两种范围。仅授予所需的权限。

范围	允许
`ats:read`	列出并读取职位、申请人、收件箱、面试和分析。
`ats:write`	创建和修改数据：移动阶段、发送邮件、安排面试、更新职位。

不确定令牌代表谁？调用 whoami 工具。它返回已认证的用户、组织、认证方式和授予的范围。

工具参考

二十五个工具。访问类型指示风险：

读取仅查看。
写入更改 ATS 数据。
编写+ 会修改数据并产生外部影响：发送电子邮件、发出邀请或启动 AI 作业。

二十五个工具中有十七个是只读的。六个编写+ 工具具有外部后果，助手在使用它们之前会确认意图。没有工具会删除任何内容。

作业

工具	访问	其功能	参数
`list_jobs`	读取	列出您组织中的作业，按最近更新时间排序。可选状态筛选。	`status`, `page`, `limit`
`get_job`	读取	显示一个作业的详细信息，包括其漏斗阶段和申请人数。	`jobId` (必需)
`create_job`	编写	创建一个职位并立即打开：它是活跃的并接受申请，而不是草稿。默认阶段是线索 + 申请、筛选、面试、录用。只需要一个标题。	`title` (必需)， `description`, `location`, `type`, `headcount`, `must_have_skills`, `preferred_skills`, `salary_min`, `salary_max`, `salary_currency`
`update_job_status`	编写+	更改职位的状态（DRAFT、OPEN、PAUSED、CLOSED、ARCHIVED）。关闭或暂停可以在候选人通知启用时向尚未达到录用阶段的候选人发送电子邮件；未订阅和直播面试的申请人将被跳过。请谨慎使用。	`jobId`, `status` (两者必需)

申请人

工具	访问	其功能	参数
`list_applicants`	阅读	列出申请人，选项包括针对单个工作的申请人列表，带有星标、拒绝和存档过滤器。	`jobId`, `starred`, `rejected`, `archived`, `page`, `limit`
`get_applicant`	阅读	一个申请人的详细信息：当前阶段、工作链接、备注和活动历史。	`applicantId` (必需)
`search_candidates`	阅读	在整个候选人池中进行自然语言搜索。返回带有CV段落和每个匹配的理由的排名匹配结果。	`query` (必需)， `jobId`, `timestamp`, `page`, `limit`
`move_applicant_stage`	写入+	将某人移至另一个阶段，触发该阶段的自动化；达到Offer阶段可能会在达到头寸后自动关闭工作岗位。	`applicantId`, `funnelId` (必需)， `reason`
`add_applicant_note`	编写	添加备注，可选地标记为PASS或FAIL决策和所属轮次，默认为私有。	`applicantId`, `content` (必需)， `noteType`, `decisionFlag`, `roundName`
`get_applicant_resume_text`	阅读	解析后的CV内容以文本和字段形式呈现，无附件。	`applicantId` (必需)
`get_applicant_evaluation`	阅读	AI评估：适合度评分、标签、摘要和差距。	`applicantId` (必需)
`reprocess_resume`	编写+	在 AI 流水线中重新运行完整的解析、评估和索引过程，运行在后台的 CV 上。	`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` 仅作为标签存储，不生成链接。面试将以任一方式保存.	`applicantId`, `jobId`, `title`, `scheduledStart`, `scheduledEnd` (必需)， `type`, `location`, `meetingProvider`, `participantIds`, `externalInterviewers`, `timezone`, `instructions`

分析

工具	访问	其功能	参数
`get_analytics`	阅读	总计、环比变化、阶段细分、热门职位和来源混合。默认显示最近30天的数据。	`dateFrom`, `dateTo`
`get_dashboard`	阅读	收件箱以及每个职位的漏斗细分，显示所有当前活跃的候选人。	无

自动化和导入

工具	访问	其功能	参数
`list_job_automations`	阅读	列出在某个职位上配置的自动化：电子邮件、面试安排、标签和通知。	`jobId` (必需)
`get_automation_executions`	阅读	自动化的运行历史	`automationId` (必需)， `page`, `limit`
`get_import_batch`	阅读	候选人导入的进度：每个文件的状态和任何错误	`batchId` (必需)

账户

工具	访问	其功能	参数
`whoami`	阅读	確認助理正在以哪個用戶和組織身份行事，包括授權方法和授權範圍。建議在每個會話中先執行此命令。	无

電子郵件工具從Curriculo的發送郵箱發送，因此即使沒有連接郵箱也可以正常工作。面試安排也可以在沒有日曆的情況下工作：它仍然保存面試並報告邀請未發送。

示例提示

連接後，可以使用簡單語言詢問。客戶端會選擇合適的工具。

"顯示我目前開啟的職位在各個階段的狀態，並標記任何停滯的項目。"
"找到具有團隊領導經驗的高級React工程師，並總結前五名。"
"將 Priya 移至第二輪面試，並草擬一份請求她下周可用時間的回覆。"
"在週四下午 2 點ET安排一場 45 分鐘的視頻面試，並添加 Google Meet 連結。"
"申請者數量與上個月相比如何變化，哪個工作轉換率最高？"

编写工具具有真实的副作用：发送电子邮件、更改流水线、关闭作业。保持工具审批打开以进行写操作，直到您信任工作流程，并仅授予 ats:read 如果您只需要分析。

FAQ 和故障排除

我需要安装或托管任何东西吗？ 不。服务器完全托管在 https://mcp.curriculo.me/mcp。将您的客户端指向 URL 并进行身份验证。

哪些客户端被支持？ 任何支持远程服务器的 MCP 客户端，使用 Streamable HTTP，具有 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 Meet 与 Google，Microsoft Teams 与 Microsoft。没有日历，面试将保存无链接。

如何限制 AI 的功能？ 发行一个仅具有 ats:read 的令牌，用于仅分析访问，并使用您的客户端的每个工具权限设置来禁用特定的写工具。

它代表哪个组织？ 与您的令牌绑定的组织。随时调用 whoami 来确认用户、组织和范围。

安全

范围访问。 每个令牌都绑定到一个用户和组织，并携带显式的 ats:read 或 ats:write 范围。助手所看到的所有内容都仅限于您自己的组织。
最小权限。 授予最窄的范围以完成任务；分析时更倾向于只读令牌。
随时撤销。 个人访问令牌可以在设置、API 与集成中撤销。OAuth 连接可以从客户端连接设置中删除。
传输安全。 所有流量都通过 Streamable HTTP 进行 HTTPS 加密。绝不将令牌粘贴到不受信任的客户端或以明文形式共享。

作为 Curriculo ATS MCP 集线器的一部分，该集线器链接了设置指南、工具参考和连接器文档。

Updated 12 October 2026