连接 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:

codex mcp add alloy --url https://mcp.alloy.app/mcp
codex mcp login alloy
[mcp_servers.alloy]
url = "https://mcp.alloy.app/mcp"
enabled = true

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

已经配过 bearer 的 alloy 表,先卸再走 OAuth:

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 专节:

[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.cxwork-with-alloy 插件读的是 ALLOY_TOKENapi.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。

来源