01接入信息

项目	值
MCP 端点（推荐）	`https://mcp.artibot.cloud/mcp`
MCP 端点（备用路径）	`https://www.artibot.cloud/public-mcp`
健康检查（无需认证）	`https://mcp.artibot.cloud/health`
传输协议	Streamable HTTP（MCP 2025-03-26 及以上）
认证方式	`Authorization: Bearer <密钥>`
密钥格式	`zj_ext_` 前缀，由智匠云官方发放

02快速开始

通用 MCP 客户端（WorkBuddy / Claude / Cursor / Cline 等）

在客户端的 MCP 配置（如 mcp.json）中加入：

{
  "mcpServers": {
    "zhijiangyun-public-mcp": {
      "url": "https://mcp.artibot.cloud/mcp",
      "headers": {
        "Authorization": "Bearer zj_ext_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

curl 原始协议验证

# ① 初始化会话（从响应头取 mcp-session-id）
curl -D - -X POST https://mcp.artibot.cloud/mcp \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0.0"}}}'

# ② 后续请求带上 mcp-session-id 头，调用工具
curl -X POST https://mcp.artibot.cloud/mcp \
  -H "Authorization: Bearer $KEY" \
  -H "mcp-session-id: <第①步返回的会话ID>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_service_status","arguments":{}}}'

03可用工具

统一权限：tools/list 按你的账号自动过滤——普通账号可见只读工具与 GPU 工作负载工具（调用时执行与网页端同源的套餐/配额校验）；Docker/环境类基础设施工具仅真实管理员账号可见；未绑定账号的密钥只能使用公开目录工具。

get_service_status

查询公开 MCP 服务状态。不读取项目数据，也不会创建任务或产生费用。

list_public_capabilities

列出当前已启用的公开 MCP 工具与各自的最小授权范围。不会返回内部管理工具。

list_public_task_templates

列出可公开查看的训练任务模板（任务名、中文标题、类别、适用机器人）。人工审核后对外展示。

scope 说明：capabilities:read（公开目录）· platform:read（平台只读工具）· platform:write（训练/推理/基准等 GPU 工作负载工具，调用时做同源配额校验）。

平台能力工具（以绑定账号身份执行，数据可见范围与网页端一致）

get_inference_status / get_eval_scores / get_eval_sessions / get_checkpoints

推理状态、评测分数、评测历史、模型检查点查询（仅本人数据）。只读。

network_precheck / list_robots / list_recorded_videos / get_recording_video_url

网络预检、机器人目录、本人录制视频目录与链接。只读。

start_data_collection

以当前账号身份按任务模板启动一次自动数据采集（独占仿真环境 + 录制）。消耗账号 GPU 时长，配额校验与网页端同源；产出自动登记为私有数据资产。

start_training / manage_inference / run_benchmark

以当前账号身份启动训练、管理推理、运行基准评估。消耗该账号的订阅 GPU 时长与预算，与网页端同一套计费与配额校验。

manage_docker / setup_environment

Docker 容器管理与环境配置。仅真实管理员账号可用（与网页端 adminOnly 一致，模拟管理员不提权）。

示例返回（get_service_status）

{
  "service": "智匠云公开 MCP",
  "status": "operational",
  "release_stage": "unified_permissions",
  "transport": "streamable_http",
  "authentication": "account_bound_bearer_key",
  "permission_model": "same_as_web_ui"
}

04限制与安全边界

统一权限：GPU 工作负载按绑定账号的套餐/配额/豁免执行，与网页端同源判定；基础设施操作仅真实管理员。
限速：每客户端 30 次/分钟（超限返回 429 RATE_LIMITED）；网关层另有每 IP 30 次/分钟限制。
审计：每次调用（含被拒绝的请求）都会记录审计事件，可申请获取调用记录。
密钥：请妥善保管；泄露时联系发放方立即吊销并可重发。

05错误码

HTTP	code	含义
401	`MISSING_OR_INVALID_API_CLIENT`	未携带或格式错误的密钥
401	`INVALID_OR_EXPIRED_API_CLIENT`	密钥已吊销或过期
403	`INSUFFICIENT_SCOPE`	缺少 `capabilities:read` scope
403	`IP_NOT_ALLOWED`	命中 IP 白名单限制
429	`RATE_LIMITED`	触发限速
503	`PUBLIC_MCP_DISABLED`	服务处于禁用状态

排查提示：所有错误响应均携带 request_id，反馈问题时请一并提供。

06路线图（预览期之后）

更多只读查询工具（任务状态、公开模型目录等）
项目级配额与计费（quotes / reservations 机制已预留）
密钥自助续期与到期提醒