O que é Langfuse MCP Server?
O Langfuse, a plataforma de observabilidade de LLMs de código aberto, tem seu servidor MCP embutido no produto. Não há nada a instalar: cada região do Langfuse Cloud (EUA em https://us.cloud.langfuse.com/api/public/mcp, além de UE, Japão e HIPAA US) e toda instância auto-hospedada o servem em /api/public/mcp via Streamable HTTP. Ele se autentica com um par de chaves pública e secreta com escopo de projeto, enviado como cabeçalho Authorization Basic. Ele substitui o antigo repositório langfuse/mcp-server-langfuse, um servidor só de prompts sem commits desde fevereiro de 2025.
A MCP Reference lista cerca de 95 ferramentas para prompts, skills, observações, filas de anotação, comentários, datasets e experimentos, scores, métricas, modelos, avaliadores e regras de avaliação, dashboards e alertas. As ferramentas de leitura e de escrita vêm ativadas por padrão. Um servidor separado e sem autenticação em https://langfuse.com/api/mcp faz buscas na documentação. A plataforma em si é analisada em repos/langfuse.
Como instalar Langfuse MCP Server
https://us.cloud.langfuse.com/api/public/mcp (also EU, Japan, HIPAA US and self-hosted /api/public/mcp)Langfuse MCP Server vale a pena?
Este é um servidor MCP de fornecedor feito do jeito simples: ele vive dentro do Langfuse, então está sempre na mesma versão do seu projeto e funciona igual no Cloud e na versão auto-hospedada. A configuração é um único comando claude mcp add com um par de chaves codificado em base64. O escopo vai bem além do antigo servidor só de prompts. Um agente pode listar e filtrar observações, ler scores, rodar avaliações em lote, criar itens de dataset a partir de traces de produção, atualizar labels de prompts e montar widgets de dashboard.
Os limites de requisição são o que os leitores precisam planejar. As chamadas MCP contam no bucket General API do Langfuse, compartilhado por todos os projetos e chaves da organização. Ele permite 30 requisições por minuto no Hobby, 100 no Core e 1.000 no Pro e acima. Um agente que percorre as observações uma de cada vez com getObservation pode esgotar um minuto do Hobby em uma pergunta e depois esperar passar um 429.
As escritas exigem cuidado. Cerca de metade das ferramentas muda estado, incluindo deleteDatasetRun, deleteEvaluationRule, deleteDashboard e updatePromptLabels, que pode mover o label de produção para outra versão do prompt. O conselho do Langfuse é liberar no cliente só as ferramentas de leitura se for só isso que você quer. A chave no cabeçalho é uma chave secreta completa do projeto, guardada em texto puro no arquivo de configuração do cliente.
Os traces contêm o que os seus usuários digitaram, então um agente que os lê está lendo texto não confiável, com risco de injeção de prompt. O próprio Langfuse recomenda sua Agent Skill e sua CLI em vez do MCP sempre que o agente puder executar comandos de shell, e diz que os esquemas das ferramentas podem mudar sem aviso. É um alerta justo para quem amarra fluxos de trabalho a nomes de ferramentas.
Onde ele se destaca
Um engenheiro de IA em uma equipe de bot de suporte que usa o Langfuse Cloud US
Encontrar as conversas da noite passada em que o bot teve pontuação ruim e entender por quê
listObservations com filtros e listScores levam os traces com falha ao Claude Code, que resume a causa comum. Com as 100 requisições por minuto do Core, isso é confortável; no Hobby, extrações grandes batem em erros 429.
Uma engenheira de prompts que mantém um system prompt de produção
Promover uma versão testada do prompt para produção sem abrir a interface web
O getPrompt busca a candidata e o updatePromptLabels move o label de produção depois da revisão. As chamadas GET de prompts não têm limite de requisição, mas a mudança de label vale imediatamente para o tráfego ao vivo, então mantenha-a atrás de um prompt de aprovação.
Um líder de avaliação em uma startup de IA com 40 pessoas no Langfuse Pro
Transformar casos reais de falha em um dataset de regressão e rodar um avaliador sobre ele
O agente usa batchUpsertDatasetItems a partir de observações selecionadas e depois runBatchEvaluation. O custo da plataforma é o plano Pro, a US$ 199 por mês, mais US$ 8 por 100 mil unidades além das 100 mil incluídas; as chamadas de LLM do avaliador são cobradas pelo seu provedor de modelo.
Antes de decidir
- Configuração
- Crie uma chave de API do projeto, codifique pk-lf-...:sk-lf-... em base64 e registre o endpoint com um cabeçalho Authorization: Basic. O Langfuse documenta Claude Code, Codex, Cursor e Pi; são poucos minutos até a primeira chamada a listPrompts.
- Integrações
- Cerca de 95 ferramentas na MCP Reference, cobrindo prompts, skills, observações, filas de anotação, comentários, datasets, experimentos, scores, métricas, modelos, conexões de LLM, avaliadores, regras de avaliação, dashboards e alertas. Cerca de metade grava ou exclui.
- Dados e privacidade
- Hospedado pelo Langfuse no Cloud, então lê seus dados de traces onde eles já estão; a auto-hospedagem os mantém na sua infraestrutura. Um projeto por chave. O conteúdo dos traces é entrada não confiável para injeção de prompt.
- Custo em escala
- Sem taxa separada. O MCP compartilha o bucket General API, com 30, 100 ou 1.000 requisições por minuto no Hobby, Core e Pro; o Enterprise (US$ 2.499/mês) pode pedir limites personalizados. O uso além das franquias do plano custa US$ 8 por 100 mil unidades.
- Limites
- Os limites de requisição são por organização e em janela fixa; as respostas 429 trazem Retry-After. Os esquemas se autodescrevem e podem mudar. Instâncias auto-hospedadas atrás de um proxy reverso precisam preservar o cabeçalho Host ou definir LANGFUSE_MCP_ALLOWED_HOSTS, ou retornam 403.
O que é bom
- Hospedado em todas as regiões do Langfuse e em toda instância auto-hospedada; nada a executar
- Cerca de 95 ferramentas para prompts, traces, datasets, avaliações e dashboards
- Chaves com escopo de projeto limitam o alcance a um projeto
- O servidor MCP de busca na documentação não exige chave
O que não é
- 30 requisições por minuto no Hobby, compartilhadas com todo o outro uso da API
- Ferramentas de escrita e exclusão ativadas por padrão
- A chave secreta completa fica na configuração do cliente como autenticação Basic
- Os esquemas das ferramentas podem mudar sem aviso
Ideal para
Equipes que já usam o Langfuse e querem um agente de programação para inspecionar traces, organizar datasets e gerenciar prompts a partir do editor.
Alternativas ao Langfuse MCP Server
Langfuse MCP Server: perguntas frequentes
- Langfuse MCP Server vale a pena?
- Nada a instalar e quase toda a API do Langfuse, mas, com as 30 requisições por minuto do plano gratuito, um agente que vasculha traces chega ao fim da linha rapidamente. Damos nota 4.2 de 5.
- Quanto custa Langfuse MCP Server?
- Incluído no Langfuse. Cloud: Hobby gratuito (50 mil unidades/mês); Core a US$ 29/mês; Pro a US$ 199/mês; Enterprise a US$ 2.499/mês; uso extra a US$ 8 por 100 mil unidades. A versão auto-hospedada é gratuita.
- Quais são as desvantagens de Langfuse MCP Server?
- 30 requisições por minuto no Hobby, compartilhadas com todo o outro uso da API; ferramentas de escrita e exclusão ativadas por padrão; a chave secreta completa fica na configuração do cliente como autenticação Basic; os esquemas das ferramentas podem mudar sem aviso.
- Para quem Langfuse MCP Server é indicado?
- Equipes que já usam o Langfuse e querem um agente de programação para inspecionar traces, organizar datasets e gerenciar prompts a partir do editor.
- Quanto custa Langfuse MCP Server para uma equipe ou em produção?
- Sem taxa separada. O MCP compartilha o bucket General API, com 30, 100 ou 1.000 requisições por minuto no Hobby, Core e Pro; o Enterprise (US$ 2.499/mês) pode pedir limites personalizados. O uso além das franquias do plano custa US$ 8 por 100 mil unidades.
- Langfuse MCP Server é seguro para dados da empresa?
- Hospedado pelo Langfuse no Cloud, então lê seus dados de traces onde eles já estão; a auto-hospedagem os mantém na sua infraestrutura. Um projeto por chave. O conteúdo dos traces é entrada não confiável para injeção de prompt.
- Quais são as melhores alternativas ao Langfuse MCP Server?
- As alternativas mais próximas que analisamos são Sentry MCP e Grafana MCP Server.
Respostas verificadas em 31 de out. de 2026.