88 lines
2.5 KiB
Markdown
88 lines
2.5 KiB
Markdown
# 客户端配置概述
|
||
|
||
AgentFox 使用 MCP 协议的 Streamable HTTP 传输方式，兼容所有支持 MCP 的 AI 工具。
|
||
|
||
## 通用配置模板
|
||
|
||
所有 MCP 客户端都使用类似的 JSON 配置格式：
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"my-api": {
|
||
"type": "http",
|
||
"url": "https://www.agentfoxapp.com/mcp/{projectId}",
|
||
"headers": {
|
||
"Authorization": "Bearer {your-api-key}"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 配置字段说明
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `mcpServers` | MCP 服务器配置的顶层对象 |
|
||
| `my-api` | 服务器名称，可自定义（建议使用 API 名称，如 `stripe-api`） |
|
||
| `type` | 传输类型，必须为 `http` |
|
||
| `url` | MCP 服务 URL，从项目详情的 MCP 标签页复制 |
|
||
| `headers.Authorization` | 认证头，格式为 `Bearer {你的API-Key}` |
|
||
|
||
### 获取配置信息
|
||
|
||
1. 登录 [AgentFox 控制台](https://www.agentfoxapp.com)
|
||
2. 进入项目详情页 → 「MCP」标签
|
||
3. 复制 MCP 服务 URL
|
||
4. 从「设置」中获取 API Key
|
||
|
||
> **提示**：MCP 标签页中有预生成的配置代码片段，可一键复制。
|
||
|
||
## 多项目配置
|
||
|
||
如果你有多个项目，可以在 `mcpServers` 中添加多个服务器：
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"stripe-api": {
|
||
"type": "http",
|
||
"url": "https://www.agentfoxapp.com/mcp/project-id-1",
|
||
"headers": {
|
||
"Authorization": "Bearer afk_your-api-key"
|
||
}
|
||
},
|
||
"github-api": {
|
||
"type": "http",
|
||
"url": "https://www.agentfoxapp.com/mcp/project-id-2",
|
||
"headers": {
|
||
"Authorization": "Bearer afk_your-api-key"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 支持的客户端
|
||
|
||
| 客户端 | 类型 | 配置指南 |
|
||
|--------|------|---------|
|
||
| [Claude Desktop](claude-desktop.md) | 桌面应用 | JSON 配置文件 |
|
||
| [Claude Code](claude-code.md) | CLI 工具 | 项目级或全局配置 |
|
||
| [Cursor](cursor.md) | AI 编辑器 | 设置或配置文件 |
|
||
| [Windsurf](windsurf.md) | AI 编辑器 | JSON 配置文件 |
|
||
| [GitHub Copilot](github-copilot.md) | VS Code 扩展 | VS Code 配置 |
|
||
| [Cline](cline.md) | VS Code 扩展 | 扩展设置 |
|
||
| [Codex](codex.md) | CLI 工具 | CLI 参数或配置文件 |
|
||
| [其他客户端](other-clients.md) | — | 通用配置 |
|
||
|
||
## 连接排障
|
||
|
||
如果连接失败，请检查：
|
||
|
||
1. **URL 是否正确**：确认 projectId 无误
|
||
2. **API Key 是否有效**：确认 Key 未被轮换
|
||
3. **网络是否通畅**：确认能访问 `www.agentfoxapp.com`
|
||
4. **配置格式**：确认 `type` 为 `http`（不是 `sse` 或 `stdio`）
|