Langfuse 文档 MCP 用 langfuse-docs,无鉴权,不是观测产品
官方 Codex 节:codex mcp add langfuse-docs --url https://langfuse.com/api/mcp。无鉴权、只读文档。不要抄 mcp-remote 或 Claude 的 --transport http。这不是 cloud.langfuse.com 那台带 Basic Auth 的产品 MCP。
Langfuse 文档 MCP 有官方 Codex 节。无鉴权,Streamable HTTP:
codex mcp add langfuse-docs --url https://langfuse.com/api/mcp
[mcp_servers.langfuse-docs]
url = "https://langfuse.com/api/mcp"
enabled = true
用户层表名官方就是带连字符的 langfuse-docs(这不是插件 mcp.json,#33063 那套连字符问题不套这里)。新开会话后跑 codex mcp list 确认已登记。官方没要求 mcp login。
这台只暴露文档工具:searchLangfuseDocs(语义检索)、getLangfuseDocsPage(按路径或 langfuse.com URL 取 Markdown)、以及总览。核心用途是让模型按文档把 Tracing 接到你的仓库,不是去改生产观测数据。
同一家还有另一台已鉴权的产品 MCP:https://cloud.langfuse.com/api/public/mcp(美区 us.cloud.langfuse.com,日本 jp,HIPAA hipaa)。那台要 Basic Auth,官方 Codex 示例把 token 写进 http_headers,不要抄进仓库。文档 MCP 和产品 MCP 不要写成同一张表。
可选技能:官方写 npx skills add langfuse/skills --skill langfuse。那是 Agent Skills 安装器,可能改所有检测到的客户端。只要 Codex 时钉死:
npx skills add langfuse/skills --skill langfuse --agent codex
这不是 Codex /plugins 主路径。不确定就别装。技能底层会用 npx langfuse-cli,那是 CLI,不是这台文档 MCP。
不要做这些:
- 不要套
mcp-remote。那是 Windsurf 回退。Codex 自己会连 Streamable HTTP。 - 不要抄 Claude 的
--transport http或mcpServersJSON。 - 不要把
https://langfuse.com/api/search-docs当 MCP。那是同一套检索的 REST。 - 不要给它
required = true挂全局。 - 不要一上来
--yolo。
网页 Cloud 不读 ~/.codex/config.toml。改完新开会话。用 codex mcp get langfuse-docs 看传输是 streamable_http。