集成

连接 AI 助手 (MCP)

将任何 MCP 兼容的 AI 助手 — Claude、Claude Code、ChatGPT、Cursor、VS Code 等 — 连接到您的 Flowmingo 招聘数据,并用自然语言处理您的招聘流程。

Our team is online
需要集成方面的帮助?

卡在某个步骤,或需要技术支持?我们的团队很乐意为您提供帮助 —— 随时与我们联系,我们会帮您接上专人协助。

概览

将任何兼容 MCP 的 AI 助手连接到您的 Flowmingo 招聘数据——读取您的工作和候选人,并在您的许可下安全地采取受保护的操作(邀请、移动、拒绝、从项目中移除)。通过您自行开启的两个额外权限,助手还可以创建招聘项目和评估,以及发布、关闭或推广职位发布(参见您可以做什么)。MCP 新手?它是让 AI 助手与 Flowmingo 等工具对话的开放标准。了解什么是 MCP。

传输方式: Streamable HTTP(现代远程传输)。没有遗留的 SSE——始终将您的客户端指向 /mcp,而不是 /sse。

像对待密码一样对待您的 API 密钥。 优先使用 OAuth、提示输入或环境变量,而不是将原始的 fl_... 密钥粘贴到可能提交到 git 的文件中(例如 .vscode/mcp.json、~/.cursor/mcp.json、您的 Continue 配置)。

身份验证——两种选项

A——使用 Flowmingo 登录(OAuth,推荐)。 您的浏览器会打开 Flowmingo 同意页面;您在那里粘贴 API 密钥。助手永远不会收到您的原始密钥。它收到一个访问令牌和一个刷新令牌,并可以使用它们获取新的访问令牌。登录不会永久有效。刷新令牌默认大约 30 天有效,从颁发时(登录时或最近刷新时)计算,因此大约那么长时间未使用的登录会失效,并且更改登录存储方式的 Flowmingo 版本可能也要求您重新登录。助手随后会要求您再次登录,您再次粘贴密钥。要提前终止,请删除该 API 密钥。无需创建客户端 ID 或密钥(Flowmingo 使用动态客户端注册)。在显示“高级”OAuth 设置的客户端上(例如 Claude.ai),请将客户端 ID 和密钥留空。

B——静态 API 密钥(请求头)。 将您的密钥作为以下任一请求头发送:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

在 Flowmingo → 设置 → 集成 → API 密钥 获取您的密钥。勾选 Read hiring data 和 Read candidates——第一个涵盖职位、管道和结果,第二个让助手可以查找某人。添加 Manage pipeline / Invite candidates 以进行受保护的写入操作。要让助手创建项目和评估以及发布或推广职位发布,还请勾选 Create hiring projects 和 Create assessments。请先阅读“您可以做什么”下的“创建和发布”:这两个权限是自愿加入的,并且密钥的创建者必须是所有者或管理员。

完整密钥的样子。 一个长值:fl_live_,密钥的公开名称,一个点,然后是一个长秘密。秘密部分仅在您创建密钥后立即显示一次;之后 API 密钥列表只显示其开头。没有点的值只是密钥的名称,将被拒绝。无论本指南在哪里写 fl_YOUR_KEY,请用您的完整密钥替换全部内容,不带引号,不带空格。

如果无法连接。 错误或空的密钥会返回 Missing credential 或 The Flowmingo API key was rejected;两者都可能意味着值从未完整地到达我们这里,因此请先检查该值。诸如 ${env:FLOWMINGO_API_KEY} 之类的设置只有在程序能够看到该变量时才有效,而从 Dock 或“开始”菜单打开的编辑器通常不会读取终端配置文件。要么从设置了变量的终端启动它,要么将完整密钥放入文件中(并将该文件排除在 git 之外)。

选择哪个? 大多数客户端都支持两者;少数(例如 ChatGPT)仅支持 OAuth——每个选项卡都注明了该客户端支持什么。一般来说,OAuth 适用于交互式助手(Claude.ai、ChatGPT、VS Code);API 密钥请求头适用于 CLI、无头/CI 以及您宁愿直接输入密钥的编辑器。

您可以做什么

读取不需要批准。大多数写入都受到保护。邀请、使用“拒绝”操作进行的拒绝、从项目中移除候选人、删除项目,或者通常移动到设置为向候选人发送电子邮件的阶段,都会等待人员在链接处登录 Flowmingo 进行批准。助手无法批准,而在聊天中输入“是”不算数。阶段的电子邮件设置会在请求移动时检查。对于备注、评分、候选名单、标签或移动到未设置为向候选人发送电子邮件的阶段,助手会先向您显示预览,并在您同意后才继续进行,这是对它的指示,而不是锁定。您的 AI 客户端在运行工具之前显示的提示是该客户端自己的,不是 Flowmingo 的批准:邀请、使用“拒绝”操作进行的拒绝以及移动到发送电子邮件的阶段仍会等待批准链接,无论客户端要求什么。批准链接在 15 分钟后失效,一次请求多个候选人(最多 50 个)是一次批准,列出所有人。一旦更改暂存,助手可以检查其状态,在等待时撤回它,并在 24 小时内撤销可逆的更改(备注、评分、候选名单标记、标签或未向任何人发送电子邮件的移动)。撤销并非总是可用:更改必须带有撤销引用,记录撤销引用是尽力而为,对于没有早期阶段的候选人移动,没有撤销引用,因此助手应检查并在没有返回路径时说明。已发送的电子邮件无法撤销。创建和发布下列出的工具是所有这些规则的例外,除了 delete_project:它们立即执行,不会暂存以供批准。移除和项目删除无法撤销。所有内容都限定在您的组织范围内。

读取

能力 作用
列出职位发布 浏览您组织的开放和关闭的职位。
列出面试集和项目 查看您所有类型的评估(面试集)(AI 面试、角色扮演、技能测试、技术测试、CV 评估、展示和录音;问卷调查可根据要求提供)以及您的招聘项目。
列出候选管道 查看项目中各阶段的申请。
读取评估结果和分数 拉取所有类型的结果:AI 面试、角色扮演、技能测试、技术测试、CV 评估、展示、录音和问卷调查。每个结果都标有其类型。只有某些类型带有 AI 分数:展示和问卷调查从不评分,技能测试是百分比。
查找候选人 获取单个候选人的姓名、电子邮件和 CV。
搜索候选人 按姓名或电子邮件查找候选人。
比较候选人 并排排列 2 到 10 位候选人。需要 Read candidates 权限以及 Read hiring data。
招聘概览 您的连接可以访问的所有内容的漏斗(整个公司,除非密钥由限制在某个项目的人创建),或根据您的要求缩小范围:每个阶段的申请、活跃与已拒绝,以及对于每种有结果的评估,已完成与进行中的结果以及平均分数。项目会缩小所有计数,但其结果计数包括链接到该项目的评估上的结果,因此共享这些评估之一的另一个项目的候选人也可以被计入。评估只缩小结果计数:阶段和申请计数保持在您的连接可以访问的所有内容。类型从不加在一起。
顶级候选人 按总分数排序的最高排名结果。除非您要求一种类型或一个评估(面试集),否则每种评估都会一起排名。
评估结果详情 一个结果的每个能力分数以及 AI 摘要,对于具有这些的类型。技能测试、技术测试、展示和问卷调查很少或没有。
职位发布详情 单个职位发布的完整详情。
职位发布是否对公众开放?(get_job_post_publication) 任何人都可以打开职位发布的公共页面:在线、仍在等待 AI 内容检查、被其拒绝、被标记、被关闭,或其项目未开放。还有其公共地址和推广(关闭、flowmingo 或扩展)。需要 Read hiring data。
即将进行的面试 已发送或计划但尚未完成的任何类型评估的邀请。这不是尚未完成所有人的计数:已提醒、已打开或已点击链接的候选人的邀请在候选人开始之前被排除,发送失败的邀请也被排除。

写入(受保护)

