# 连接 Muse Code {/* #connect-muse-code */}

本指南支持个人访问令牌，或使用已注册回调地址 `http://127.0.0.1:58234/callback` 的浏览器 OAuth。参阅[客户端兼容性](/docs/zh/connect-ai-agents#client-compatibility)。

按照[个人访问令牌](/docs/zh/connect-ai-agents#personal-access-token)中的说明，在 [Reconstruct 平台设置](https://reconstruct.dev/platform/)中创建具有 **MCP** 作用域的令牌。

## 配置服务器 {/* #configure-the-server */}

编辑 `~/.config/muse/settings.json`（若设置了 `$XDG_CONFIG_HOME`，则为 `$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 请使用用户设置条目；CLI 登录不支持仅配置在项目 `.mcp.json` 中的服务器。将客户端密钥留空。此预先注册的环回回调应使用 `--oauth-client-id`；共用回调端口为 `58234`。浏览器登录后，Muse 会接收回调并自动完成连接。

接下来，试试[提示词示例](/docs/zh/prompt-examples)。