Orchestor MCP サーバーを使う
Model Context Protocol（MCP）を使って、いつもの AI ツールを Orchestor に接続できます。ブランドや AI 回答を調べ、可視性や引用元を比較する作業を、エージェントとの会話から進められます。
クイックセットアップ
MCP クライアントに、次のサーバー URL を追加します。
https://mcp.orchestor.io/mcpサーバーを追加したら、クライアントの認証操作から Orchestor にログインし、接続するワークスペースを選んでアクセスを許可してください。
Orchestor MCP とは
Orchestor MCP は、AI ツールから Orchestor のワークスペースを利用するための公式 MCP サーバーです。リモート接続に対応しているため、サーバーを自分で起動する必要はありません。接続には Streamable HTTP、認証には OAuth を使用します。
エージェントに、次のような作業を依頼できます。
- ブランド、トピック、計測するプロンプトを探す。
- 保存された AI 回答と引用元を調べる。
- 可視性、引用、センチメントのレポートを比較する。
- 分析から見つけた改善案を、依頼に応じて Issue に記録する。
利用できるツール
ブランドや回答を取得するツール、レポートを読むツールに加え、目的に合う読み取りツールを探す機能を提供しています。ツールリファレンスから、用途別の一覧、入力項目、依頼例を確認できます。
利用できる操作は、接続先の構成と許可した権限によって変わります。たとえば、prompts_create はプロンプトのプレビュー、create_issue は Issue の作成です。プレビューではプロンプトは保存されません。
Orchestor MCP に接続する
Orchestor のアカウントと、対象ワークスペースへのアクセス権が必要です。クライアントはリモート MCP と OAuth に対応している必要があります。この接続に API キーの設定は不要です。
設定手順を案内しているクライアントは次のとおりです。
クライアントを設定する
Claude Code
ターミナルで MCP サーバーを追加します。
claude mcp add --transport http orchestor https://mcp.orchestor.io/mcpClaude Code を起動して /mcp を開き、orchestor の認証を開始します。ブラウザーでワークスペースと権限を確認して、アクセスを許可してください。
Codex
~/.codex/config.toml にサーバー設定を追加します。
[mcp_servers.orchestor]
url = "https://mcp.orchestor.io/mcp"次のコマンドで認証し、登録状態を確認します。
codex mcp login orchestor
codex mcp listCursor
プロジェクトの .cursor/mcp.json にサーバー設定を追加します。既存の設定がある場合は、mcpServers に orchestor を追加してください。
{
"mcpServers": {
"orchestor": {
"url": "https://mcp.orchestor.io/mcp"
}
}
}Cursor の MCP 設定から orchestor の認証を開始し、ブラウザーでアクセスを許可します。
接続を試す
接続したエージェントに、次のように依頼します。
Orchestor のワークスペースにあるブランドを一覧にしてください。ブランドの ID と名前を示してください。
ブランド一覧を取得できれば、最初の読み取りは完了です。ブランドが未登録の場合は空の一覧が返ります。続けて、分析するブランドと期間を指定してください。
このブランドの直近30日間の可視性と引用元を調べてください。根拠となるレポートと AI 回答を示し、観測した事実と改善案を分けてください。
ほかの依頼例は活用例を参照してください。
アクセス権と接続の管理
認可画面で、接続先クライアントとワークスペースを確認します。分析には Read-only、Issue の作成などの変更には Read and write を選びます。接続期間は This session または Until revoked から選択できます。
許可したアクセスは、認可時に選んだワークスペースに限定されます。別のワークスペースを利用する場合は、そのワークスペースへの接続を認可してください。
接続の確認や解除は、MCP connectionsで行います。利用を終えた接続の Revoke を選ぶと、その接続からワークスペースへアクセスできなくなります。
接続できないとき
| 状況 | 対処方法 |
|---|---|
| サーバーを追加したがデータを取得できない | クライアントから認証を開始し、ブラウザーでワークスペースへのアクセスを許可します。 |
| 認証期限が切れた | クライアントから認証をやり直します。接続の状態は MCP connections で確認できます。 |
| 期待するデータが表示されない | 認可したワークスペース、対象ブランド、期間を確認します。 |
| 読み取りはできるが Issue を作成できない | 接続に Read and write が許可されているか確認します。 |
| 必要なツールが見つからない | ツールリファレンスで用途を確認し、エージェントに利用可能なツールを調べるよう依頼します。 |