Langfuse MCP Server의 개요
오픈소스 LLM 관측 플랫폼인 Langfuse는 MCP 서버를 제품 안에 내장했습니다. 따로 설치할 것은 없습니다. 각 Langfuse Cloud 리전(미국은 https://us.cloud.langfuse.com/api/public/mcp, 그 밖에 EU, 일본, HIPAA US)과 모든 자체 호스팅 인스턴스가 /api/public/mcp에서 Streamable HTTP로 이 서버를 제공합니다. 인증은 프로젝트 범위의 공개 키와 비밀 키 쌍을 Basic Authorization 헤더로 보내는 방식입니다. 이 서버는 이전의 langfuse/mcp-server-langfuse 저장소를 대체합니다. 그 저장소는 프롬프트만 다루는 서버였고 2025년 2월 이후 커밋이 없습니다.
MCP Reference에는 프롬프트, 스킬, 관측 데이터, 주석 큐, 댓글, 데이터셋과 실험, 점수, 지표, 모델, 평가기와 평가 규칙, 대시보드와 알림에 걸쳐 약 95개의 도구가 올라 있습니다. 읽기 도구와 쓰기 도구가 모두 기본으로 켜져 있습니다. 문서를 검색하는 별도의 인증 없는 서버가 https://langfuse.com/api/mcp에 있습니다. 플랫폼 자체는 repos/langfuse에서 리뷰합니다.
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, 쓸 만한 가치가 있습니까?
벤더 MCP 서버를 단순하게 구현한 사 례입니다. Langfuse 안에 있으므로 항상 프로젝트와 같은 버전이고, Cloud와 자체 호스팅에서 똑같이 작동합니다. 설정은 base64로 인코딩한 키 쌍과 함께 claude mcp add 명령 하나면 됩니다. 범위는 이전의 프롬프트 전용 서버를 훨씬 넘어섭니다. 에이전트는 관측 데이터를 나열하고 필터링하며, 점수를 읽고, 일괄 평가를 실행하고, 프로덕션 트레이스로 데이터셋 항목을 만들고, 프롬프트 라벨을 바꾸고, 대시보드 위젯을 만들 수 있습니다.
독자가 미리 계획해야 할 것은 요청 한도입니다. MCP 호출은 Langfuse의 General API 버킷에 포함되며, 이 버킷은 조직의 모든 프로젝트와 키가 함께 씁니다. 분당 요청 한도는 Hobby에서 30회, Core에서 100회, Pro 이상에서 1,000회입니다. getObservation으로 관측 데이터를 하나씩 넘겨 보는 에이전트는 질문 하나에 Hobby의 1분 한도를 다 쓰고 429 응답이 풀리기를 기다려야 할 수 있습니다.
쓰기 작업은 주의가 필요합니다. 도구의 약 절반이 상태를 바꿉니다. deleteDatasetRun, deleteEvaluationRule, deleteDashboard, 그리고 production 라벨을 다른 프롬프트 버전으로 옮길 수 있는 updatePromptLabels가 여기에 들어갑니다. Langfuse는 읽기만 필요하다면 클라이언트에서 읽기 전용 도구만 허용 목록에 넣으라고 권합니다. 헤더에 담기는 키는 프로젝트의 비밀 키 전체이며, 클라이언트 설정 파일에 평문으로 저장됩니다.
트레이스에는 사용자가 입력한 내용이 무엇이든 담기므로, 이를 읽는 에이전트는 프롬프트 인젝션 위험이 있는 신뢰할 수 없는 텍스트를 읽는 셈입니다. Langfuse 자신도 에이전트가 셸 명령을 실행할 수 있는 곳이라면 MCP보다 자사의 Agent Skill과 CLI를 권하며, 도구 스키마가 예고 없이 바뀔 수 있다고 밝힙니다. 도구 이름에 워크플로를 고정하려는 사람에게는 정당한 경고입니다.
제 역할을 하는 곳
Langfuse Cloud US를 쓰는 지원 봇 팀의 AI 엔지니어
어젯밤 봇이 낮은 점수를 받은 대화를 찾아 이유 알아보기
필터를 건 listObservations와 listScores가 실패한 트레이스를 Claude Code로 가져오고, Claude Code가 공통 원인을 요약합니다. Core의 분당 100회 요청이면 여유가 있지만, Hobby에서는 대량 조회가 429에 걸립니다.
프로덕션 시스템 프롬프트를 관리하는 프롬프트 엔지니어
웹 UI를 열지 않고 테스트를 마친 프롬프트 버전을 프로덕션으로 올리기
getPrompt가 후보를 가져오고, 검토 후 updatePromptLabels가 production 라벨을 옮깁니다. 프롬프트 GET 호출에는 요청 한도가 없지만, 라벨 변경은 실시간 트래픽에 즉시 적용되므로 승인 프롬프트 뒤에 두십시오.
Langfuse Pro를 쓰는 40인 규모 AI 스타트업의 평가 책임자
실제 실패 사례를 회귀 데이터셋으로 만들고 그 위에서 평가기 실행하기
에이전트가 선택한 관측 데이터로 batchUpsertDatasetItems를 실행한 다음 runBatchEvaluation을 실행합니다. 플랫폼 비용은 월 $199인 Pro 요금제에, 포함된 100k 단위를 넘으면 100k 단위당 $8이 더해집니다. 평가기의 LLM 호출 비용은 모델 제공업체가 청구합니다.
도입 전 확인할 점
- 설정
- 프로젝트 API 키를 만들고 pk-lf-...:sk-lf-...를 base64로 인코딩한 뒤, Authorization: Basic 헤더와 함께 엔드포인트를 등록합니다. Langfuse는 Claude Code, Codex, Cursor, Pi용 문서를 제공하며, 첫 listPrompts 호출까지 몇 분이면 됩니다.
- 연동
- MCP Reference에 약 95개의 도구가 있으며 프롬프트, 스킬, 관측 데이터, 주석 큐, 댓글, 데이터셋, 실험, 점수, 지표, 모델, LLM 연결, 평가기, 평가 규칙, 대시보드, 알림을 다룹니다. 약 절반은 쓰기나 삭제를 합니다.
- 데이터와 개인정보
- Cloud에서는 Langfuse가 호스팅하므로 트레이스 데이터가 이미 있는 곳에서 읽습니다. 자체 호스팅하면 데이터가 자사 인프라에 남습니다. 키 하나에 프로젝트 하나입니다. 트레이스 내용은 프롬프트 인젝션에 대해 신뢰할 수 없는 입력입니다.
- 대규모 사용 시 비용
- 별도 요금은 없습니다. MCP는 General API 버킷을 함께 쓰며 한도는 Hobby, Core, Pro에서 각각 분당 30, 100, 1,000회 요청입니다. Enterprise(월 $2,499)는 맞춤 한도를 요청할 수 있습니다. 요금제 허용량을 넘는 사용량은 100k 단위당 $8입니다.
- 제한
- 요청 한도는 조직 단위이며 고정 윈도 방식입니다. 429 응답에는 Retry-After가 붙습니다. 스키마는 자기 기술적이며 바뀔 수 있습니다. 리버스 프록시 뒤의 자체 호스팅 인스턴스는 Host 헤더를 유지하거나 LANGFUSE_MCP_ALLOWED_HOSTS를 설정해야 하며, 그렇지 않으면 403을 반환합니다.
좋은 점
- 모든 Langfuse 리전과 자체 호스팅 인스턴스에서 호스팅되어 따로 실행할 것이 없습니다
- 프롬프트, 트레이스, 데이터셋, 평가, 대시보드에 걸쳐 약 95개의 도구가 있습니다
- 프로젝트 범위의 키로 접근을 한 프로젝트에 제한합니다
- 문서 검색용 Docs MCP 서버는 키가 필요 없습니다
아쉬운 점
- Hobby에서는 분당 30회 요청이며 다른 API 사용과 한도를 나눠 씁니다
- 쓰기와 삭제 도구가 기본으로 켜져 있습니다
- 비밀 키 전체가 Basic 인증으로 클라이언트 설정에 들어갑니다
- 도구 스키마가 예고 없이 바뀔 수 있습니다
추천 대상
이미 Langfuse를 쓰면서 코딩 에이전트에게 에디터 안에서 트레이스를 살펴보고, 데이터셋을 정리하고, 프롬프트를 관리하게 하고 싶은 팀입니다.
Langfuse MCP Server 대안
Langfuse MCP Server: 자주 묻는 질문
- Langfuse MCP Server, 쓸 만한 가치가 있습니까?
- 설치할 것이 없고 Langfuse API의 거의 전부를 다룹니다. 다만 무료 요금제의 분당 30회 요청으로는 트레이스를 파고드는 에이전트가 금방 한계에 부딪힙니다. 평점은 5점 만점에 4.2점입니다.
- Langfuse MCP Server의 가격은 얼마입니까?
- Langfuse에 포함되어 있습니다. Cloud: Hobby 무료(월 50k 단위), Core 월 $29, Pro 월 $199, Enterprise 월 $2,499, 추가 사용량은 100k 단위당 $8입니다. 자체 호스팅은 무료입니다.
- Langfuse MCP Server의 단점은 무엇입니까?
- Hobby에서는 분당 30회 요청이며 다른 API 사용과 한도를 나눠 씁니다; 쓰기와 삭제 도구가 기본으로 켜져 있습니다; 비밀 키 전체가 Basic 인증으로 클라이언트 설정에 들어갑니다; 도구 스키마가 예고 없이 바뀔 수 있습니다.
- Langfuse MCP Server에 적합한 사람은 누구입니까?
- 이미 Langfuse를 쓰면서 코딩 에이전트에게 에디터 안에서 트레이스를 살펴보고, 데이터셋을 정리하고, 프롬프트를 관리하게 하고 싶은 팀입니다.
- 팀이나 프로덕션 환경에서 Langfuse MCP Server의 비용은 얼마입니까?
- 별도 요금은 없습니다. MCP는 General API 버킷을 함께 쓰며 한도는 Hobby, Core, Pro에서 각각 분당 30, 100, 1,000회 요청입니다. Enterprise(월 $2,499)는 맞춤 한도를 요청할 수 있습니다. 요금제 허용량을 넘는 사용량은 100k 단위당 $8입니다.
- Langfuse MCP Server에 회사 데이터를 맡겨도 안전합니까?
- Cloud에서는 Langfuse가 호스팅하므로 트레이스 데이터가 이미 있는 곳에서 읽습니다. 자체 호스팅하면 데이터가 자사 인프라에 남습니다. 키 하나에 프로젝트 하나입니다. 트레이스 내용은 프롬프트 인젝션에 대해 신뢰할 수 없는 입력입니다.
- Langfuse MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Sentry MCP 및 Grafana MCP Server입니다.
답변 확인일: 2026년 10월 31일.
Langfuse MCP Server 개발사입니까? 이 평점을 사이트에 표시하십시오
