AGILEX Docs

AGILEX Docs MCP

**AgileX Robotics（松灵机器人）**の公式製品ドキュメントです。ユーザーマニュアル、 CAN 2.0B プロトコルリファレンス、ファームウェアの注意事項、SDK の技術記事、アフターサービス FAQ を、 piper、pika、nero、ranger、limo、scout、bunker、hunter、tracer、 umr、cobot_magic、aloha向けに提供します。

AgileX ハードウェアの連携コードを書く前に、AI コーディングアシスタントをこのサーバーに接続してください。 推測でボーレート、フレーム形式、ピン配置を決めるのではなく、実際のマニュアルを参照できるようになります。

このリポジトリは公開されている仕様であり、実装ではありません。 エンドポイント、ツールのシグネチャ、各クライアントの設定を記載しています。 インデックスサービス自体は非公開です。Cloudflare、Sentry、Linear がリモート MCP サーバーを公開しているのと同様です。

エンドポイント

API キーも OAuth もローカルプロセスも不要です。クライアントが Streamable HTTP に対応していれば、 URL を指定するだけです。

クイックスタート

# Claude Code
claude mcp add --transport http agilex-docs https://service.agilex.ai/agilex-docs/mcp

# Codex CLI  (writes ~/.codex/config.toml)
codex mcp add agilex-docs --url https://service.agilex.ai/agilex-docs/mcp

Cursor — ワンクリック：

cursor://anysphere.cursor-deeplink/mcp/install?name=agilex-docs&config=eyJ1cmwiOiJodHRwczovL3NlcnZpY2UuYWdpbGV4LmFpL2FnaWxleC1kb2NzL21jcCJ9

mcpServersを読み取るクライアント（Claude Desktop、Cline、Windsurf、Cherry Studio、 Continue、Zed、LibreChat、Dify …）：

{
  "mcpServers": {
    "agilex-docs": {
      "url": "https://service.agilex.ai/agilex-docs/mcp"
    }
  }
}

クライアントごとの詳しい手順：docs/CLIENTS.md。

ツール

読み取り専用ツールが 4 つあります。モデルがスキーマを先に読まなくても適切なツールを選べるよう、 名前は意図的にverb_noun形式にしています。

search_docsはdoc_id、title、space、url、score、charsとスニペットを返します。 doc_idをget_docに渡してください。応答にtruncated: trueが含まれる場合は、 next_offsetを指定してget_docを再度呼び出してください。

応答形式

// search_docs("piper CAN 波特率")
{
  "query": "piper CAN 波特率",
  "count": 3,
  "results": [
    {
      "doc_id": "01a06659-2d4e-7029-bc64-63f9352b34a6",
      "title": "PIPER X 用户手册(CN)",
      "space": "AGX-机械臂产品手册",
      "url": "https://kb.agilex.ai/s/agx-robot-arm-products-cn-en/p/pWVjLJsYc0",
      "score": 18.42,
      "chars": 13264,
      "snippet": "...CAN通信标准采用的是CAN2.0B标准，通讯波特率为1000K..."
    }
  ]
}

// get_doc(doc_id="01a06659-…", max_chars=2000)
{
  "doc_id": "01a06659-2d4e-7029-bc64-63f9352b34a6",
  "title": "PIPER X 用户手册(CN)",
  "url": "https://kb.agilex.ai/s/agx-robot-arm-products-cn-en/p/pWVjLJsYc0",
  "chars": 13264,
  "offset": 0,
  "truncated": true,
  "next_offset": 2000,
  "content": "..."
}

urlは常に元の Docmost ページを指します。ユーザーが確認できるよう、引用してください。

クライアント設定

{
  "mcpServers": {
    "agilex-docs": {
      "url": "https://service.agilex.ai/agilex-docs/mcp"
    }
  }
}

# all projects
claude mcp add --transport http agilex-docs https://service.agilex.ai/agilex-docs/mcp

