远程 MCP

用 MCP 地址和 API Key 把 Aibubu 接入 Claude Code、Codex、Cursor、VS Code、Cherry Studio 和 Claude Desktop，无需安装本地包。

Aibubu 提供远程 MCP 服务，使用 Streamable HTTP 传输，用 API Key 鉴权：

项	值
地址	`https://aibubu.cn/mcp`
鉴权	请求头 `Authorization: Bearer sk_aibubu_xxx`
权限	读取类工具需要 `v1:read`；上传和生成需要 `v1:generate`

MCP 和 /v1 接口共用同一套鉴权、计费和每日积分上限。

提供的工具

工具	类型	作用
`list_models`	读取	列出可用模型，可按 `image`、`video`、`text` 或关键词筛选
`get_model`	读取	查看某个模型的参数 schema 和价格说明
`quote`	读取	按参数预估积分，不创建任务
`get_balance`	读取	查询可用积分
`upload_image`	写入	上传 base64 编码的参考图（单次请求最大 30 MiB，图片本身约 22 MB 以内），返回约 15 分钟内有效的 URL，供下一次生成使用
`generate_image`	写入，消耗积分	提交图片生成任务；可传 `idempotency_key`，网络重试时不会重复下单
`generate_video`	写入，消耗积分	提交视频生成任务
`get_task`	读取	查询任务状态和结果
`wait_task`	读取	在服务端等待任务最多约 60 秒；未完成时返回当前状态，可再次调用

生成类工具会标注为写入操作，多数客户端在调用前会请你确认。

配置客户端

以下示例都从环境变量 AIBUBU_API_KEY 读取 Key。先在终端里设置：

export AIBUBU_API_KEY=sk_aibubu_your_api_key

Claude Code

claude mcp add --transport http aibubu https://aibubu.cn/mcp \
  --header "Authorization: Bearer $AIBUBU_API_KEY"

执行后用 claude mcp list 确认 aibubu 已连接。

Codex

编辑 ~/.codex/config.toml：

[mcp_servers.aibubu]
url = "https://aibubu.cn/mcp"
bearer_token_env_var = "AIBUBU_API_KEY"

Cursor

编辑 ~/.cursor/mcp.json（全局）或项目里的 .cursor/mcp.json：

{
  "mcpServers": {
    "aibubu": {
      "url": "https://aibubu.cn/mcp",
      "headers": {
        "Authorization": "Bearer ${env:AIBUBU_API_KEY}"
      }
    }
  }
}

VS Code

在项目里创建 .vscode/mcp.json。下面的写法会在首次连接时弹窗让你输入 Key，Key 不会写进文件：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "aibubu-api-key",
      "description": "Aibubu API Key",
      "password": true
    }
  ],
  "servers": {
    "aibubu": {
      "type": "http",
      "url": "https://aibubu.cn/mcp",
      "headers": {
        "Authorization": "Bearer ${input:aibubu-api-key}"
      }
    }
  }
}

Cherry Studio

在「设置 → MCP 服务器 → 添加服务器」中：

类型选择「可流式传输的 HTTP（streamableHttp）」
URL 填 https://aibubu.cn/mcp
请求头填 Authorization=Bearer sk_aibubu_your_api_key

Claude Desktop

Claude Desktop 的配置文件只支持本地命令，需要用 mcp-remote 转接（需要 Node.js）。编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "aibubu": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://aibubu.cn/mcp", "--header", "Authorization:${AIBUBU_AUTH}"],
      "env": {
        "AIBUBU_AUTH": "Bearer sk_aibubu_your_api_key"
      }
    }
  }
}

Authorization: 和 ${AIBUBU_AUTH} 之间不要加空格，空格放在环境变量的值里。

验证

对客户端说：

用 aibubu 查一下有哪些视频模型，再看看我的积分余额

能返回模型列表和余额，说明连接正常。

常见问题

现象	处理
连接失败，提示 `401`	Key 没有传到请求头。检查环境变量是否在启动客户端的环境里生效
生成工具返回 `scope_forbidden`	Key 没有 `v1:generate` 权限
生成工具返回 `insufficient_credits`	积分不足，充值后重试
`wait_task` 返回任务仍在运行	正常现象。视频任务通常需要几分钟，让客户端继续调用 `wait_task` 或 `get_task`

远程 MCP

本页目录