01三步接入
01
申请密钥
在密钥门户完成账号绑定,由智匠云官方发放 zj_ext_ 前缀的 Bearer 密钥。统一权限:密钥必须绑定智匠云账号,工具权限与该账号在网页端的权限完全同源;未绑定账号的密钥只能使用公开目录工具。
02
配置客户端
把下方 JSON 加入 WorkBuddy / Claude / Cursor / Cline 的 MCP 配置(mcp.json),替换为你的密钥。
03
调用工具
连接成功后,tools/list 会按你的账号自动过滤可用工具——普通账号可见只读工具与 GPU 工作负载工具,基础设施工具仅真实管理员可见。自然语言提问即可。
{
"mcpServers": {
"zhijiangyun-public-mcp": {
"url": "https://mcp.artibot.cloud/mcp",
"headers": {
"Authorization": "Bearer zj_ext_xxxxxxxxxxxxxxxx"
}
}
}
}
02可用工具(按账号权限自动过滤)
公开目录工具(无需绑定账号)
get_service_status
查询智匠云公开 MCP 服务状态。不读取项目数据,也不会创建任务或产生费用。
list_public_capabilities
列出当前已启用的公开 MCP 工具与各自的最小授权范围。不会返回内部管理工具。
list_public_task_templates
列出可公开查看的训练任务模板(任务名、中文标题、类别、适用机器人),人工审核后对外展示。
平台能力工具(以绑定账号身份执行,数据可见范围与网页端一致)
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 时长与预算,与网页端同一套计费与配额校验。
统一权限:密钥必须绑定智匠云账号,
tools/list 按账号自动过滤——未绑定账号的密钥只能使用公开目录工具;普通账号可使用平台只读工具与 GPU 工作负载工具(调用时执行与网页端同源的套餐/配额校验);基础设施工具仅真实管理员可见。执行类工具会消耗账号订阅的 GPU 时长与预算额度。03接入信息
| 项目 | 值 |
|---|---|
| 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 <密钥>(密钥绑定智匠云账号) |
| 权限模型 | 统一权限:工具权限与网页端同源(platform:read / platform:write,管理员工具与网页端 adminOnly 一致) |
| 密钥申请 | mcp.artibot.cloud/keys(自助即时发放,每 IP 每天最多 5 个) |
| 限速 | 每客户端 30 次/分钟;网关层每 IP 30 次/分钟 |
| 错误码与排查 | 401 MISSING_OR_INVALID_API_CLIENT / 401 INVALID_OR_EXPIRED_API_CLIENT / 403 INSUFFICIENT_SCOPE / 403 IP_NOT_ALLOWED / 429 RATE_LIMITED / 503 PUBLIC_MCP_DISABLED;响应均携带 request_id |
curl 原始协议验证
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"}}}'
04关于智匠云
智匠云(ArtiBot Cloud)是零代码具身智能机器人技能云端训练平台:AI 场景生成、智能数据采集(LeRobot 兼容)、云端模型训练(ACT / Diffusion Policy / SmolVLA / Pi0)、仿真验证与真机部署,全程浏览器完成。当前平台已接入机型:智元精灵 G2、智元 G1、灵犀 X1、宇树 H1、宇树 R1、宇树 Go2、宇树 Z1、SO-ARM101,并支持经通用适配流水线验证的自定义机型(如 KUKA/LBR iiwa、FANUC LR Mate 200iB 等)。