Atlan 官方 Codex：plugin add atlan@atlan，再 mcp add

Atlan 给 Codex 有专节。托管地址是 https://mcp.atlan.com/mcp（带 /mcp 后缀），所有租户共用这一台，OAuth，不必先备 API key。仓库里的本地 MCP（pip install atlan-mcp-server、uvx atlan-mcp-server、Docker 镜像）已弃用，不要再当主路径。

官方 Codex 插件节是这三步，缺一步都不算装完：

codex plugin marketplace add https://github.com/atlanhq/agent-toolkit
codex plugin add atlan@atlan
codex mcp add atlan --url https://mcp.atlan.com/mcp

插件 id 是 atlan@atlan。不要抄 Claude 的 atlan@claude-plugins-official 或 atlan@atlan-marketplace。也不要抄仓库 README 给 Claude 的 /plugin install。Honeycomb 那类插件会自己登记 MCP；Atlan 不会——官方把 mcp add 单独写成第 3 步，装了插件仍要跑。

只要 MCP、不装插件，走 Manual 节，命令就是上面那条 mcp add。官方说它会写入 [mcp_servers.atlan] 并拉起浏览器 OAuth。若只写入表、没弹出登录，再：

codex mcp login atlan

[mcp_servers.atlan]
url = "https://mcp.atlan.com/mcp"
enabled = true

不要抄 Claude 的 --transport http，也不要抄 Cursor 的 type: http JSON。不要抄 npx mcp-remote https://mcp.atlan.com/mcp。不要和文档站 https://docs.atlan.com/mcp 配成一台：那是 Atlan 文档 MCP，不是数据目录。也不要抄 Snowflake Cortex 的 cortex mcp add。

改完退出再开会话（桌面用退出应用，不要只关窗口）。用 /mcp 看 atlan 是否已连。连上后先搜资产和血缘。治理写入和 SQL 查询会改元数据或打到数仓，保持工具批准。不要一上来 --yolo。不要给它 required = true 挂全局。

无头 / 不能开浏览器才对照 API key。官方 Codex 节没写这条；Claude 示例把 Bearer 写进 headers。Codex 用 bearer_token_env_var，不要把密钥写进 http_headers。这张表不要再 mcp login。一条连接只用一种鉴权。

不要做这些：

• 不要发明 atlan@openai-curated。
• 不要抄本地 Docker / uvx，把 ATLAN_API_KEY 写进 args 或 env 表。
• 不要抄 claude mcp add --transport http。
• 不要给它 required = true 挂全局。

网页 Cloud 不读 ~/.codex/config.toml。改完用 codex plugin list；MCP 用 codex mcp get atlan 看传输是 streamable_http。