---
title: Orchestor MCP サーバーを使う
description: Claude Code、Codex、Cursor などの AI ツールを Orchestor に接続し、ブランド、AI 回答、可視性レポートを調べます。
canonical_url: https://orchestor.io/docs/mcp
markdown_url: https://orchestor.io/docs/mcp.md
contentType: how-to
---

# Orchestor MCP サーバーを使う

[Model Context Protocol（MCP）](https://modelcontextprotocol.io/)を使って、いつもの AI ツールを Orchestor に接続できます。ブランドや AI 回答を調べ、可視性や引用元を比較する作業を、エージェントとの会話から進められます。

## クイックセットアップ

MCP クライアントに、次のサーバー URL を追加します。

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

サーバーを追加したら、クライアントの認証操作から Orchestor にログインし、接続するワークスペースを選んでアクセスを許可してください。

[クライアント別の設定手順](#クライアントを設定する)

## Orchestor MCP とは

Orchestor MCP は、AI ツールから Orchestor のワークスペースを利用するための公式 MCP サーバーです。リモート接続に対応しているため、サーバーを自分で起動する必要はありません。接続には Streamable HTTP、認証には OAuth を使用します。

エージェントに、次のような作業を依頼できます。

- ブランド、トピック、計測するプロンプトを探す。
- 保存された AI 回答と引用元を調べる。
- 可視性、引用、センチメントのレポートを比較する。
- 分析から見つけた改善案を、依頼に応じて Issue に記録する。

## 利用できるツール

ブランドや回答を取得するツール、レポートを読むツールに加え、目的に合う読み取りツールを探す機能を提供しています。[ツールリファレンス](https://orchestor.io/docs/mcp/tools.md)から、用途別の一覧、入力項目、依頼例を確認できます。

利用できる操作は、接続先の構成と許可した権限によって変わります。たとえば、`prompts_create` はプロンプトのプレビュー、`create_issue` は Issue の作成です。プレビューではプロンプトは保存されません。

## Orchestor MCP に接続する

Orchestor のアカウントと、対象ワークスペースへのアクセス権が必要です。クライアントはリモート MCP と OAuth に対応している必要があります。この接続に API キーの設定は不要です。

設定手順を案内しているクライアントは次のとおりです。

- [Claude Code](#claude-code)
- [Codex](#codex)
- [Cursor](#cursor)
- [OpenCode](https://orchestor.io/docs/agent-setup/opencode.md)

## クライアントを設定する

### Claude Code

ターミナルで MCP サーバーを追加します。

```bash
claude mcp add --transport http orchestor https://mcp.orchestor.io/mcp
```

Claude Code を起動して `/mcp` を開き、`orchestor` の認証を開始します。ブラウザーでワークスペースと権限を確認して、アクセスを許可してください。

[Claude Code の設定ガイド](https://orchestor.io/docs/agent-setup/claude-code.md)

### Codex

`~/.codex/config.toml` にサーバー設定を追加します。

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

次のコマンドで認証し、登録状態を確認します。

```bash
codex mcp login orchestor
codex mcp list
```

[Codex の設定ガイド](https://orchestor.io/docs/agent-setup/codex.md)

### Cursor

プロジェクトの `.cursor/mcp.json` にサーバー設定を追加します。既存の設定がある場合は、`mcpServers` に `orchestor` を追加してください。

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

Cursor の MCP 設定から `orchestor` の認証を開始し、ブラウザーでアクセスを許可します。

[Cursor の設定ガイド](https://orchestor.io/docs/agent-setup/cursor.md)

## 接続を試す

接続したエージェントに、次のように依頼します。

> Orchestor のワークスペースにあるブランドを一覧にしてください。ブランドの ID と名前を示してください。

ブランド一覧を取得できれば、最初の読み取りは完了です。ブランドが未登録の場合は空の一覧が返ります。続けて、分析するブランドと期間を指定してください。

> このブランドの直近30日間の可視性と引用元を調べてください。根拠となるレポートと AI 回答を示し、観測した事実と改善案を分けてください。

ほかの依頼例は[活用例](https://orchestor.io/docs/mcp/use-cases.md)を参照してください。

## アクセス権と接続の管理

認可画面で、接続先クライアントとワークスペースを確認します。分析には **Read-only**、Issue の作成などの変更には **Read and write** を選びます。接続期間は **This session** または **Until revoked** から選択できます。

許可したアクセスは、認可時に選んだワークスペースに限定されます。別のワークスペースを利用する場合は、そのワークスペースへの接続を認可してください。

接続の確認や解除は、[MCP connections](https://app.orchestor.io/settings/mcp)で行います。利用を終えた接続の **Revoke** を選ぶと、その接続からワークスペースへアクセスできなくなります。

## 接続できないとき

| 状況 | 対処方法 |
| --- | --- |
| サーバーを追加したがデータを取得できない | クライアントから認証を開始し、ブラウザーでワークスペースへのアクセスを許可します。 |
| 認証期限が切れた | クライアントから認証をやり直します。接続の状態は MCP connections で確認できます。 |
| 期待するデータが表示されない | 認可したワークスペース、対象ブランド、期間を確認します。 |
| 読み取りはできるが Issue を作成できない | 接続に Read and write が許可されているか確認します。 |
| 必要なツールが見つからない | [ツールリファレンス](https://orchestor.io/docs/mcp/tools.md)で用途を確認し、エージェントに利用可能なツールを調べるよう依頼します。 |

## 関連リソース

- [MCP ツールリファレンス](https://orchestor.io/docs/mcp/tools.md)
- [MCP の活用例](https://orchestor.io/docs/mcp/use-cases.md)
- [Orchestor Skills](https://orchestor.io/docs/agent-resources/skills.md)
- [Orchestor CLI](https://orchestor.io/docs/cli.md)

---

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