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 httpmcpServers JSON。
  • 不要把 https://langfuse.com/api/search-docs 当 MCP。那是同一套检索的 REST。
  • 不要给它 required = true 挂全局。
  • 不要一上来 --yolo

网页 Cloud 不读 ~/.codex/config.toml。改完新开会话。用 codex mcp get langfuse-docs 看传输是 streamable_http。

来源