---
title: "连接 Alloy 原型与开发会话"
summary: "连接 alloy.app 的原型和开发会话。交互使用 OAuth，无头环境可通过 ALLOY_MCP_API_KEY 提供工作区凭据。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "Alloy", "OAuth", "HTTP", "bearer_token_env_var"]
canonical: /tips/alloy-mcp-http/
---

# 连接 Alloy 原型与开发会话

连接 alloy.app 的原型和开发会话。交互使用 OAuth，无头环境可通过 ALLOY_MCP_API_KEY 提供工作区凭据。

这是 `alloy.app` 的原型 / 开发会话工具，**不是** `alloy.cx` 知识库，也**不是** `mcp.index.inc` 的 Planning and Feedback 产品。文档包含 Codex 的配置说明。远程入口是 `https://mcp.alloy.app/mcp`，**带** `/mcp`。Streamable HTTP。先 OAuth：

```bash
codex mcp add alloy --url https://mcp.alloy.app/mcp
codex mcp login alloy
```

```toml
[mcp_servers.alloy]
url = "https://mcp.alloy.app/mcp"
enabled = true
```

桌面走 Settings → Integrations & MCP，名字填 Alloy，URL 填同一条。CLI / 桌面 / IDE 共用这份配置。若浏览器未打开，运行 `codex mcp login alloy`。`codex mcp list` 应列出 `alloy`。TUI 里 `/mcp` 看是否还要授权。

已经配过 bearer 的 `alloy` 表，先卸再走 OAuth：

```bash
codex mcp remove alloy
codex mcp add alloy --url https://mcp.alloy.app/mcp
codex mcp login alloy
```

无头 / CI 才走工作区 MCP key。到 Alloy 工作区 Settings → MCP 建。官方 Codex 专节：

```toml
[mcp_servers.alloy]
url = "https://mcp.alloy.app/mcp"
bearer_token_env_var = "ALLOY_MCP_API_KEY"
enabled = true
```

`bearer_token_env_var` 填变量**名**。把密钥 export 成 `ALLOY_MCP_API_KEY`。Codex 从启动环境中读取该变量。Codex 不读 `.env`。从 Dock 或开始菜单启动的桌面应用通常不会加载终端环境变量。从已经 export 的终端启动。密钥按工作区划界，只能读那个工作区里的会话。

Bearer token 和 OAuth 请选择一种认证方式。配置了 `bearer_token_env_var` / `http_headers` / `env_http_headers` 时，每次请求都带该请求头，会盖掉已存的 OAuth。于是登录看起来成功，调用却一直 401。使用 OAuth 时，请移除手动配置的认证头。

Codex 可直接连接 Streamable HTTP 服务。无头环境使用 `ALLOY_MCP_API_KEY` 提供凭据。

`alloy.cx` 的 `work-with-alloy` 插件读的是 `ALLOY_TOKEN` 和 `api.alloy.cx`，不是这条。若文档写成 `https://mcp.index.inc/mcp`，那是另一家产品，表名也叫 `alloy`，先 `codex mcp get alloy` 看 url。

粘贴 Alloy 会话链接，让它汇总聊天、列文件、读原型内容或开发会话 diff。会话必须属于你授权的那个工作区。

网页 Cloud 不读取 `~/.codex/config.toml`。修改后重新打开会话。用 `codex mcp get alloy` 看传输是 streamable_http。OAuth 路径的 Auth 应显示 OAuth。

## 来源

- [Alloy · Codex MCP](https://alloy.app/guide/integrations/codex-mcp)
- [Alloy · MCP](https://alloy.app/guide/integrations/mcp)
- [Alloy · Alloy MCP](https://alloy.app/launches/alloy-mcp)