# 其他 MCP 客户端

任何支持 MCP 协议 Streamable HTTP 传输的 AI 工具都可以连接 AgentFox。

## 连接要素

连接 AgentFox 只需要三个信息：

| 要素 | 值 |
|------|-----|
| **传输类型** | HTTP（Streamable HTTP） |
| **URL** | `https://www.agentfoxapp.com/mcp/{projectId}` |
| **认证** | `Authorization: Bearer {your-api-key}` |

## 通用配置格式

大多数 MCP 客户端使用 JSON 配置：

```json
{
  "mcpServers": {
    "my-api": {
      "type": "http",
      "url": "https://www.agentfoxapp.com/mcp/{projectId}",
      "headers": {
        "Authorization": "Bearer {your-api-key}"
      }
    }
  }
}
```

## 其他已知兼容客户端

### Gemini CLI

Google 的 Gemini CLI 工具支持 MCP 协议。编辑 `~/.gemini/settings.json`：

```json
{
  "mcpServers": {
    "my-api": {
      "type": "http",
      "url": "https://www.agentfoxapp.com/mcp/{projectId}",
      "headers": {
        "Authorization": "Bearer {your-api-key}"
      }
    }
  }
}
```

### Antigravity

Antigravity AI 开发平台支持 MCP。在平台的 MCP 配置中添加 AgentFox 服务器即可。

### OpenClaw

OpenClaw AI 开发平台同样支持 MCP 协议，配置方式类似。

## 技术细节

如果你的工具需要手动实现 MCP 客户端连接，以下是关键技术参数：

| 参数 | 值 |
|------|-----|
| 协议 | MCP (Model Context Protocol) |
| 传输方式 | Streamable HTTP |
| HTTP 方法 | POST（发送请求）、GET（SSE 会话恢复）、DELETE（终止会话） |
| 会话管理 | 通过 `mcp-session-id` 响应头建立，后续请求携带 |
| 认证方式 | HTTP Bearer Token |
| Content-Type | `application/json` |

## 自检清单

如果连接不成功，请检查：

- [ ] 传输类型是 `http`（不是 `sse` 或 `stdio`）
- [ ] URL 包含正确的 projectId
- [ ] API Key 以 `afk_` 开头
- [ ] Authorization 头格式为 `Bearer {key}`（注意 Bearer 后有空格）
- [ ] 网络可以访问 `www.agentfoxapp.com`