/ 디렉터리 / 플레이그라운드 / Langfuse MCP
● 공식 langfuse ⚡ 바로 사용

Langfuse MCP

제작: langfuse · langfuse/mcp-server-langfuse

Manage Langfuse LLM-observability prompts from your agent.

Langfuse is open-source LLM observability and prompt management. This MCP lets Claude read prompt versions, fetch traces, and update prompt templates — useful for prompt engineers who want their assistant to actually touch the prompt store.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

langfuse-mcp.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@langfuse/mcp-server"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@langfuse/mcp-server"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@langfuse/mcp-server"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@langfuse/mcp-server"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "langfuse-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@langfuse/mcp-server"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "langfuse-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@langfuse/mcp-server"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add langfuse-mcp -- npx -y @langfuse/mcp-server

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Langfuse MCP

Iterate on a production prompt with traceable versions

👤 Prompt engineers ⏱ ~15 min intermediate

언제 쓸까: You want to A/B a prompt without leaving the chat.

사전 조건
  • Server/skill installed and authenticated — See repo README
흐름
  1. Pull the current production prompt
    Get the 'support-triage' prompt labeled 'production' from Langfuse.✓ 복사됨
    → Current prompt text + version number
  2. Test a tweak
    Create version with my proposed change labeled 'staging'. Don't promote.✓ 복사됨
    → New version saved, 'production' label untouched

결과: Versioned, reviewable prompt history.

함정
  • Labels are mutable — Labels are mutable — moving 'production' to a new version is an instant rollout. Confirm before relabel.
함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

langfuse-mcp + filesystem

Pair with filesystem for complementary capabilities

Use this server together with filesystem to complete a multi-step task.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
get_prompt name, version|label Retrieve a prompt for inspection or copying 1 API call
create_prompt name, prompt_text, labels Save a new version 1 API call
list_traces user_id|session_id, limit Debug a specific user/session 1 API call

비용 및 제한

운영 비용

API 쿼터
See provider docs for rate limits
호출당 토큰
Varies by tool
금액
See repo README for pricing details
Cache tool results and avoid repeated identical calls.

보안

권한, 시크릿, 파급범위

자격 증명 저장: Use environment variables; never commit secrets
데이터 외부 송신: Tool calls go to the provider's API as documented

문제 해결

자주 발생하는 오류와 해결

401 Unauthorized

Create a project in Langfuse, generate a key pair, set LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY.

확인: get_prompt on a known name works
prompt not found

Prompts are project-scoped. Confirm LANGFUSE_HOST and that the prompt exists in the target project.

확인: Open the Langfuse UI for that project

대안

Langfuse MCP 다른 것과 비교

대안언제 쓰나단점/장점
comet-ml/opik-mcpYou already use Opik for tracingSimilar feature set; different vendor

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기