langfuse — MCP-сервер для Claude Code: анализ и установка
MCP-сервер подключает агента к Langfuse для чтения трассировок и наблюдений. Пригодится для отладки LLM-пайплайнов, затрат и задержек.
claude mcp add --env LANGFUSE_SECRET_KEY=<LANGFUSE_SECRET_KEY> --env LANGFUSE_PUBLIC_KEY=<LANGFUSE_PUBLIC_KEY> --env LANGFUSE_BASE_URL=<LANGFUSE_BASE_URL> --transport stdio langfuse -- npx -y langfuse-observability-mcp-serverЧто делает langfuse
langfuse даёт агенту инструменты для поиска трассировок по имени, пользователю, сессии, тегам, времени и окружению. Можно открыть детали трассировки со вложенными наблюдениями и оценками, а также фильтровать наблюдения по типу, модели и уровню. Доступ ограничен чтением.
Большие строковые поля сервер обрезает после 1000 символов и сохраняет целиком в /tmp/langfuse_*.txt; путь попадает в ответ, чтобы агент мог искать содержимое через grep. Для подключения нужны LANGFUSE_SECRET_KEY и LANGFUSE_PUBLIC_KEY, а LANGFUSE_BASE_URL задаёт адрес API. Без первых двух переменных сервер не подключится.
Какие задачи решает
- найти трассировки по пользователю и сессии
- разобрать вложенные наблюдения LLM-вызова
- сопоставить модель с расходами и задержкой
- найти нужный фрагмент в большом ответе через
grep
Примеры запросов агенту
- Найди трассировки для пользователя
user-123и сгруппируй их по сессиям. - Открой полную трассировку с ID
trace-idи объясни, где возникла задержка. - Покажи наблюдения типа
GENERATIONдля выбранной модели и их стоимость.
Как установить langfuse
Командой платформы
claude mcp add --env LANGFUSE_SECRET_KEY=<LANGFUSE_SECRET_KEY> --env LANGFUSE_PUBLIC_KEY=<LANGFUSE_PUBLIC_KEY> --env LANGFUSE_BASE_URL=<LANGFUSE_BASE_URL> --transport stdio langfuse -- npx -y langfuse-observability-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add langfuse --env LANGFUSE_SECRET_KEY=<LANGFUSE_SECRET_KEY> --env LANGFUSE_PUBLIC_KEY=<LANGFUSE_PUBLIC_KEY> --env LANGFUSE_BASE_URL=<LANGFUSE_BASE_URL> -- npx -y langfuse-observability-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"langfuse": {
"command": "npx",
"args": [
"-y",
"langfuse-observability-mcp-server"
],
"env": {
"LANGFUSE_SECRET_KEY": "<LANGFUSE_SECRET_KEY>",
"LANGFUSE_PUBLIC_KEY": "<LANGFUSE_PUBLIC_KEY>",
"LANGFUSE_BASE_URL": "<LANGFUSE_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"langfuse": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"langfuse-observability-mcp-server"
],
"env": {
"LANGFUSE_SECRET_KEY": "<LANGFUSE_SECRET_KEY>",
"LANGFUSE_PUBLIC_KEY": "<LANGFUSE_PUBLIC_KEY>",
"LANGFUSE_BASE_URL": "<LANGFUSE_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e LANGFUSE_SECRET_KEY=<LANGFUSE_SECRET_KEY> -e LANGFUSE_PUBLIC_KEY=<LANGFUSE_PUBLIC_KEY> -e LANGFUSE_BASE_URL=<LANGFUSE_BASE_URL> langfuse npx -y langfuse-observability-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о langfuse
Как установить langfuse в Claude Code?
Выполните `claude mcp add --env LANGFUSE_SECRET_KEY=<LANGFUSE_SECRET_KEY> --env LANGFUSE_PUBLIC_KEY=<LANGFUSE_PUBLIC_KEY> --env LANGFUSE_BASE_URL=<LANGFUSE_BASE_URL> --transport stdio langfuse -- npx -y langfuse-observability-mcp-server`.
Что делает langfuse?
Он даёт агенту доступ только для чтения к трассировкам и наблюдениям Langfuse: их можно фильтровать, раскрывать и анализировать по моделям, оценкам, затратам и задержкам.
Что нужно для работы langfuse?
Нужны LANGFUSE_SECRET_KEY и LANGFUSE_PUBLIC_KEY. Адрес API можно задать через LANGFUSE_BASE_URL.