能力 作用
邀请候选人参加评估 为 AI 面试、角色扮演、技能测试或技术测试准备邀请,并等待人员在链接处批准。在此之前不会发送任何内容。每次请求一个评估和最多 50 位候选人;技能测试或技术测试需要项目和每位候选人的电子邮件,赞助的测试在候选人开始时可以从您组织的钱包中扣款。
将候选人移动到另一阶段 移动到设置为向候选人发送电子邮件的阶段通常等待人员在链接处批准(阶段的电子邮件设置在移动前读取一次,因此那时刚开启的设置仍然可以让移动发送电子邮件而无需批准)。任何其他移动:助手被指示预览并等待您的“是”,并且通常可以在 24 小时内撤销,当它带有撤销引用时。每次请求最多 50 个申请。
拒绝申请 在链接处请求批准。如果人员批准,Flowmingo 尝试将申请移动到项目的“已拒绝”阶段;之后检查结果。每次请求最多 50 个申请。
从项目移除候选人(remove_application) 需要 Manage pipeline。在链接处请求批准。如果人员批准,Flowmingo 从项目中删除申请;候选人的个人资料保留在您的人才库和其他项目中。这不是拒绝,也没有撤销。每次请求最多 50 个申请。
为结果添加备注 助手被指示在保存前预览提议的备注并等待您的“是”。备注属于一个评估结果(任何类型),而不是整个候选人。
为结果评分 助手被指示在保存前预览评分并等待您的“是”。评分适用于一个评估结果。
将结果列入候选名单 助手被指示在保存前预览候选名单更改并等待您的“是”。它适用于一个评估结果。
标记 / 添加到人才集合 助手被指示在保存前预览标记或人才集合更改并等待您的“是”。
检查、撤回或撤销更改 检查暂存更改的状态(等待中、已执行、失败、已过期或被较新的请求取代)、撤回仍等待批准的更改,或在 24 小时内撤销可逆的更改,当它带有撤销引用时。

创建和发布(立即执行,除删除项目外)

这些工具创建内容并将其公开。它们的行为与上述受保护的写入不同:

  • 它们立即执行,除 delete_project 外。 没有内容会暂存供人员在链接处批准,并且它们都不会向候选人发送电子邮件。delete_project 等待所有者或管理员在链接处批准。
  • 密钥的创建者必须是所有者或管理员,对于这里的每个工具,除了取消,取消只需要 Invite candidates。这些工具以创建 API 密钥的人员的权限执行。如果该人员是成员,调用将被拒绝。
  • 两项权限为可选开启。 Create hiring projects 和 Create assessments 默认不授予。通过登录(选项 A),助手仅在同时满足以下两个条件时才获得这些权限:客户端在连接时明确列出这些权限,并且您在同意页面粘贴的API密钥包含这些权限。未发送权限列表的客户端将获得密钥所包含的四项标准权限(Read hiring data、Read candidates、Manage pipeline、Invite candidates),而不会获得这两项权限,因此助手将看不到需要这些权限的工具。使用静态密钥(选项 B)时,无论密钥包含哪些权限,助手都会看到这些工具,而 Flowmingo 会拒绝任何密钥不允许的调用。
  • 某些调用需要一段时间。 发布等待 AI 内容检查,最多约 90 秒。创建项目或评估使用 AI 生成,可能需要更长的时间(技术测试需要 3 到 9 分钟)。当答案说工作仍在进行中时,助手使用相同的幂等密钥再次调用以读取进度。重试永远不会创建第二个项目或评估。
