Codex 接入蓝朋友 MCP:安装、配置与首次查询
把蓝朋友的 X 数据接入 Codex(MCP):从创建 API Key 到第一次查询,附可复制配置和常见问题。
XBlueV · 2026-11-05
① 创建 Key
② 配置 MCP
③ 连接 Agent
④ 查询 X 数据
1. 准备账号、Key 与运行环境
登录蓝朋友,在开发者页面创建 API Key,并确认账号有可用积分。Key 不要写进聊天消息或公开代码。发现 MCP 工具免费,真实查询按请求和结果计费。
服务地址:https://xbluev.com/api/mcp。选择 Streamable HTTP,使用蓝朋友 API Key,不是模型平台的密钥。
2. 添加 MCP 服务
将下方 TOML 合并到 ~/.codex/config.toml,不要覆盖已有服务。
在启动 Agent 的环境中设置密钥,随后重启 Agent。已经打开的桌面应用不会自动继承新终端变量。
PowerShell
$env:XBLUEV_API_KEY = 'xbv_YOUR_KEY'macOS / Linux
export XBLUEV_API_KEY='xbv_YOUR_KEY'[mcp_servers.xbluev]
url = "https://xbluev.com/api/mcp"
bearer_token_env_var = "XBLUEV_API_KEY"
tool_timeout_sec = 60把 xbv_YOUR_KEY 替换为你的 Key。复制按钮只复制示例,不会读取你的密钥。
3. 验证与首次查询
运行 codex mcp list 确认服务已注册,再在新会话中查看可用工具。
用 XBlueV 查询 elonmusk 的资料,只请求一页,显示粉丝数、来源和消耗积分。预期返回资料和积分信息。这一步会真实扣费;发现工具成功不代表 Key 和余额已验证。
4. 排错与卸载
- 401:检查请求头或环境变量,确认 Key 未删除,重启 Agent。402:补充积分。429:按 Retry-After 等待或等待每日额度重置。
- Skill 未出现:检查目录层级和 SKILL.md。执行失败:检查 Python、网络及命令权限。不要自动重复付费请求。
- MCP 连接失败:确认 /api/mcp 和 Streamable HTTP,不要选旧版 SSE 或 OAuth。
- 卸载:移除对应 Skill 文件夹或 MCP 的 xbluev 配置;WorkBuddy 可从已安装列表移除。密钥泄露时,在开发者页面删除 Key。
另一种接入方式
客户端官方文档 ↗ · 核对日期:2026-11-05
继续阅读
Claude Code 接入蓝朋友 MCP:安装、配置与首次查询
Claude Code 接入蓝朋友 SKILL:安装、配置与首次查询
WorkBuddy 接入蓝朋友 MCP:安装、配置与首次查询