# Muse Code を接続する {/* #connect-muse-code */}

このガイドは、個人アクセストークンまたは登録済みコールバック `http://127.0.0.1:58234/callback` によるブラウザー OAuth に対応しています。[クライアントの互換性](/docs/ja/connect-ai-agents#client-compatibility)を参照してください。

[個人アクセストークン](/docs/ja/connect-ai-agents#personal-access-token)の説明に従い、[Reconstruct Platform の設定](https://reconstruct.dev/platform/)で **MCP** スコープを持つトークンを作成します。

## サーバーを設定する {/* #configure-the-server */}

`~/.config/muse/settings.json`（設定済みなら `$XDG_CONFIG_HOME/muse/settings.json`）を編集します。既存の設定とサーバーを残し、`mcpServers` に `reconstruct` を追加します。

```json
{
  "schema_version": 1,
  "mcpServers": {
    "reconstruct": {
      "type": "streamable-http",
      "url": "https://reconstruct.dev/mcp",
      "headers": {
        "Authorization": "Bearer <your MCP token>"
      }
    }
  }
}
```

`<your MCP token>` を作成したトークンに置き換えます。このユーザー設定を非公開にし、バージョン管理に含めないでください。Muse Code 1.3.0 は HTTP ヘッダーの環境変数を展開しないため、`${CR_RECONSTRUCT_MCP_TOKEN}` はそのまま送信されます。`schema_version: 1` を維持し、サーバーのルートキーは `mcpServers` だけを使用してください。別の `mcp_servers` キーは作成しないでください。

## 接続を確認する {/* #check-the-connection */}

保存後、新しい `muse` プロセスを起動します。`/mcp` を実行して `reconstruct` の接続を確認し、Muse Code に `mcp__reconstruct__list_products` の呼び出しを依頼してアクセスを確認します。設定の変更には新しいプロセスが必要です。

## 任意の OAuth ブラウザーサインイン {/* #optional-oauth-browser-sign-in */}

`Authorization` ヘッダーを削除し、パブリッククライアント ID `reconstruct-mcp`、スコープ `openid` と `aud-mcp`、登録済みコールバック `http://127.0.0.1:58234/callback` でサインインします。このポートを使用可能にしておいてください。

```bash
muse mcp login reconstruct --oauth-client-id reconstruct-mcp \
  --scope openid --scope aud-mcp --callback-port 58234
```

OAuth にはユーザー設定のエントリーを使います。プロジェクトの `.mcp.json` だけに設定されたサーバーでは CLI ログインは使えません。クライアントシークレットは空欄にします。この事前登録済みループバックコールバックには `--oauth-client-id` を使い、共有コールバックポートは `58234` にします。ブラウザーでのサインイン後、Muse がコールバックを受け取り、接続を自動完了します。

公式の [Muse Code MCP ガイド](https://meta-models.github.io/muse-code-sdk/next/guides/extend/mcp-servers/)を参照してください。接続に失敗した場合は[トラブルシューティング](/docs/ja/connect-ai-agents#troubleshooting)を確認します。続いて[プロンプトの例](/docs/ja/prompt-examples)を試してください。