version: 2026-10-03

# Orchestor をエージェントに設定する

これは Orchestor Skills と hosted MCP を設定するための公式手順です。使用中のエージェントに該当する手順だけを選び、コマンドはあなた自身で実行してください。ブラウザでのログイン・OAuth の同意と、実行中のエージェントの再読み込みは利用者に案内してください。

Skills と remote MCP `orchestor` を設定します。登録する MCP は `https://mcp.orchestor.io/mcp` の 1 件だけです。Skills は作業手順を追加し、MCP は認可したワークスペースのツールを提供します。CLI を使うスキルには、後述の CLI 導入とログインも必要です。

- 使用中のエージェントに Skills と MCP を設定する
- 必要に応じて Orchestor CLI を導入する
- 接続を読み取り操作で確認する

設定ファイルを編集する前にバックアップを取り、無関係な設定を保持してください。既存の Orchestor 設定は確認して再利用し、同じスキルや MCP を重複して追加しないでください。API キーやトークンを設定例・会話・ログへ貼り付けないでください。

---

## Skills と MCP をインストールする

### Claude Code

次の 2 command で Orchestor Skills と MCP をまとめて追加します。`npx skills` や `claude mcp add` は併用しないでください。

```bash
claude plugin marketplace add orchestor-inc/orchestor-plugin
claude plugin install orchestor@orchestor
```

プラグインとセッション開始フックには Node.js 24 以上が必要です。導入前に `node --version` と既存設定を確認してください。既存の `orchestor` プラグインがある場合は重複導入せず、更新の節を参照してください。手動登録の MCP や同じスキルがある場合は、その場所と状態を報告して導入経路を一つに揃えてください。

追加後、利用者に Claude Code 内で `/reload-plugins` を実行するよう案内してください。続いて `/mcp` を開き、Orchestor の OAuth を完了します。対象ワークスペースを確認し、分析には **Read-only** を選択します。

---

## その他のエージェントにインストールする

Codex、Cursor、OpenCode では、最初に Skills を追加します。

```bash
npx -y skills@latest add orchestor-inc/skills --skill '*' --yes --global
```

同じスキルを Plugin または CLI から導入済みなら、このコマンドで重複導入しないでください。

次に、使用中のクライアントの公式設定面だけを使って remote MCP `orchestor` を登録します。登録前に既存設定を確認してください。`orchestor` entry がすでに存在する場合は上書きせず、その場所と状態を報告してください。

### Codex

`orchestor` が存在しない場合だけ登録します。

```bash
codex mcp add orchestor --url https://mcp.orchestor.io/mcp
```

既存の登録を利用する場合も、未認証ならログインします。

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

### OpenCode — `~/.config/opencode/opencode.jsonc`

既存のプロジェクト設定 `opencode.json` / `opencode.jsonc` を利用している場合は、その設定先を使います。既存の `mcp` object に次の entry を追加します。file 全体や他の entry を置き換えないでください。

```json
{
  "mcp": {
    "orchestor": {
      "type": "remote",
      "url": "https://mcp.orchestor.io/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}
```

追加後、次を実行します。

```bash
opencode mcp auth orchestor
opencode mcp list
```

### Cursor — `.cursor/mcp.json`

既存の `mcpServers` object に次の entry を追加します。file 全体や他の entry を置き換えないでください。

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

Cursor の MCP 設定画面から Orchestor の認証を開始し、ブラウザで同意します。設定が反映されない場合は Cursor を再起動するよう案内してください。

---

## （任意）Orchestor CLI をインストールする

CLI は、ブランド・プロンプト・AI 回答・レポートをターミナルから扱います。公開 Skills の CLI ワークフローを使う場合は必要です。利用者が CLI の導入を希望するか確認し、不要ならこの節を省略してください。すでに `orc` があれば `orc --version` と `orc --help` を確認して再利用します。

macOS / Linux:

```bash
curl -fsSL https://orchestor.io/install | sh
```

Windows では `https://github.com/orchestor-inc/cli/releases/latest` から環境に合う ZIP を取得し、展開した `orc.exe` を PATH の通った場所へ配置します。

CLI を確認し、ログインします。ブラウザでの認証は利用者が完了します。

```bash
orc --version
orc auth login
orc workspaces list
```

一覧から利用者が選んだ ID に `YOUR_WORKSPACE_ID` を置き換えます。複数候補がある場合は推測しないでください。

```bash
orc workspace use YOUR_WORKSPACE_ID
orc status
orc brands list --json
```

MCP と CLI の認証は別です。MCP の OAuth が完了しても CLI のログインは完了しません。CLI を導入しなかった場合は、CLI に依存する Skills は未準備と報告してください。

## 接続を確認する

各エージェントの OAuth 画面で対象ワークスペースを確認し、分析には **Read-only** を選びます。エージェントを再読み込みして、次の読み取りを試してください。

```text
Orchestor のブランド一覧を取得し、ID と名前を示してください。データは変更しないでください。
```

MCP の `brands_list` が成功すれば接続を確認できます。ブランドが未登録なら空の一覧でも成功です。ツールが見えない場合はエージェントの再読み込みと MCP の接続状態を確認します。新規測定や書き込みは接続確認に使いません。

最後に、実際の Skills の場所と MCP 登録先を示し、設定・認証・読み取り結果を分けて報告します。未実行・失敗・利用者の操作待ちはそのまま示し、完了とは報告しないでください。

```text
Orchestor のセットアップ結果
Skills: <実際の場所 / 未導入>
MCP: orchestor — <実際の登録先 / 未登録>
MCP 認証: <完了 / 利用者の操作待ち / 失敗>
MCP 読み取り: <brands_list 成功 / 未確認 / 失敗>
CLI: <バージョン・接続先 / 導入を省略>
次の操作: <再読み込み・認証など / なし>
```

## 更新する

利用中の導入経路だけを更新します。編集済みのスキルは変更内容を確認してから更新してください。

Claude Code Plugin:

```bash
claude plugin update orchestor@orchestor
```

Skills CLI で導入したスキル:

```bash
npx skills@latest update
```

## リソース

- Orchestor Skills: https://github.com/orchestor-inc/skills
- Orchestor Plugin: https://github.com/orchestor-inc/orchestor-plugin
- Orchestor CLI: https://orchestor.io/docs/cli/installation
- Orchestor MCP: https://orchestor.io/docs/mcp
- Claude Code MCP: https://code.claude.com/docs/en/mcp
- Codex MCP: https://developers.openai.com/codex/mcp
- Cursor MCP: https://cursor.com/docs/context/mcp
- OpenCode MCP: https://opencode.ai/docs/mcp-servers/

この手順の公開元は https://orchestor.io/docs/agent-setup/prompt.md です。