Calaf

Calaf MCP Server

将 Claude、ChatGPT 或任何支持 MCP 的助手连接到 Calaf——这款 MBA 招聘管理工具。你可以让助手按需深入调研目标公司、编写并验证结构化的「种子」，然后将其归入你的招聘档案。助手建议的人选始终会暂存，等待你审核——未经你同意，任何人都不会被添加到你的联系人网络中。

两个服务，一个产品。 ai.calaf/calaf 连接你的账户（OAuth）。ai.calaf/seeds 提供无需身份验证的编写流程——任何人都能使用格式和验证器，无需 Calaf 账户。

服务	端点	传输方式	身份验证
Calaf	https://calaf.ai/api/mcp-account	Streamable HTTP	OAuth 2.1（动态客户端注册）
Calaf Seed Tools	https://calaf.ai/api/mcp	Streamable HTTP	无

连接后可以尝试的提问

• 「调研 30 家招聘 MBA Associate 的中小型 PE 基金，验证种子，然后将其导入我的档案。」
• 「阅读 Calaf 的种子格式，然后将这段对话中的目标名单整理成种子，并反复验证，直到内容无误。」
• 「列出我的 Calaf 工作区，并将这些面试准备问题导入咨询工作区。」
• 「我刚结束 Evercore 的 Superday 面试——记录下来，更新我的申请状态，并设置一个周五跟进任务。」
• 「创建一个中小型 PE 工作区，添加我的 10 个目标，并起草外联模板。」
• 「调研我优先关注的 5 家基金的合伙人，并将他们添加到我的档案中」——他们会作为一个批次等待你在 Calaf 中审核，不会悄悄成为记录。

安装

claude.ai（网页版 / 桌面版）

1. 打开设置 → 连接器（claude.ai/settings/connectors）
2. 选择添加自定义连接器 → 将其命名为 Calaf，URL 填写 https://calaf.ai/api/mcp-account，Client ID/Secret 留空
3. 点击连接 → 系统会跳转到 Calaf 的授权页面——登录并批准

需要付费的 claude.ai 方案（自定义连接器仅适用于 Pro 及以上方案）。

Claude Code

claude mcp add --transport http calaf https://calaf.ai/api/mcp-account

其他任何 MCP 客户端

添加一个指向 https://calaf.ai/api/mcp-account 的远程（Streamable HTTP）服务。OAuth 流程遵循标准规范：动态客户端注册 + PKCE；客户端通过 RFC 9728 受保护资源元数据发现授权服务器。

没有 MCP 客户端

复制粘贴流程适用于所有助手：Calaf 的指南和设置页面提供一段只需粘贴一次的提示词，用于向任何 AI 介绍种子格式；助手可以通过开放的验证器 API（见下文）自行检查，然后你可以在设置 → 工作区 → 种子中导入文件。

工具 — ai.calaf/calaf（账户服务）

get_seed_format · 只读

返回完整的 calaf_seed: 1 规范（Markdown），包括各个部分、上限、解析器行为，以及助手编写种子时应遵循的规则。编写前请先阅读，然后使用 validate_seed 检查草稿。

无需参数。

validate_seed · 只读

使用 Calaf 应用导入时所用的完全相同的解析器处理草稿 seed 文档，并返回判定结果：各分区计数以及精确的问题列表。问题严重级别 error 表示不会导入任何内容；dropped 表示该行或字段会被丢弃，其余内容仍会导入。交付文件前，请修复问题并反复验证，直到没有问题。

参数	类型	必填	说明
seed	string | object	是	完整的 seed JSON 文档，可以是文本，也可以是 JSON 对象本身

返回值（结构化）：valid、各分区的 counts（orgs、contacts、templates、prep、keyDates、orgKinds、ladderRungs）、hasVocab、hasPlanner，以及包含 path（例如 orgs[3].name）、message、severity 的 issues[]。

list_workspaces · 只读

列出调用者的 Calaf 工作区，包括 key、显示名称和位置。将 key 用作 import_seed 的 workspace 参数。

无参数。 返回值：包含 key、name、emoji 的 workspaces[]。

import_seed · 写入（非破坏性、幂等）

将有效的 seed 导入调用者的某个工作区，导入结果与应用自身的导入一致：