# this project only (writes .mcp.json, can be committed)
claude mcp add --scope project --transport http agilex-docs https://service.agilex.ai/agilex-docs/mcp

claude mcp list

codex mcp add agilex-docs --url https://service.agilex.ai/agilex-docs/mcp

[mcp_servers.agilex-docs]
url = "https://service.agilex.ai/agilex-docs/mcp"

- 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/examples/agilex-docs.cordis.yml"

{
  "mcpServers": {
    "agilex-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://service.agilex.ai/agilex-docs/mcp"]
    }
  }
}

{
  "servers": {
    "agilex-docs": {
      "type": "http",
      "url": "https://service.agilex.ai/agilex-docs/mcp"
    }
  }
}

プロンプトの例

piper アーム用の CAN 制御スクリプトが必要です。まず「piper CAN 报文」で search_docs を呼び出し、 最も適切な検索結果に対して get_doc を実行して、マニュアルに記載された フレーム形式とボーレートを使ってコードを書いてください。コメントにマニュアルの URL を引用してください。

ranger mini でシャーシのエラーコードが発生します。アフターサービス FAQ で そのコードを検索し、トラブルシューティングの手順を引用してページへのリンクを示してください。

サーバーには、先に検索して URL を引用するようモデルに指示する instructions ブロックが含まれているため、 通常は追加のプロンプトなしでこのワークフローが実行されます。

対象範囲とデータ

コーパスは、「互联网所有人可访问」 と表示された Docmost スペースから構築されています。これらはすでに https://kb.agilex.ai で公開されています。「内部」／「非对外」と表示されたスペースにはアクセスできません。 クローラーは Docmost の匿名共有エンドポイントのみを使用し、認証を行わないため、バグがあっても内部コンテンツが漏れることはありません。

新しい公開スペースは自動的に追加され、共有が取り消されたスペースは次回の同期時に除外されます。

レート制限

より高い利用上限や専用エンドポイントについては、AgileX にお問い合わせください（フィードバックを参照）。

制限事項

• 読み取り専用です。 書き込みツールはありません。このツールからロボットを動かすことはできません。
• 画像は本文に埋め込まれません。 Docmost は短い TTL で添付ファイル URL に署名するため、スナップショットを配信すると無効なリンクになってしまいます。画像は （图：caption） として表示されます。画像を見るには、ページの url を開いてください。
• 公開スペース内の バイナリ添付ファイル（PDF/XLSX）は解析されません。ページ本文のみが対象です。
• 語句による照合であり、意味による照合ではありません。BM25 + CJK バイグラムを使用します。用語が見つからない場合は、表現を変えてください。
• クエリごとに 1 つの製品ファミリーを指定するのが最適です。複数の製品にまたがる質問には、複数回検索する必要があります。

動作確認

# health
curl -s https://service.agilex.ai/agilex-docs/health | jq

# MCP handshake
curl -s -X POST https://service.agilex.ai/agilex-docs/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}' | jq

# full round trip (initialize → tools/list → tools/call)
./scripts/smoke-test.sh

リポジトリの構成

README.md                    this file
server.json                  official MCP Registry manifest
LICENSE                      MIT (documentation + manifest)
docs/CLIENTS.md              per-client setup, long form
examples/                    copy-paste configs per client
scripts/smoke-test.sh        end-to-end check against the live endpoint

フィードバック

ドキュメントの欠落や誤りについては、AgileX サポート（https://www.agilex.ai/）に問い合わせ、 該当ページの URL を添えてください。

このリポジトリ（マニフェスト、ドキュメント、クライアント設定）に関する問題は、こちらで Issue を作成してください。 ドキュメントの内容に関する問題は、ドキュメントが内部ナレッジベースに保存されており、このリポジトリから編集できないため、 サポート窓口にお問い合わせください。

ライセンス

MIT — LICENSEを参照してください。このライセンスは、このリポジトリ内のドキュメントとマニフェストに適用されます。MCP 経由で提供されるドキュメントのコンテンツは、AgileX Robotics の所有物です。