CustomGPT MCP Server 是一个开源的全功能 Model Context Protocol（MCP）服务器，旨在提供对 CustomGPT.ai API 的无缝访问。通过该服务器，用户可以直接在 Claude Code、Claude Web 以及任何兼容 MCP 的客户端中与自己的 CustomGPT 智能体进行交互。
用途
该服务器作为 CustomGPT.ai 的 MCP 接口，让用户能够通过兼容 MCP 的客户端（如 Claude Code、Claude Web）管理智能体、进行对话、管理内容以及查阅 API 文档。
主要能力
- 智能体管理：列出所有智能体（支持分页）、获取特定智能体的详细信息、从站点地图或文件创建新智能体、获取使用统计（页面数、对话指标）、查看和配置智能体行为与外观。
- 对话管理：使用 OpenAI 兼容格式向智能体发送消息、列出任意智能体的对话历史、检索完整的对话记录。
- 内容管理：列出智能体的所有页面/来源、检查爬取和索引状态、管理站点地图和上传的文件。
- API 文档集成：搜索相关 API 端点和文档、获取特定 API 端点的详细信息、内置带示例的 API 参考。
- 安全与隐私：API 密钥掩码（日志中仅显示最后 4 位）、内置 API 密钥验证和格式检查、无状态设计（密钥永不永久存储）。
使用方式
环境要求
- Python 3.10+（FastMCP 所需）
- 有效的 CustomGPT.ai API 密钥（从 CustomGPT Dashboard 获取）
- 兼容 MCP 的客户端（Claude Code、Claude Web 等）
部署选项
- Railway（推荐）：提供自动 HTTPS、自定义域名和轻松扩展。点击 Railway 按钮，设置环境变量，一键部署。
- Vercel：适用于较轻负载的无服务器部署。安装 Vercel CLI（
npm i -g vercel），在 Vercel 仪表板设置环境变量。 - Docker：适用于任何平台的容器化部署。
- 本地开发：在项目根目录创建
.env文件，配置环境变量。
MCP 客户端配置
- 在 MCP 设置中添加服务器地址（如
https://your-deployed-server.railway.app），并配置 CustomGPT API 密钥。 - 对于 Claude Web：进入设置，添加 MCP 服务器，配置 API 密钥。
可用工具
- 智能体工具：列出智能体、获取智能体详情、创建智能体。
- 对话工具：发送消息、列出对话。
- 内容工具：列出页面/来源、获取统计、获取设置。
- 文档工具：搜索 API 文档、获取端点详情、验证 API 密钥。
安全注意事项
- API 密钥在所有日志中被掩码（仅显示最后 4 位），永不持久存储，每次请求独立验证。
- 生产环境建议启用 HTTPS、配置 CORS、监控日志、定期轮换 API 密钥。
故障排除
- 确保 API 密钥格式正确，无多余空格或字符，来自 CustomGPT.ai 仪表板。
- 检查 API 密钥权限，尝试重新生成。
- 检查网络连接、CustomGPT.ai 服务状态、防火墙设置。
- 确保
docs/openapi.json存在且有效。 - 可通过设置
DEBUG=true启用调试日志。 - 健康检查端点：
/health（基本健康）、/api/v1/health（带版本信息的 API 健康）。
适用场景
适用于需要通过 MCP 客户端（如 Claude Code、Claude Web）管理 CustomGPT.ai 智能体、进行对话交互、管理内容以及查阅 API 文档的开发者和用户。
限制
- 项目仍处于测试阶段（beta）。
- 需要 Python 3.10+ 环境。
- 需要有效的 CustomGPT.ai API 密钥。
- 需要兼容 MCP 的客户端。
其他信息
- 许可证：MIT
- 文档：https://docs.customgpt.ai/mcp
- 联系：hello@customgpt.ai
- 未来计划：流式支持、文件上传、Webhook 集成、多租户、速率限制、缓存。