能力 作用
创建招聘项目(create_project) 需要 Create hiring projects(自愿加入)。创建一个具有四个默认阶段和由与仪表板相同的 AI 编写的职位发布的项目,从标题、职位和可选描述。默认情况下它还创建 CV 评估和 AI 面试;助手可以命名其他评估,或没有。职位发布已开启,并在 AI 内容检查批准后公开,通常在一分钟内。您的公司限制为每分钟 10 个项目,每天 300 个。幂等密钥是可选的:当省略时,一个从参数中生成,因此重试永远不会创建第二个项目。
创建评估(create_assessment) 需要 Create assessments(自愿加入)。使用 AI 创建一个评估:AI 面试、CV 评估、技能测试、展示、技术测试或角色扮演,从职位标题和可选职位描述、名称、项目和语言(标签如 en 或 vi-VN;技能测试和技术测试忽略语言)。将其附加到项目,以便候选人可以被邀请参加技能测试、技术测试或展示。幂等密钥是可选的,如上所述。
发布职位发布(publish_job_post) 需要 Create hiring projects。开启职位发布并确保 AI 内容检查已运行。答案说明页面现在是否在线、仍在等待检查或被其拒绝。招聘项目必须处于活动状态。
取消发布职位发布(unpublish_job_post) 需要 Create hiring projects。关闭职位发布,因此其公共链接停止打开。默认情况下,推广也会关闭(withdraw_boost 为 true)。
推广职位发布(boost_job_post) 需要 Create hiring projects。将推广设置为 off、flowmingo 或 extended。推广是免费的。提高推广需要职位发布已开启、其项目处于活动状态、公司徽标和描述以及 AI 内容检查;公司每天可以提升 50 次推广。
打开、草稿或归档项目(set_project_state) 需要Create hiring projects。在active、draft和archived之间移动招聘项目。草稿和归档会关闭职位链接。候选人数据将被保留。
取消计划邀请(cancel_scheduled_invite) 需要 Invite candidates。使用邀请结果中的邀请 ID 取消计划稍后发送且尚未发送的邀请。不会向任何人发送电子邮件。该人员保留在您的账户和项目板上。
删除招聘项目(delete_project) 需要 Create hiring projects(自愿加入)。它只是请求:它不会立即删除,它在链接处请求批准,并且在所有者或管理员批准之前不会删除任何内容。只有活动项目可以被删除。如果人员批准,Flowmingo 会删除项目及其职位发布;其候选人申请不会逐个删除,候选人个人资料和联系方式、您的评估和邀请链接都会被保留。没有撤销。

安全与信任

  • 您的数据是组织范围的——助手永远无法看到其他公司的数据。
  • 使用 OAuth,助手永远不会收到您的 API 密钥。它收到一个在一小时后过期的访问令牌,在保持连接时安静地刷新。登录本身持续与其刷新令牌一样长,默认从颁发或上次刷新起约 30 天,因此在未使用约 30 天后失效,然后您再次登录。使用静态请求头(选项 B),您助手的客户端持有您的密钥并随每个请求发送,因此请将其远离可能共享或提交的文件。
  • 切断助手: 删除您授权给它的 API 密钥,在 设置 → 集成 → API 密钥。访问会立即停止。目前还没有按助手断开连接,因此如果您想逐个撤销,请为每个助手提供自己的密钥。
  • 对 /mcp 端点的请求检查其 Origin:不透明的 null 来源始终被拒绝,并且检查可以锁定到允许列表,但默认情况下每个真实来源都被接受,因此保护是您的凭据,而不是来源。每个会话都绑定到打开它的凭据。

有关如何验证身份,请参阅身份验证——两种选项;有关确切的读取、受保护的写入和立即执行的操作,请参阅您可以做什么。准备好后,跳转到连接您的助手并选择您的客户端。

MCP 服务器 URL

MCP 服务器 URLhttps://mcp.flowmingo.ai/mcp

连接您的助手

您正在使用哪个助手?

Claude Code (CLI)

一条命令即可在原生 Streamable HTTP 上添加 Flowmingo。首选 OAuth;静态 --header 是备选方案。

步骤: 1) 添加服务器,2) 登录(浏览器 → 粘贴密钥),3) 运行 claude mcp list 进行验证。

# OAuth (recommended) — flags BEFORE the name:
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp
claude mcp login flowmingo          # browser opens; paste your fl_ key on the consent page

# Static API key instead (pick ONE header):
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp \
  --header "x-api-key: fl_YOUR_KEY"
# or: --header "Authorization: Bearer fl_YOUR_KEY"

# Share with a repo team (writes a git-committable .mcp.json):
claude mcp add --transport http --scope project flowmingo https://mcp.flowmingo.ai/mcp

claude mcp list && claude mcp get flowmingo

注意: 标志必须放在名称之前,且始终使用 --transport http(切勿使用 sse)。将 fl_YOUR_KEY 替换为您的完整密钥(请参阅上文“身份验证”部分中的完整密钥是什么样)。

验证是否有效 — 请询问:"列出我空缺的职位。"