# 在你的 Agent 中使用 BF Labs GEO

服务地址：https://geo.bflabs.app/mcp

使用个人 GEO API Key，通过 `Authorization: Bearer <key>` 请求头连接。密钥有授权范围和有效期，可由服务负责人撤销。不要把密钥发到聊天、截图或提交到仓库。

## Codex CLI

将服务负责人交付的私有环境文件保存在安全位置。只在可信终端中加载该文件，让 `BF_GEO_API_KEY` 进入启动 Codex 的环境，然后运行：

```sh
codex mcp add bflabs-geo --url https://geo.bflabs.app/mcp --bearer-token-env-var BF_GEO_API_KEY
```

不要运行 `codex mcp login`，此接入方式不使用浏览器 OAuth。已运行的 Codex 不一定继承新环境变量，请从加载了密钥的环境重新启动。

## WorkBuddy / CodeBuddy

添加远程 HTTP MCP，使用环境变量或客户端的安全凭据设置。支持环境变量替换的客户端配置示例：

```json
{
  "mcpServers": {
    "bflabs-geo": {
      "type": "http",
      "url": "https://geo.bflabs.app/mcp",
      "headers": { "Authorization": "Bearer ${BF_GEO_API_KEY}" }
    }
  }
}
```

客户端需要能读取 `BF_GEO_API_KEY`。配置里的占位符不是密钥；不要直接把它作为请求头发送。旧 BF Labs WorkBuddy 连接器不受此新入口影响。

## 开始使用

可以直接问：

> 帮我诊断 https://example.com，目标是让客户找到准确的产品说明。给出优先整改项和依据，先不要修改网站。

- 查方法：`geo_search`，按返回的来源阅读 `geo_source_get`。
- 初次诊断：`geo_diagnose` 只需网站首页、目标和请求标识，会自动保存项目。
- 继续整改：`geo_guidance` 返回具体任务、来源和验证方式。
- 修改后：让你的 Agent 记录真实交付物和部署凭据，再调用 `geo_retest`。
- 看报告：在 Agent 中调用 `geo_report`；需要完整记录时用 `geo_project_export`。

新诊断/复测使用新的 request_id；重试同一次请求沿用原值。不同运行可能有相同内容指纹，这仍然是两次检查。

网站准备度不等于 AI 引用或业务收入。真实回答和业务导入工具只接收你有权提供的证据；未测量的结果保持未测量。

## 连接失败

- 401：未带正确密钥，或密钥已过期、被撤销。检查 Agent 的凭据环境，或联系服务负责人。
- 403：账户授权到期/停用，或这把密钥没有对应权限。
- 429：短时间请求过多，稍后重试。
- 工具返回版本冲突：先重新读取项目，再保存，不要覆盖新版本。

诊断和复测需要 read、write、scan 权限。不要把密钥作为网址参数传递，也不要把别人的密钥作为自己的接入凭据。