MCP 接入指南

什么是 MCP?

MCP (Model Context Protocol) 是 Anthropic 推出的开放协议,让 AI 助手能够连接外部工具。通过 xPilot 的 MCP 服务器,您可以直接在 Claude Desktop、Claude Code 或任何兼容 MCP 的客户端中生成图片、视频和社交媒体帖子。

可用工具

工具说明
list_models列出全部 49 款 AI 模型(13 款免费),按文本/图片/视频分类
generate_imageAI 文生图,支持 FLUX、Seedream 等(含免费模型)
generate_videoAI 视频生成 — 文生视频和图生视频(Seedance、Wan、Kling)
generate_post生成 X (Twitter) 社交媒体帖子
check_task查询图片/视频生成任务状态
1

获取 API Key

前提条件

  1. 在 xPilot 注册或登录:xpilot.jytech.us
  2. 进入 设置 → API Keys,点击「创建新密钥」
  3. 复制您的 API Key(以 xp_ 开头)。密钥仅显示一次,请妥善保存。

新账户赠送 $5 平台点数 — 足够体验所有 MCP 工具。

2

在 Claude Desktop 中连接

添加 xPilot 为 MCP 服务器

打开 Claude Desktop 配置文件,添加 xPilot 服务器:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json{
  "mcpServers": {
    "xpilot": {
      "url": "https://xpilot.jytech.us/api/mcp",
      "headers": {
        "Authorization": "Bearer xp_your_api_key_here"
      }
    }
  }
}

将 xp_your_api_key_here 替换为您的实际 API Key。保存后重启 Claude Desktop。

3

在 Claude Code 中连接

添加到 Claude Code 设置

添加到 Claude Code 的 settings.json(或项目的 .mcp.json):

json{
  "mcpServers": {
    "xpilot": {
      "type": "url",
      "url": "https://xpilot.jytech.us/api/mcp",
      "headers": {
        "Authorization": "Bearer xp_your_api_key_here"
      }
    }
  }
}
4

使用示例

在 Claude 中尝试以下指令

查看模型

xPilot 有哪些 AI 模型?给我看看免费的。

生成图片

用免费的 FLUX 模型生成一张未来城市日落天际线的图片。

生成视频

生成一段 5 秒的海浪拍打岩石的视频。

生成帖子

写一条关于 AI 营销最新趋势的推文,带上 hashtag。

服务器端点

端点类型认证
https://xpilot.jytech.us/api/mcpNext.jsBearer Token
https://xpilot-mcp.<account>.workers.devCloudflare WorkerBearer Token

两个端点支持相同的 MCP 工具。Cloudflare Worker 端点在全球边缘部署,响应更快。

发现与标准

xPilot 遵循标准 AI 发现协议:

  • GET /api/mcpMCP 服务器发现(工具、资源、传输信息)
  • /.well-known/ai-plugin.jsonOpenAI 插件清单,供 AI 平台发现
  • /llms.txt纯文本平台描述,供 LLM 爬虫使用

常见问题

「无效或缺少 API Key」

确保您的 API Key 以 xp_ 开头且未被撤销。在 xPilot 的 设置 → API Keys 中检查。

Claude 中看不到工具

编辑配置文件后需重启 Claude Desktop。检查 JSON 语法是否正确。

视频任务显示「处理中...」

视频生成需要 1-5 分钟。使用 check_task 工具配合任务 ID 查询完成状态。

超出速率限制

API 限制每个 Key 每分钟 30 次请求。请稍等片刻后重试。