概览
将任何兼容 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
连接您的助手
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 替换为您的完整密钥(请参阅上文“身份验证”部分中的完整密钥是什么样)。
验证是否有效 — 请询问:"列出我空缺的职位。"
Cursor
静态标头是最简单的路径。Cursor 也可以使用 OAuth(它支持动态客户端注册)——为此,请删除 headers 块。
步骤: 1) 将服务器添加到 ~/.cursor/mcp.json(如下),2) 在您的 shell 配置文件中将 FLOWMINGO_API_KEY 设置为您的完整密钥,3) 退出 Cursor 并从设置了该变量的终端启动它,4) 在 设置 → MCP 中,关闭再打开服务器以重新加载。
Cursor 必须能够看到该变量。 Cursor 从自身环境读取 ${env:FLOWMINGO_API_KEY}。从 Dock 或开始菜单启动时,它通常看不到您在终端配置文件中设置的变量,然后标头为空或未展开,服务器会回答 Missing credential。如果从终端启动 Cursor 不现实,请将文件中的 ${env:FLOWMINGO_API_KEY} 替换为您的完整密钥(并将 ~/.cursor/mcp.json 保留在 git 之外)。
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
改用 OAuth——删除 headers 块;Cursor 运行动态客户端注册,并在首次连接时打开浏览器同意页面:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
验证是否有效——询问:“列出我打开的职位。”
VS Code (Copilot, agent mode)
工具仅出现在Copilot Chat → Agent mode。根密钥是 servers(不是 mcpServers),类型是 http。下面的提示密钥路径是可靠的设置。
步骤: 1) 创建 .vscode/mcp.json(或运行MCP: Add Server → HTTP),2) 启动服务器时,VS Code 会提示输入您的密钥(它不会写入文件),3) 在Agent mode中使用它。
{
"servers": {
"flowmingo": {
"type": "http",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${input:flowmingo_key}" }
}
},
"inputs": [
{ "id": "flowmingo_key", "type": "promptString", "description": "Flowmingo API key (fl_...)", "password": true }
]
}
VS Code 也可以尝试 OAuth,但文档中的 OAuth 配置需要客户端 ID;请使用上面的提示密钥路径以获得可靠的设置。
验证是否有效 — 提问:“列出我所有的开放职位。”
Claude — claude.ai & Claude Desktop
两者都使用相同的连接器 UI 和相同的粘贴 URL 的流程。仅支持 OAuth(UI 中没有标头字段)。
步骤(网页版或桌面版):
- 打开设置 → 连接器并单击添加自定义连接器。
- 命名为
Flowmingo并粘贴上面的 MCP 服务器 URL。将高级 → OAuth 客户端 ID / 密钥留空。 - 单击添加 → 连接。在 Flowmingo 同意页面上,粘贴您的
fl_API 密钥并授权。 - 验证 — 询问 Claude:“列出我所有的开放职位。”
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
团队/企业版:所有者在组织设置 → 连接器 → 自定义下添加一次;然后成员单击连接。
需要在 Claude Desktop 上使用静态密钥?请使用任何客户端 (mcp-remote) 选项卡。
首次连接时,您的浏览器会打开一个 Flowmingo 同意页面 — 粘贴您的 API 密钥并授权。稍后断开连接,请在 设置 → 集成 → API 密钥 中删除该 API 密钥。
ChatGPT 与 OpenAI Codex CLI
两者均为 OpenAI 产品。ChatGPT 使用开发者模式进行自定义连接(仅限 OAuth);Codex 则从 CLI 原生连接。
ChatGPT(网页版)
- 在 chatgpt.com(Plus / Pro / Business / Enterprise / Edu — 非移动端)上,打开 设置 → 应用 → 高级,并开启 开发者模式。
- 应用 → 创建 → 命名为
Flowmingo,粘贴下方 URL,传输方式选择 Streamable HTTP,认证方式选择 OAuth。 - 打开草稿,启用相关工具,然后点击 刷新。
- 在聊天中通过 + 菜单附加该应用。
Connector URL: https://mcp.flowmingo.ai/mcp
Transport: Streamable HTTP
Auth: OAuth (leave any static OAuth client ID / secret blank — Flowmingo uses Dynamic Client Registration)
ChatGPT 的开发者模式仅支持 OAuth 连接 — 它不接受静态的 x-api-key 或自定义 API 密钥头。普通和深度研究连接器仅使用 search 和 fetch(您两者都有)。写入工具(邀请 / 移动 / 拒绝)需要开发者模式。ChatGPT 在运行工具前显示的提示是 ChatGPT 自身的提示,并非 Flowmingo 的审批:邀请、拒绝以及将候选人移入某个阶段并发送邮件,始终需要有人在 Flowmingo 链接上审批。
OpenAI Codex CLI
无需桥接 — Codex 原生支持 Streamable HTTP。
# ~/.codex/config.toml — static fl_ key as a bearer (simplest)
[mcp_servers.flowmingo]
url = "https://mcp.flowmingo.ai/mcp"
bearer_token_env_var = "FLOWMINGO_API_KEY" # export FLOWMINGO_API_KEY=fl_...
startup_timeout_sec = 20
tool_timeout_sec = 120
# Static API key (bearer from env) — simplest:
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp --bearer-token-env-var FLOWMINGO_API_KEY
# export FLOWMINGO_API_KEY=fl_... (or set it in ~/.codex/config.toml [mcp_servers.flowmingo])
# OAuth instead (no key stored):
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp
codex mcp login flowmingo
codex mcp list
验证是否正常 — 可以询问 "列出我空缺的职位。"
Gemini CLI & Code Assist
Gemini CLI(以及 Gemini Code Assist 代理模式)通过 ~/.gemini/settings.json 连接到远程 MCP 服务器。消费者 Gemini 应用无法添加自定义 MCP 连接器 — 此路径仅适用于 CLI / Code Assist。
步骤: 1) 在 ~/.gemini/settings.json 中将服务器添加到 mcpServers 下,2) 导出 FLOWMINGO_API_KEY=fl_...,3) 运行 gemini 并输入 /mcp 以确认列出了工具。
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl 选择原生的 Streamable HTTP。${FLOWMINGO_API_KEY} 占位符会从您的环境变量中展开,因此不会将原始密钥写入文件。偏好 OAuth?Gemini CLI 可以原生支持 — 省略 headers 块,并在服务器条目中添加 "authProviderType": "dynamic_discovery"。CLI 会检测到 401 挑战,发现我们的 OAuth 元数据,并自行执行动态客户端注册(无需设置客户端 ID)。
验证是否有效 — 在
gemini中提问:“列出我所有的开放职位。”
其他客户端 — Windsurf · Zed · Cline · Continue · Antigravity
以下每个客户端都连接到同一台服务器 — 大多数客户端同时支持 OAuth 和静态请求头。示例代码通过环境变量使用静态密钥;如果您希望客户端在支持 OAuth 时自动使用 OAuth,请省略 headers 部分。请注意以下提到的各客户端密钥名称的陷阱。
Google Antigravity
将 https://mcp.flowmingo.ai/mcp 添加为远程 MCP 服务器,并选择进行身份验证:会打开一个 Flowmingo 页面,并请求您提供完整的 API 密钥(请参阅上文“身份验证”部分中的“完整密钥示例”)。每个 Antigravity 界面(IDE、CLI)都需单独登录。在 Antigravity 的 mcp_config.json 中,地址放在 serverUrl 下,静态密钥放在 headers 块中,作为 Authorization,值为 Bearer 加上您的完整密钥,正如 Google 自己的 Antigravity MCP 示例所示。我们未能测试每个 Antigravity 版本,因此如果您的菜单与此不同,请以 Google 指南中的当前步骤为准。
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf 接受 serverUrl 或 url,并支持 OAuth(省略 headers 即可触发)。
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — 密钥为 context_servers;省略 headers 以使用原生 OAuth。在环境中设置 FLOWMINGO_API_KEY=fl_...,而不是粘贴原始密钥。
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP 服务器 → 配置 — 设置 type: "streamableHttp"(驼峰格式),否则它会默认为过时的 SSE。
{ "mcpServers": { "flowmingo": {
"type": "streamableHttp",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" },
"disabled": false, "autoApprove": []
} } }
Continue.dev
~/.continue/config.yaml — 通过 mcp-remote 桥接连接。设置 FLOWMINGO_AUTH_HEADER = Bearer fl_YOUR_KEY。
name: Flowmingo MCP
version: 0.0.1
schema: v1
mcpServers:
- name: Flowmingo
command: npx
args: ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp", "--transport", "http-only", "--header", "Authorization:${{ secrets.FLOWMINGO_AUTH_HEADER }}"]
验证是否成功 — 可以询问:“列出我当前的招聘职位。”
任意客户端 (mcp-remote)
对于任何仅支持 stdio 的客户端(或未来没有原生远程传输的客户端),可通过 mcp-remote stdio 命令桥接到 Flowmingo。必须使用 --transport http-only —— 服务器不支持 SSE。
步骤: 1) 确保 Node ≥ 18,2) 在客户端中将桥接作为 stdio 命令运行,3) 首次 OAuth 运行时浏览器会打开 —— 粘贴你的密钥。
# Bare terminal — OAuth, caches the token in ~/.mcp-auth:
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only
# Static key (no browser): --header on its own arg is fine
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only \
--header "x-api-key: fl_YOUR_KEY"
{
"mcpServers": {
"flowmingo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp",
"--transport", "http-only", "--header", "x-api-key:${FLOWMINGO_KEY}"],
"env": { "FLOWMINGO_KEY": "fl_YOUR_KEY" }
}
}
}
救援: 如果认证卡住,运行 rm -rf ~/.mcp-auth 并重试。将 fl_YOUR_KEY 替换为你的完整密钥(参见上文“认证”部分中的完整密钥样式)。在 JSON 的 args[] 中,避免在头部冒号后添加空格(npx 转义问题)。
验证是否成功 —— 询问:"列出我的公开职位。"