Langfuse 문서 MCP Server

Langfuse 문서 MCP Server

Langfuse Docs MCP 서버는 Langfuse 문서를 AI 에이전트에 노출합니다. 이 문서는 핵심 사용 사례와 함께 Claude Code, Codex, Cursor, Windsurf, VS Code Copilot에 MCP 서버를 설치하는 방법을 설명해요. 공개 MCP 서버이며, 인증이 필요한 데이터 플랫폼용 MCP 서버와는 구분됩니다.

출처: 문서

본문

Langfuse Docs MCP 서버는 Langfuse 문서를 AI 에이전트에 노출합니다.

핵심 사용 사례: Cursor(또는 다른 AI 코딩 에이전트)를 사용해 Langfuse Tracing을 코드베이스에 자동으로 통합하세요. 자세한 지침과 예제 프롬프트는 get started 를 참고하세요.

이것은 Langfuse 문서를 위한 공개 MCP 서버입니다. 나머지 Langfuse 데이터 플랫폼과 통합하기 위한 인증된 MCP 서버도 있습니다 (docs).

Agent Skill과 함께 사용

MCP 서버 옆에 Langfuse Agent Skill 도 설치하면 더 나은 결과를 얻을 수 있습니다.

GitHub 에서 설치하거나 Agent Skill 설정 을 따라 하세요.

설치

Claude Code

CLI로 Langfuse Docs MCP를 추가:

claude mcp add \
  --transport http \
  langfuse-docs \
  https://langfuse.com/api/mcp \
  --scope user

수동 구성: 대신 설정 파일에 다음을 추가하세요.

  • User scope: ~/.claude/settings.json
  • Project scope: your-repo/.claude/settings.json
  • Local scope: your-repo/.claude/settings.local.json
{
  "mcpServers": {
    "langfuse-docs": {
      "transportType": "http",
      "url": "https://langfuse.com/api/mcp",
      "verifySsl": true
    }
  }
}

한 줄 JSON 임포트:

claude mcp add-json langfuse-docs \
  '{"type":"http","url":"https://langfuse.com/api/mcp"}'

추가한 뒤 Claude Code 세션(claude)을 시작하고 /mcp를 입력해 연결을 확인하세요.

Codex

CLI로 추가:

codex mcp add langfuse-docs --url https://langfuse.com/api/mcp

수동 구성: ~/.codex/config.toml에 다음을 추가:

[mcp_servers.langfuse-docs]
url = "https://langfuse.com/api/mcp"

새 Codex 세션을 시작한 뒤 codex mcp list를 실행해 서버가 등록됐는지 확인하세요.

Cursor

원클릭 설치: Install MCP Server in Cursor

수동 구성: mcp.json에 다음을 추가:

{
  "mcpServers": {
    "langfuse-docs": {
      "url": "https://langfuse.com/api/mcp"
    }
  }
}

Windsurf

다음 단계로 추가:

  1. Command Palette 열기 (⌘+Shift+P)
  2. "MCP Configuration Panel" 열기
  3. Add custom server 선택
  4. 다음 구성 추가:
{
  "mcpServers": {
    "langfuse-docs": {
      "command": "npx",
      "args": ["mcp-remote", "https://langfuse.com/api/mcp"]
    }
  }
}

VS Code의 Copilot

원클릭 설치: Install MCP Server in VS Code

수동 구성: 다음 단계로 추가:

  1. Command Palette 열기 (⌘+Shift+P)
  2. "MCP: Add Server..." 열기
  3. HTTP 선택
  4. https://langfuse.com/api/mcp 붙여넣기
  5. 이름(예: langfuse-docs)과 user/workspace 설정 저장 여부 선택
  6. 완료! MCP 서버가 이제 Agent 모드에서 사용 가능합니다

Langfuse는 MCP 서버와 통신할 때 streamableHttp 프로토콜을 사용합니다. 대부분의 클라이언트가 이를 지원합니다.

{
  "mcpServers": {
    "langfuse-docs": {
      "url": "https://langfuse.com/api/mcp"
    }
  }
}

streamableHttp를 지원하지 않는 클라이언트(예: Windsurf)는 mcp-remote 명령을 로컬 프록시로 사용할 수 있습니다.

{
  "mcpServers": {
    "langfuse-docs": {
      "command": "npx",
      "args": ["mcp-remote", "https://langfuse.com/api/mcp"]
    }
  }
}

정보(About)

  • Endpoint: https://langfuse.com/api/mcp
  • Transport: streamableHttp
  • Authentication: None(없음)

MCP Reference 는 현재 Docs MCP 도구, 입력 스키마, 생성된 요청 예시의 표준 소스입니다.

참고 자료(References)

REST 엔드포인트

기본 문서 검색(searchLangfuseDocs 도구)은 https://langfuse.com/api/search-docs에서 REST API로도 독립적으로 사용할 수 있습니다.

curl "https://langfuse.com/api/search-docs?query=Langfuse+Docs+MCP+Server"

MCP 외부에서 가벼운 시맨틱 검색이 필요할 때 이 엔드포인트를 직접 사용하세요.

더 알아보기 (Learn more)