Ficiel MCP

Ficiel MCP：将 Claude 连接到你的 Instagram、WhatsApp 和 LinkedIn 私信

English version

Ficiel 是一款面向教练和预约专员的 AI 收件箱：它会找出 Instagram、WhatsApp 和 LinkedIn 上需要跟进的旧对话，准备好消息，并且未经人工确认绝不会发送。

本仓库介绍其 MCP（Model Context Protocol）服务：它的地址可让 Claude、Cursor 或任何 MCP 客户端在获得你的授权后读取对话、查找联系人、找出沉睡中的潜在客户并准备跟进消息。本仓库仅包含文档：该服务由 Ficiel 托管，其代码未在此发布。

• 服务地址：https://bridge.ficiel.io/mcp（Streamable HTTP）
• 工具：截至 2026 年 10 月 21 日共 83 个（每个操作对应一个工具），其中 21 个会显示交互式屏幕；助手菜单中还提供 12 个即用型请求（prompts）；不会生成任何语音，发送的语音始终是你已录制的语音（统计数据、漏斗、现金、待跟进联系人、准备好的跟进消息、联系人档案、分析……），完整列表见 TOOLS.md
• 交互式屏幕（MCP Apps，自 2026 年 10 月 8 日起）：“谁已读不回？”会显示待跟进联系人列表，并提供“跟进”按钮；准备好的跟进消息会在同一屏幕中打开，点击“发送”即可发送；还可查看潜在客户档案和月度摘要
• 不带公开链接的文件：ficiel_send_media 可发送助手附加的文件（最大 10 Mo），ficiel_send_document 可根据文本生成 PDF
• 现金（ficiel_get_cash）仅限组织所有者使用；每个工具都会向助手说明它是读取还是写入，以及是否会发送、删除或覆盖内容
• 文本绝不截断：消息、语音、笔记、Kord 指令均完整返回；长回复会分页（next_cursor）
• 可读取媒体内容：图片附带描述和可见文字，文档附带文本，视频附带时长和台词；ficiel_get_media 会返回图片或文档本身
• 已读 / 未读：会在助手打开对话时，从渠道读取你最新消息的阅读状态
• 渠道：Instagram、WhatsApp、LinkedIn
• 官方页面：https://ficiel.io/mcp/
• MCP 官方注册表：io.ficiel/ficiel

连接 Claude 应用（claude.ai、电脑、手机）

1. 将你的渠道连接到 Ficiel（https://app.ficiel.io）。
2. 在 Claude 中，打开“设置”，再打开“连接器”，并添加地址为 https://bridge.ficiel.io/mcp 的自定义连接器。
3. Claude 会将你带到 Ficiel：登录并选择允许助手执行的操作（只读，或读取和发送）。

无需复制密钥：连接通过 OAuth 建立，连接会显示在 Ficiel 设置中，你可以随时断开。

Claude Code

在 Ficiel 设置中创建密钥，然后：

claude mcp add --transport http ficiel https://bridge.ficiel.io/mcp --header "Authorization: Bearer VOTRE_CLE"

Cursor 和其他 MCP 客户端

{
  "mcpServers": {
    "ficiel": {
      "url": "https://bridge.ficiel.io/mcp",
      "headers": { "Authorization": "Bearer VOTRE_CLE" }
    }
  }
}

密钥以 fk_live_ 开头。每个密钥仅属于一个组织，且只能访问该组织。

ChatGPT

ChatGPT 在网页端的开发者模式下支持远程 MCP 服务，适用于 Plus、Pro、Business、Enterprise 和 Éducation 方案（OpenAI 文档）：

1. 在 ChatGPT 中，进入“设置”→“安全与登录”，启用开发者模式。
2. 使用地址 https://bridge.ficiel.io/mcp 和 OAuth 身份验证，创建开发者模式应用。
3. ChatGPT 会将你带到 Ficiel：登录并选择只读权限，或读取和发送权限。

此流程遵循 OpenAI 的文档，但 Ficiel 尚未对其进行端到端测试：已验证的客户端是 Claude（应用和 Claude Code）和 Cursor。

请求示例

• “列出我最后一条消息已被查看，但超过三天仍未收到回复的对话。”
• “阅读与 @prenom 的全部对话，并告诉我是什么让对方犹豫。”
• “为九月份询问过我的价格的五位潜在客户准备跟进消息，我会在 Ficiel 中审核。”
• “在我的资格筛选标准中添加：已有一个拥有超过 5 000 名粉丝的 Instagram 账号。”

未经人工确认，绝不发送

Ficiel 提供经人工确认的 AI 客户开发服务：Kord 会执行客户开发专员的工作，而每条消息都由你确认后发送。该服务的设计初衷是让助手可以读取所有内容，但几乎不能独自执行任何操作。详细规则见 HUMAIN.md：默认使用只读密钥、必须指定收件人并与真实联系人核对、不得向陌生人发送消息，并采用与应用相同的防护措施。

示例

真实请求及助手在后台执行的操作：examples/EXEMPLES.md。

访问权限

该服务向试用中的组织（免费试用 10 天：https://ficiel.io）或订阅用户开放。如果尚未开始试用、试用已暂停，或订阅未付款或已到期，每个工具都会拒绝请求，并提供重新启用访问权限的链接。

助手可以执行的操作取决于方案。Essentiel：日常所需的全部功能，即读取、搜索、准备、发送和安排跟进，整理联系人（标签、阶段、备注，可逐个或批量操作），以及调整 Kord。Intégral：除此之外，还可创建和设置自动化、各渠道的 AI，以及报价金额。所有用户仍可查看这些设置、关闭某个渠道或停用自动化。调用受限工具时，工具会拒绝请求，说明当前方案已支持的功能，并提供更改方案的链接。

联系方式

Ficiel 创始人 Abraham Rajoelina：[email protected]

文档采用 CC BY 4.0 许可（参见 LICENSE）。

在哪里可以找到 Ficiel MCP

• MCP 官方注册表：io.ficiel/ficiel
• Glama
• LobeHub
• Cursor Directory
• mcpservers.org
• 官方页面：https://ficiel.io/mcp/

许可

本仓库的文档采用 Creative Commons Attribution 4.0 International 许可（CC BY 4.0，完整文本见 LICENSE），© 2026 Ficiel.io、Abraham Rajoelina。该许可仅适用于本仓库中的文件：Ficiel 服务、其 MCP 服务及其代码不在许可范围内，仍归 Ficiel.io 所有。