• 组织 — 在整个账户范围内按名称去重，然后关联到工作区
• 模板 — 在工作区内去重
• 准备问题 — 在整个账户范围内去重
• 人员 — 绝不直接写入。 文件中的联系人会在 Calaf 中暂存为可审核的批次：用户可一次性接受、删减或丢弃这批联系人，也可以一键撤销已接受的批次。联系人必须指定组织才能暂存。

重新导入同一文件不会产生重复内容；任何内容都不会被删除或覆盖。

参数	类型	必填	说明
workspace	string	是	工作区 key，来自 list_workspaces
seed	string | object	是	完整的 seed JSON 文档
parts	string[]	否	要处理的部分：orgs、templates、prep、contacts（= 暂存人员）。默认处理文件中包含的所有内容

返回值（结构化）：ok、按部分统计的 landed、failed[]，以及包含 people、orgs、buildId、skippedWithoutOrg、skippedInvalid 的 staged。

export_seed · 只读

将工作区序列化为 calaf_seed 文档，即反向流程：读取资料、完善内容、重新导入（去重机制确保往返操作不会产生重复项）。隐私默认设置：除非明确请求（include_people、include_notes、include_seeded），否则不会包含人员、用户的个人笔记以及来自其他 seed 的内容；始终报告已排除和因上限截断的计数。没有套餐限制 — 数据可移植性永远不会被付费墙阻挡。

get_profile_schema / get_firm_profile / submit_firm_profile

以深入研究的标准开展公司调研。get_profile_schema 返回各模块的结构（概览、总部、高管、薪酬、流程、文化／招聘备注），以及提交内容必须符合的来源核查标准（MBA 级别的薪酬来源、有疑问时宁可留空也不要猜测、应在来源处核实领导层信息）。get_firm_profile 读取当前状态，并提供各字段的来源信息，以便聊天编辑能基于实际情况合并。submit_firm_profile 将有来源依据的模块写入用户自己的覆盖层 — 显示在用户的公司页面上，并标注为助手研究 — 遵循以下合并约定：空字段会被填充，助手填写的字段会更新，用户输入的字段绝不会被覆盖（会报告冲突）；clear 只会移除由助手管理的字段。必须提供来源；没有来源支持的声明会被全部丢弃。

log_touchpoint · 写入

记录一次互动（咖啡会谈、电子邮件、活动、回复……），并触发应用自身的自动化：联系人状态阶梯（绝不向下调整）、可选的后续跟进安排（会添加到用户的日历）、可选的次日感谢任务，以及在真实活动发生时将状态为 Researching 的公司转为 Networking。

update_contact · 写入

补全通讯录中已有的人。身份字段（电子邮件/电话/LinkedIn/学校/职称/群组）仅在为空时填写——以用户提供的值为准，并报告差异。关系属性（亲密度 1–5、阶段、下次跟进时间、关系类型）则明确设置，因为“将 Jane 标记为休眠”本身就是用户的要求。只有当此人尚未关联公司时，才会填入公司关联。append_note 会添加带日期和署名的备注，放在用户自己的备注下方，绝不覆盖。创建人员仍须通过 import_seed 的分阶段审核。

add_task · 写入

创建有截止日期的任务，可选择关联联系人或公司。任务、跟进和截止日期都会显示在用户的日历中——这是助手接入日历的途径。

get_contacts / get_firms · 只读

分页摘要（联系人摘要会列出仍为空、值得调研的详细信息字段），让助手查看真实通讯录，而不是依赖记忆中的内容。

log_firm_work / get_firm_work / remove_firm_work · 工作记录

咖啡聊天谈资所依据的交易和工作事项。log_firm_work 会向公司的工作记录添加一项，并附上来源属性（来源及可靠程度：Confirmed / Reported / Rumored）；get_firm_work 会读取记录，并标明哪些条目由助手记录。remove_firm_work 仅删除助手自己写入的项目——用户手动记录的条目会被拒绝删除，其保障机制与分阶段人员规则相同。

get_applications · 只读

招聘流程：每份申请对应的公司、项目、状态、截止日期和下一次面试日期。

schedule_interview · 写入

将一轮面试添加到申请的时间线上，因此也会添加到用户的日历中。支持记录未来的面试（已安排），也支持补录过去的面试（设置 completed: true 并填写结果）。每次保存还会运行应用自身的同步：重新计算申请的下一次面试日期，并根据工作区实际使用的阶段顺序推进状态（绝不降级，也绝不重新打开已关闭的结果）。

add_application / update_application · 流程管理

