Fiber AI MCP Server

什么是 Fiber AI MCP Server？

Fiber AI MCP Server（Core）是 Fiber AI 托管在 https://mcp.fiber.ai/mcp 的端点，让 AI 助手通过五个元工具发现并调用 Fiber 的任意 B2B 数据 API 操作，从公司和人员搜索到联系方式补全。它使用 Fiber API 密钥。

Fiber AI 自称是面向销售、招聘和 GTM 运营的智能体原生 B2B 数据平台。团队用它查找公司和人员、补全个人资料并获取工作联系方式，可通过 API、MCP 或编程智能体插件使用。Fiber 运行多个 MCP 服务器；这个 Core 服务器是最通用的一个，让智能体无需为每个操作单独加载工具，就能访问 100 多个 API 操作的完整目录。

如何使用 Fiber AI MCP Server？

在 Fiber 应用（fiber.ai/app/api）中生成 API 密钥，并将其保存在 FIBER_API_KEY 等环境变量中，让智能体永远看不到原始密钥。Fiber 按以下顺序查找密钥：请求中的 apiKey 字段、x-api-key 请求头（推荐用于 IDE 和 CLI），然后是 Authorization: Bearer。

Claude Code

来自 Fiber 文档：

claude mcp add --transport http fiber-ai-core https://mcp.fiber.ai/mcp \
  --header "x-api-key: $FIBER_API_KEY"

在会话中运行 /mcp 确认连接。

Claude Desktop 与 claude.ai

打开 Settings（或 Customize），进入 Connectors，选择「Add custom connector」，粘贴 https://mcp.fiber.ai/mcp。Fiber 文档说明，当 Claude 显示认证方式为 None 时，添加一个 x-api-key 请求头。如果你希望用浏览器登录而不是密钥，Fiber 另有支持 OAuth 的 V3 服务器（https://mcp.fiber.ai/mcp/v3）。

Cursor

在 Settings → MCP → New MCP Server 中选择 HTTP，或添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "fiber-ai-core": {
      "url": "https://mcp.fiber.ai/mcp",
      "headers": {
        "x-api-key": "<YOUR_FIBER_API_KEY>"
      }
    }
  }
}

VS Code

Fiber 文档中直接引用环境变量：

{
  "servers": {
    "fiber-ai-core": {
      "type": "http",
      "url": "https://mcp.fiber.ai/mcp",
      "headers": { "x-api-key": "${env:FIBER_API_KEY}" }
    }
  }
}

Fiber 的其他服务器

• V2（/mcp/v2）：约十个面向常见流程的精选工具；Fiber 建议大多数用户从这里开始。
• V3（/mcp/v3）：每个公开操作对应一个工具，仅支持 OAuth 登录。
• Lite（/mcp/lite）：用于搜索、计数和快速获取联系方式的较小子集。

Fiber AI MCP Server 的主要功能

• Fiber AI 官方服务器，提供 Claude、Claude Code、Cursor、VS Code、Codex、ChatGPT、Windsurf 和 Zed 的配置文档。
• 通过一套精简的工具访问整个 Fiber API，而不是数百个独立工具。
• 根据给定意图对接口进行排序推荐，并可用精选的「tag pack」缩小庞大的目录。
• 智能体调用前可按需获取完整的请求和响应结构。
• 公司、人员和职位数据、资料快照，以及工作邮箱和电话获取。
• 每个响应中的 chargeInfo 字段报告单次调用的费用。

Fiber AI MCP Server 工具

Core 服务器提供五个元工具，构成「先发现、再调用」的循环：

• 找到合适的操作：search_endpoints 针对用户意图返回最推荐的操作，并可按标签或精选 tag pack 限定范围。list_tag_packs 列出这些 tag pack（例如社交媒体或数据补全），list_all_endpoints 列出所有接口，并支持按标签或关键词筛选。
• 查看详情：get_endpoint_details_full 返回某个操作 ID 的完整结构，包括必填字段和用法示例。
• 执行：call_operation 按 operationId 执行任意 Fiber API 操作，可传入 body、path 和 query 参数。

Fiber AI MCP Server 的使用场景

• 外呼拓客：「找出纽约员工 50 到 200 人的 B 轮金融科技公司。」
• 候选人寻访：「搜索柏林在开发者工具公司工作的高级后端工程师。」
• 联系方式补全：「获取这个人资料对应的工作邮箱。」
• 公司快照：「拉取这家公司的实时快照，并总结它近期的招聘情况。」
• 构建 GTM 自动化：让编程智能体先用 search_endpoints 和 get_endpoint_details_full 探索操作，再编写集成代码。

Fiber AI MCP Server 常见问题排查

• HTTP 402 错误：你的组织额度已用完。每次 MCP 调用的扣费与对应的 API 操作相同。
• HTTP 429 错误：MCP 调用与你的脚本共享组织的每分钟速率限制。
• 客户端试图发起 OAuth：只有 V3 支持 OAuth。对于 Core，请在连接前配置好 x-api-key 请求头，避免客户端尝试 OAuth 流程。
• 参数错误或缺失：对于输入结构嵌套的操作，让智能体在 call_operation 之前先调用 get_endpoint_details_full。