このオプションは、クライアントが Streamable HTTP MCP をサポートしているものの、専用の Chorus
統合がない場合に使います。この接続は Chorus ツールのみを公開します。Chorus ワークフローを
インストールしたり、クライアントをリモートで利用可能にしたりはしません。

:::tip[シェルからツールを呼び出す]
MCP クライアントからではなく、スクリプトやターミナルから Chorus ツールを呼び出したいだけの場合は、
組み込みの `chorus mcp call <tool>` コマンドを使ってください。[chorus CLI](/ja/reference/cli/)を
参照してください。
:::

設定の前に、[エージェントのアクセスを準備する](/ja/guides/administrator-setup/)に従って、その
クライアントに必要な権限だけを持つ API キーを作成します。

## MCP サーバーを設定する

`chorus` という名前の Streamable HTTP MCP サーバーを、次の値で追加します。

```text
URL: https://chorus.example.com/api/mcp
Authorization: Bearer cho_REDACTED
```

利用できる場合は、クライアントの保護された認証情報ストアを使ってください。設定の構文は
クライアントによって異なるため、URL とカスタム Authorization ヘッダーの追加は、クライアントの
ドキュメントに従ってください。

## 接続を確認する

利用できる MCP ツールを一覧表示し、`chorus_checkin` を呼び出します。応答が想定したエージェントの
身元と権限を示すことを確認します。

## 機能と制限

- クライアントは、その API キーで許可された Chorus MCP ツールを呼び出せます。
- Chorus のスキル、フック、レビュアー、ワークフローの順序制御はインストールされません。
- 汎用 MCP クライアントは Chorus デーモンのバックエンドではありません。
- Chorus はクライアントをリモートで起動、制御、中断、再開することはできません。
- 会話とツール実行の復旧は、引き続きクライアントの責任です。

## よくある問題

- **`401 Unauthorized`：** API キーをローテーションし、クライアントの認証情報を更新します。
- **`404 Not Found`：** 正確な `/api/mcp` エンドポイントを使います。
- **ツールは動くがワークフローが止まる：** クライアント自身が各ワークフローステップとレビュー
  ゲートを実行しなければなりません。
- **クライアントが HTTP ヘッダーを設定できない：** そのクライアントはこの MCP エンドポイントに認証できません。

キーと接続に関する一般的な確認については、[エージェント接続のトラブルシューティング](/ja/guides/troubleshooting/)を
参照してください。