add_application 会在流程中创建一条记录（公司 + 项目；默认状态为 Watching；拒绝重复记录）。update_application 会像应用看板一样推进申请——状态变更会追加到阶段历史记录中，并补填申请日期——还可记录结果（offer_accepted / offer_declined / rejected / withdrawn）。录入的薪酬数字仅在用户尚未填写时才会填入；差异会被报告，但绝不会直接应用。

get_tasks / complete_task / snooze_task · 待办事项循环

按范围列出任务（未完成 / 已逾期 / 今天 / 本周 / 已完成），将任务标记为完成（绝不删除），或延后截止日期。配合 add_task，用户可以在聊天中完成日历上的整个待办事项循环。

add_firm / update_firm / add_office · 通讯录

add_firm 会通过应用自身的流程执行两层写入——全局公司 + 工作区成员关系——并遵循与导入相同的去重原则：已有公司会被关联，绝不会重复添加；助手添加的公司会标记来源。update_firm 会设置指定属性（状态、目标、优先级），并且仅在文本字段为空时填写（原因/情报备注、层级、地点——始终以用户的文字为准，并报告差异）。add_office 仅作新增；若标签重复则拒绝添加。

add_note / get_notes / update_note · 笔记本

助手在用户笔记本中的草稿区：创建笔记（可选择关联公司或人员）、按带所有权标记的方式列出笔记，以及编辑仅由助手自己编写的笔记——用户的笔记会被拒绝编辑，保障机制与其他地方相同。

create_workspace / rename_workspace / archive_workspace · 容器

通过应用自身的流程创建新工作区（受计划的名额上限限制）、重命名工作区，或将其归档/恢复。归档在设计上可撤销——这里的任何操作都不会删除内容。

add_template / get_templates / update_template · 外联模板

按工作区管理可重复使用的邮件模板。助手模板会标记出来，且可以编辑；用户自己的模板和预置模板不允许编辑。

add_prep_question / get_prep / draft_prep_answer · 面试准备

向准备题库添加问题（会去重，也可关联公司），列出尚未回答的问题，并且只会在空白栏位中起草答案，并标记为“草稿”，供用户修改。用户已经回答的问题会被直接拒绝处理——面试表达属于用户本人。

工具 — ai.calaf/seeds（公共服务）

get_seed_format 和 validate_seed 的行为与上述完全相同——无需账户，也无需身份验证。格式也通过 MCP 资源提供（https://calaf.ai/seed-format.md，text/markdown）。

对待人脉的方式

虚构一家公司会浪费一个下午；虚构一个人，则意味着给一个并不存在的人发邮件。因此，通过此 API 提交的人脉不会直接进入人脉簿：他们会以命名批次的形式出现在 Calaf 的审核界面中，用户可以查看完整列表，一次操作即可接受或舍弃；接受后也可以撤销整个批次。每条已接受记录都会标明来源（来自哪个助手、何时提交、源自哪个 seed）。

信任与数据

• 使用 OAuth，绝不使用密码。 连接采用支持动态客户端注册的 OAuth 2.1；助手不会接触凭据。可在 Calaf → 设置 → 已连接的助手 中断开任意助手，也可以在你的 AI 设置中断开。
• 只访问你的人脉簿。 所有读取和写入操作都基于连接用户自身的账户权限执行（数据库行级安全机制）——已连接的助手始终只能访问该用户的数据。
• 只增不改。 导入时会去重；不会删除或覆盖任何内容。
• 健康探测： 账户服务会按 MCP 授权规范的要求，对匿名请求返回 HTTP 401 和 OAuth challenge——未将授权挑战视为有效响应的目录健康检查器，可能会将其显示为“不健康”。真正的 MCP 客户端能够正确完成协商。

纯 HTTP 验证器（无需 MCP）

curl -X POST https://calaf.ai/api/seed-validate \
  -H 'content-type: application/json' \
  -d @your-seed.json

使用相同的解析器，返回相同格式的结果——适用于 CI 步骤、脚本以及只能发送 HTTP 请求的助手。

链接

• 设置指南：calaf.ai/connect.md
• Seed 格式：calaf.ai/seed-format.md
• 产品：calaf.ai · 支持：[email protected]
• 注册表条目：ai.calaf/calaf、ai.calaf/seeds——本仓库是这两项的文档主页；服务本身位于远程（无需从此处安装代码）。