---
title: Docs MCP
description: エディタから MCP を使って Orchestor のドキュメントを検索し、本文を読みます。
canonical_url: https://orchestor.io/docs/learn/docs-mcp
markdown_url: https://orchestor.io/docs/learn/docs-mcp.md
contentType: how-to
---

# Docs MCP

Orchestor は、公開ドキュメントを検索・取得するための読み取り専用 MCP サーバーを提供しています。アカウントや API キーは不要です。

**サーバー URL（Streamable HTTP）**

```text
https://orchestor.io/docs/api/mcp
```

## できること

- `docs_search` で公開ドキュメントを検索し、関連ページを見つけます。
- `docs_get_page` で検索結果の `path`、または `resourceUri` の値を `uri` に指定し、Markdown の本文を取得します。
- 操作手順や設定例を、作業中のエージェントのコンテキストに取り込みます。

> **Note**
> 
> Docs MCP はドキュメント専用です。ワークスペースのデータ取得や変更には、認証して使う [Orchestor MCP](https://orchestor.io/docs/mcp.md) を利用してください。

## 検索・本文取得・引用の流れ

1. `docs_search` に短い検索語を渡します。`locale` で `ja` または `en`、`limit` で取得件数（最大 20 件）を指定できます。
2. 検索結果の `path` を `docs_get_page` に渡し、Markdown の本文を読みます。`resourceUri` の値を `uri` に指定しても取得できます。
3. 本文で確認できた内容を回答し、結果の `url` または本文の `canonical_url` を出典として示します。

検索結果の抜粋だけで仕様を判断せず、本文を取得してください。本文で確認できない点は、不明であることを伝えます。

## クイックスタート

利用するエディタを選び、サーバーを登録します。

### Codex

Codex CLI で追加します。CLI と IDE 拡張は同じ設定を使います。

```bash
codex mcp add orchestorDocs --url https://orchestor.io/docs/api/mcp
codex mcp list
```

`~/.codex/config.toml` を直接編集する場合は、次を追加します。

```toml
[mcp_servers.orchestorDocs]
url = "https://orchestor.io/docs/api/mcp"
```

### VS Code

プロジェクトの `.vscode/mcp.json` にサーバーを追加します。

```json
{
  "servers": {
    "orchestorDocs": {
      "type": "http",
      "url": "https://orchestor.io/docs/api/mcp"
    }
  }
}
```

Copilot Chat を Agent モードに切り替え、ツールの選択からサーバーを有効にします。

### Cursor

`~/.cursor/mcp.json` にサーバーを追加します。

```json
{
  "mcpServers": {
    "orchestorDocs": {
      "url": "https://orchestor.io/docs/api/mcp"
    }
  }
}
```

Cursor を再起動し、MCP 設定でサーバーの接続を確認します。

### Claude Code

作業するプロジェクトでサーバーを追加します。

```bash
claude mcp add --transport http orchestorDocs https://orchestor.io/docs/api/mcp
claude mcp list
```

すべてのプロジェクトで使う場合は `--scope user` を指定します。

```bash
claude mcp add --transport http --scope user orchestorDocs https://orchestor.io/docs/api/mcp
```

Claude Code の `/mcp` で接続を確認します。

登録後、エージェントへ次のように依頼してください。

```text
Orchestor Docs MCP で「可視性」を検索し、該当ページの本文を取得してください。
指標の定義と確認手順をまとめ、参照したページの URL を示してください。
```

## エージェントに参照を指示する

プロジェクトの `AGENTS.md` など、利用するエージェントが読む指示ファイルに次を追加します。

```text
Orchestor の機能・CLI・設定を扱うときは、orchestorDocs の docs_search で
公式ドキュメントを検索し、docs_get_page で該当ページの本文を読んでください。
回答には参照ページの URL を示し、本文で確認できない仕様は推測しないでください。
```

指示ファイルに追加していない場合は、会話で Docs MCP の使用を明示します。日本語のみを検索する場合は `docs_search` に `locale: "ja"`、英語なら `locale: "en"` を指定できます。

## スキルと組み合わせる

[Orchestor のスキル](https://orchestor.io/docs/agent-resources/skills.md) は、コマンド選択や業務の進め方を案内します。Docs MCP で必要な仕様を読み、スキルの手順に沿って作業できます。ワークスペースの操作には別途認証が必要です。

MCP に接続できない環境では、[Markdown とエージェント向け索引](https://orchestor.io/docs/agent-resources/markdown-access.md) から公開ドキュメントを取得できます。

---

[Documentation index](https://orchestor.io/docs/llms.txt)