---
title: "Langfuse 文档 MCP 用 langfuse-docs，无鉴权，不是观测产品"
summary: "官方 Codex 节：codex mcp add langfuse-docs --url https://langfuse.com/api/mcp。无鉴权、只读文档。不要抄 mcp-remote 或 Claude 的 --transport http。这不是 cloud.langfuse.com 那台带 Basic Auth 的产品 MCP。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "Langfuse", "文档", "HTTP"]
canonical: /tips/mcp-langfuse-docs/
---

# 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：

```bash
codex mcp add langfuse-docs --url https://langfuse.com/api/mcp
```

```toml
[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 时钉死：

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

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

## 来源

- [Langfuse · Docs MCP](https://langfuse.com/docs/docs-mcp)
- [Langfuse · Agent Skill](https://langfuse.com/docs/api-and-data-platform/features/agent-skill)
- [OpenAI · Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp)