--- title: setup description: 同梱スキルをエージェントへ導入し、MCP登録設定を作成する。 canonical_url: https://orchestor.io/docs/cli/setup markdown_url: https://orchestor.io/docs/cli/setup.md contentType: reference --- # setup `orc setup` は、CLIに同梱されたスキルをエージェントが読むディレクトリへ導入し、導入状態を確認・解除するコマンドです。MCPのローカル登録設定を書き込む操作もあります。 スキルの導入はローカルファイルの操作です。MCPの接続には [hosted MCPのワークフロー](https://orchestor.io/docs/cli/workflows/agent-connect.md) を使用してください。`setup mcp` は `orc mcp serve` を呼ぶ設定を作りますが、その実行コマンドは提供されていません。 ## 使い方 ```bash title="terminal" orc setup skills --agent codex ``` *Codexのプロジェクト用ディレクトリへスキルを導入します。* ## サブコマンド ### `skills` 埋め込み済みスキルをcanonicalな `.agents/skills` ディレクトリへコピーし、対象エージェントのスキルディレクトリへリンクします。Windowsではjunctionを使用し、リンクを作れない場合は同じ内容をコピーします。`--status` は installed・missing・broken・version-drift の状態を確認します。 ```bash title="terminal" orc setup skills [options] ``` #### 固有のオプション ##### `--status` List installed / missing / broken / version-drift state 型: `boolean`。任意。 ```bash title="terminal" orc setup skills --status ``` ##### `--uninstall` Remove installed Orchestor skill symlinks from agent skill paths 型: `boolean`。任意。 ```bash title="terminal" orc setup skills --uninstall ``` ##### `--force` Replace existing symlinks without prompting; non-symlink paths are skipped 型: `boolean`。任意。 ```bash title="terminal" orc setup skills --force ``` ##### `--only` Comma-separated skill slugs to install (default: all bundled skills) 型: `string`。任意。 ```bash title="terminal" orc setup skills --only ``` ##### `--agent` Target one agent runtime (for example: codex or claude-code) 型: `string`。任意。 ```bash title="terminal" orc setup skills --agent ``` ##### `--all` Target every supported agent skill directory 型: `boolean`。任意。 ```bash title="terminal" orc setup skills --all ``` ##### `--global` Install to user-level agent directories instead of the current project 型: `boolean`。任意。 ```bash title="terminal" orc setup skills --global ``` ### `mcp` `--target project`（既定値）では `.mcp.json`、`--target claude-desktop` ではClaude Desktopの設定へOrchestorのローカルサーバー登録を書き込みます。登録される `orc mcp serve` は実行できないため、この設定の作成だけでは接続は完了しません。 ```bash title="terminal" orc setup mcp [options] ``` #### 固有のオプション ##### `--target` Config target: project (.mcp.json) or claude-desktop 型: `string`。任意。 ```bash title="terminal" orc setup mcp --target ``` ## 使用例 ### 導入状態を確認します。 ```bash title="terminal" orc setup skills --agent codex --status ``` *導入状態を確認します。* ### すべての対応エージェントのuser-levelへ導入します。 ```bash title="terminal" orc setup skills --all --global ``` *すべての対応エージェントのuser-levelへ導入します。* ### Codexの導入リンクを解除します。 ```bash title="terminal" orc setup skills --agent codex --uninstall ``` *Codexの導入リンクを解除します。* ## 導入先と解除 既定ではcanonical copyをuser-levelの `~/.agents/skills` に置き、Claude Codeのuser-levelディレクトリを対象にします。`--agent` または `--all` はproject-levelを対象にし、`--global` を加えるとuser-levelへ導入します。`--only` はスキルslugをカンマで指定し、省略時は同梱スキルすべてを対象にします。 `--force` は既存のsymlinkを確認なしで置き換え、通常のパスはスキップします。`--uninstall` は対象エージェントのOrchestorスキルsymlinkだけを削除し、canonical copyと通常のディレクトリは削除しません。 ## グローバルオプション `orc setup` では、次の[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を使用できます。 - [`--help`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%98%E3%83%AB%E3%83%97) - [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9) - [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B) - [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B) - [`--format`](https://orchestor.io/docs/cli/global-flags.md#%E5%87%BA%E5%8A%9B%E5%BD%A2%E5%BC%8F) - [`--field`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA) - [`--fields`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA) - [`--raw`](https://orchestor.io/docs/cli/global-flags.md#%E5%80%A4%E3%81%A0%E3%81%91%E3%82%92%E5%87%BA%E5%8A%9B) - [`--output`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E5%87%BA%E5%8A%9B) - [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%9A%E3%83%BC%E3%82%B8%E9%80%81%E3%82%8A) - [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E4%BA%8B%E5%89%8D%E7%A2%BA%E8%AA%8D) - [`--yes`](https://orchestor.io/docs/cli/global-flags.md#%E7%A2%BA%E8%AA%8D%E3%81%AE%E7%9C%81%E7%95%A5) - [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B) - [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B) - [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#%E3%81%99%E3%81%B9%E3%81%A6%E3%81%AE%E3%83%9A%E3%83%BC%E3%82%B8%E3%82%92%E5%8F%96%E5%BE%97) - [`--timing`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%99%82%E9%96%93) - [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#%E8%AA%AD%E3%81%BF%E5%8F%96%E3%82%8A%E5%B0%82%E7%94%A8%E3%83%A2%E3%83%BC%E3%83%89) - [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#%E5%A4%96%E9%83%A8%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E7%9B%AE%E5%8D%B0%E4%BB%98%E3%81%91) 各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。 --- [Documentation index](https://orchestor.io/docs/llms.txt)