Langfuse MCP — MCP-сервер для Claude Code: что делает и как установить
Подключает телеметрию Langfuse к ИИ-ассистентам для поиска сбоев в трейсах и разбора сессий. Пригодится при отладке работы моделей прямо в консоли.
claude mcp add --env LANGFUSE_PUBLIC_KEY=<LANGFUSE_PUBLIC_KEY> --env LANGFUSE_SECRET_KEY=<LANGFUSE_SECRET_KEY> --env LANGFUSE_HOST=<LANGFUSE_HOST> --env LANGFUSE_MCP_READ_ONLY=<LANGFUSE_MCP_READ_ONLY> --transport stdio langfuse-mcp -- uvx langfuse-mcpЧто делает Langfuse MCP
Сервер даёт агенту доступ к 48 инструментам для анализа трейсов, наблюдений, сессий пользователей и истории промптов. В отличие от официального облачного MCP от Langfuse, эта сборка сфокусирована на локальной отладке: здесь есть разбор маршрутных решений, компактный вывод и выгрузка дампов в файлы. Запись оценок, комментарии и работа с медиафайлами здесь не поддерживаются.
Поиск ошибок работает строго по уровню ERROR в записях наблюдений. Одного заполненного текста сообщения серверу недостаточно. Инструменты группируют сбои по файлам, возвращая до 50 групп с идентификаторами для перехода к полному трейсу.
Для запуска требуются утилита uv и Python версии от 3.10 до 3.14. Без ключей LANGFUSE_PUBLIC_KEY и LANGFUSE_SECRET_KEY сервер не сможет подключиться к вашему проекту.
Какие задачи решает
- найти недавние ошибки в трейсах с группировкой по файлам
- разобрать причины медленной работы конкретной сессии пользователя
- проверить решения роутера с низкой степенью уверенности
- получить текст и метаданные зарегистрированных промптов
Примеры запросов агенту
- Найди ошибки выполнения в трейсах за последние сутки
- Покажи детали трейса по ID и выведи все связанные наблюдения
- Выясни, почему сессия пользователя выполнялась так долго
Как установить Langfuse MCP
Командой платформы
claude mcp add --env LANGFUSE_PUBLIC_KEY=<LANGFUSE_PUBLIC_KEY> --env LANGFUSE_SECRET_KEY=<LANGFUSE_SECRET_KEY> --env LANGFUSE_HOST=<LANGFUSE_HOST> --env LANGFUSE_MCP_READ_ONLY=<LANGFUSE_MCP_READ_ONLY> --transport stdio langfuse-mcp -- uvx langfuse-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from langfuse-mcp <команда>
Командой платформы
codex mcp add langfuse-mcp --env LANGFUSE_PUBLIC_KEY=<LANGFUSE_PUBLIC_KEY> --env LANGFUSE_SECRET_KEY=<LANGFUSE_SECRET_KEY> --env LANGFUSE_HOST=<LANGFUSE_HOST> --env LANGFUSE_MCP_READ_ONLY=<LANGFUSE_MCP_READ_ONLY> -- uvx langfuse-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from langfuse-mcp <команда>
Файл настроек
{
"mcpServers": {
"langfuse-mcp": {
"command": "uvx",
"args": [
"langfuse-mcp"
],
"env": {
"LANGFUSE_PUBLIC_KEY": "<LANGFUSE_PUBLIC_KEY>",
"LANGFUSE_SECRET_KEY": "<LANGFUSE_SECRET_KEY>",
"LANGFUSE_HOST": "<LANGFUSE_HOST>",
"LANGFUSE_MCP_READ_ONLY": "<LANGFUSE_MCP_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from langfuse-mcp <команда>
Файл настроек
{
"servers": {
"langfuse-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"langfuse-mcp"
],
"env": {
"LANGFUSE_PUBLIC_KEY": "<LANGFUSE_PUBLIC_KEY>",
"LANGFUSE_SECRET_KEY": "<LANGFUSE_SECRET_KEY>",
"LANGFUSE_HOST": "<LANGFUSE_HOST>",
"LANGFUSE_MCP_READ_ONLY": "<LANGFUSE_MCP_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from langfuse-mcp <команда>
Командой платформы
gemini mcp add -e LANGFUSE_PUBLIC_KEY=<LANGFUSE_PUBLIC_KEY> -e LANGFUSE_SECRET_KEY=<LANGFUSE_SECRET_KEY> -e LANGFUSE_HOST=<LANGFUSE_HOST> -e LANGFUSE_MCP_READ_ONLY=<LANGFUSE_MCP_READ_ONLY> langfuse-mcp uvx langfuse-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from langfuse-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Langfuse MCP
Как установить Langfuse MCP в Claude Code?
Выполните команду claude mcp add langfuse-mcp -e LANGFUSE_PUBLIC_KEY=<LANGFUSE_PUBLIC_KEY> -e LANGFUSE_SECRET_KEY=<LANGFUSE_SECRET_KEY> -- uvx langfuse-mcp, подставив ключи из настроек Langfuse. После этого перезапустите агент и проверьте статус подключения командой /mcp.
Что делает Langfuse MCP?
Предоставляет ассистенту 48 инструментов для чтения трейсов, сессий, датасетов и маршрутов из Langfuse. Сервер помогает разбирать причины падений и анализировать задержки прямо в диалоге с моделью.
Чем этот сервер отличается от официального Langfuse MCP?
Этот проект ориентирован на локальную отладку с компактным выводом и анализом маршрутов через stdio. Он не умеет записывать оценки и комментарии, которые доступны в облачной версии Langfuse.
