yuque-mcp

接続後は、アシスタントに次のようなことを頼めます。

「Yuque でカナリアリリースに関する内容をすべて検索して、1 ページにまとめてください。」

「今日の会議メモを、Tech Research の本にドキュメントとして追加してください。」

「このデプロイパイプラインのフローチャートを設計ドキュメントに追加してください。」

クイックスタート

1. トークンを取得する — Yuque Developer Settings で作成します。Yuque スペースに紐づいたチームトークンを使用する場合は、スペースのホスト（例：https://your-space.yuque.com）も控えてください。これは --host として指定します。

2. インストールする — 1 つのコマンドで、OS に応じた設定ファイルを見つけ、他のサーバーに触れることなく yuque エントリを追加します。

npx yuque-mcp install --token=YOUR_TOKEN --client=cursor

対応クライアント：claude-desktop · vscode · cursor · windsurf · cline · trae · qoder · opencode。対話形式で設定する場合は、npx yuque-mcp setup を実行してください。

claude mcp add yuque -- npx -y yuque-mcp --token=YOUR_TOKEN

{
  "mcpServers": {
    "yuque": {
      "command": "npx",
      "args": ["-y", "yuque-mcp"],
      "env": { "YUQUE_TOKEN": "YOUR_TOKEN" }
    }
  }
}

3. クライアントを再起動して、使い始めましょう。

設定

サイトのルートは /api/v2 に正規化されます。未設定の場合、ホストは https://www.yuque.com/api/v2 がデフォルトになります。

# Team token / private deployment
npx yuque-mcp install --token=YOUR_TOKEN --client=cursor --host=https://your-space.yuque.com

各ツールは、Yuque API のルートにそれぞれ1つだけ対応しています。

特に、yuque_update_doc では、Markdown 本文と title／slug／public の変更を1回の呼び出しで組み合わせることはできません。メタデータは別途更新してください。YMD Markdown API と従来のドキュメント API 間のフォーマットルーティングを含む完全な仕様については、docs/capability-scope.md を参照してください。

未対応の機能： コメント、添付ファイルのアップロードとファイル管理、権限およびメンバーの管理、ドキュメントのセクション単位の編集、ボード以外の構造化リソース。

書き込みアクセス

作成／更新ツールはナレッジベースの実際のコンテンツを変更します。また、サーバーはトークンで許可されている操作をすべて実行できます。トークンは秘密に保管し、1つのスペース内でのみ作業する場合は、スペースにスコープを限定したチームトークン（YUQUE_HOST を指定）を使用してください。脆弱性を報告するには、SECURITY.md を参照してください。

トラブルシューティング

開発

git clone https://github.com/yuque/yuque-mcp-server.git
cd yuque-mcp-server
npm install
npm test              # run tests
npm run build         # compile TypeScript
npm run dev           # dev mode with hot reload

アーキテクチャ、技術スタック、ツールの完全な契約はdocs/に記載されています。貢献を歓迎します。CONTRIBUTING.mdをご覧ください。

リンク

• Yuque API ドキュメント
• Model Context Protocol
• Yuque AI Ecosystem — このサーバー上に構築されたスキルとプラグイン

ライセンス

MIT