把松灵机器人的产品文档接进你的 AI 编程助手。写对接代码前先查手册, 而不是猜波特率、帧格式和引脚定义。
选一个客户端,复制一行即可。全部客户端配置见下方「客户端配置」。
| 客户端 | 一行接入 |
|---|---|
| Claude Code | claude mcp add --transport http agilex-docs https://service.agilex.ai/agilex-docs/mcp |
| Codex CLI | codex mcp add agilex-docs --url https://service.agilex.ai/agilex-docs/mcp |
| VS Code | Ctrl+Shift+P → MCP: Add Server → HTTP → 填端点 |
| 只支持 stdio 的客户端 | npx -y mcp-remote https://service.agilex.ai/agilex-docs/mcp |
点上面「在 Cursor 中一键安装」会直接写入配置。手工方式:项目根目录建
.cursor/mcp.json(全局用 ~/.cursor/mcp.json)。
{
"mcpServers": {
"agilex-docs": {
"url": "https://service.agilex.ai/agilex-docs/mcp"
}
}
}
保存后 Ctrl+Shift+P → Reload Window。
在 Settings → MCP 里应看到 agilex-docs 已连接、工具数 4。
用户级(所有项目可用):
claude mcp add --transport http agilex-docs https://service.agilex.ai/agilex-docs/mcp
或写进项目里的 .mcp.json,可以提交到仓库与同事共享:
{
"mcpServers": {
"agilex-docs": {
"type": "http",
"url": "https://service.agilex.ai/agilex-docs/mcp"
}
}
}
用 claude mcp list 确认已连接。
Codex 支持 Streamable HTTP,ChatGPT 桌面端 / Codex CLI / IDE 扩展共享这份配置:
codex mcp add agilex-docs --url https://service.agilex.ai/agilex-docs/mcp
codex mcp list
或直接写 ~/.codex/config.toml:
[mcp_servers.agilex-docs]
url = "https://service.agilex.ai/agilex-docs/mcp"
进 Codex 后输入 /mcp 可查看已激活服务器。
DeepSeek Harness 通过 @deepseek-ai/dsh-mcp-client 接入,
配置形式是 Cordis overlay YAML。新建 agilex-docs.cordis.yml:
- insert:
- id: agilex-docs
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: agilex-docs
transport: streamable-http
url: https://service.agilex.ai/agilex-docs/mcp
dsh web --patch "$PWD/agilex-docs.cordis.yml"
要长期生效,把这段 insert 合并进
$DSH_HOME/cordis.patch.yml(或 profiles/<name>/ 下)。
工具在模型侧呈现为 mcp__agilex-docs__search_docs。
Claude Desktop 只支持本地 stdio,用 mcp-remote 桥接。
配置文件:macOS ~/Library/Application Support/Claude/claude_desktop_config.json,
Windows %APPDATA%\Claude\claude_desktop_config.json。
{
"mcpServers": {
"agilex-docs": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://service.agilex.ai/agilex-docs/mcp"]
}
}
}
保存后完全退出 Claude Desktop 再打开(不是关窗口)。
VS Code Copilot Chat —— 图形化:Ctrl+Shift+P →
MCP: Add Server → 选 HTTP → 填端点 → ID 起
agilex-docs。
文件方式:.vscode/mcp.json(VS Code 本地格式顶层键是
servers,不是 mcpServers):
{
"servers": {
"agilex-docs": {
"type": "http",
"url": "https://service.agilex.ai/agilex-docs/mcp"
}
}
}
Cline / Roo Code —— 在扩展的 MCP Servers → Remote Servers 里填
Name agilex-docs、URL 同上、Transport 选 Streamable HTTP。
Continue —— ~/.continue/config.yaml:
mcpServers:
- name: agilex-docs
type: streamable-http
url: https://service.agilex.ai/agilex-docs/mcp
设置 → MCP 服务器 → 添加 → 类型选 可流式传输的 HTTP(streamableHttp):
| 字段 | 值 |
|---|---|
| 名称 | agilex-docs |
| 类型 | streamableHttp |
| URL | https://service.agilex.ai/agilex-docs/mcp |
Cherry Studio 也能直接粘贴上面的 mcpServers JSON,会自动识别。
需要付费版 + 网页端(移动端不支持)。
Settings → Connectors → Advanced → 打开 Developer mode → Create:
| 字段 | 值 |
|---|---|
| Name | AGILEX Docs |
| MCP Server URL | https://service.agilex.ai/agilex-docs/mcp |
| Authentication | No authentication |
我们在下列平台登记了条目。搜产品名 agilex 或
agilex-docs 即可定位。
| 平台 | 状态 | 怎么搜 |
|---|---|---|
| 官方 MCP Registry registry.modelcontextprotocol.io |
已收录 ai.agilex.service/docs |
打开站点搜索框输入 agilex,或直接 GET/v0.1/servers?search=agilex |
| Glama glama.ai/mcp/servers |
已收录 质量评分 A(4.3/5.0) |
搜索 agilex → 条目页自带 Cursor / VS Code /
Claude Code / Codex / Gemini / Claude / JSON 七种配置 |
| MCP Hub 中国 mcp-cn.com |
已提交推荐 issue #36,审核中 |
站内搜索 agilex;收录后支持 Cursor 一键安装 |
| ModelScope 魔搭 modelscope.cn/mcp |
未收录 | 站内搜索 agilex 目前 0 条;条目需用魔搭账号创建,上线后此处更新 |
| mcp.so | 未提交 | 该站为付费收录($39 一次性),暂不投放 |
| Higress MCP Market mcp.higress.ai |
不适用 | 该市场托管由 OpenAPI 转换而来的 MCP;我们是原生 MCP 服务,不重复包装 |
不依赖任何目录也能用:端点地址是固定的,直接填进客户端即可。
来自松灵知识库中标为「互联网所有人可访问」的公开空间,当前约 346 篇文档,覆盖以下产品线:
piper · pika · nero · ranger · limo · scout · bunker · hunter · tracer · umr · cobot_magic
| 类型 | 内容 |
|---|---|
| 用户手册 | 整机参数、机械结构、接线、标定、维护 |
| 协议与接口 | CAN 2.0B 报文格式、波特率、控制指令 |
| 固件 | 版本说明、升级步骤、兼容性 |
| 技术贴 | SDK 对接、遥操作、录制回放等实战教程 |
| 售后 FAQ | 报错码、异常排查、常见故障处理 |
文档每日 05:20(北京时间)同步一次。内部空间不在对外范围内。
| 工具 | 用途 | 参数 |
|---|---|---|
search_docs | 全文检索,先用它定位 | query(建议带产品名)、limit、space |
get_doc | 读整页 Markdown,支持分页 | doc_id、max_chars、offset |
list_docs | 列某个空间的文档 | space、limit、offset |
list_spaces | 列公开空间与文档数 | — |
// 1) 检索
search_docs(query="piper CAN 波特率 报文格式", limit=3)
// 2) 读命中的手册(长文档分页)
get_doc(doc_id="01a06659-2d4e-7029-bc64-63f9352b34a6", max_chars=8000)
返回的 url 是原始页面链接,建议在回答中一并引用,方便核对原文。
给助手的提示词里明确「先查文档再写代码」效果最好,例如:
我要给 piper 机械臂写一个 CAN 控制脚本。先用 agilex-docs 的
search_docs 查「piper CAN 报文」,再用 get_doc 读命中的手册,
按手册里的帧格式和波特率写代码,并在注释里给出手册链接。
文档缺失或有误,欢迎通过 松灵机器人官网的技术支持渠道反馈,并附上页面链接。 需要更高调用配额可联系我们。