Skip to main content
Glama
deenesjakoruzh
respanai

Respan MCP Server

Official
by respanai
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Respan MCP Server

Model Context Protocol (MCP) 서버 - AI 어시스턴트에서 직접 로그, 프롬프트, 트레이스, 고객 데이터에 액세스할 수 있는 Respan용 서버입니다.

기능

  • 로그 - LLM 요청 로그를 조회, 필터링, 생성합니다

  • 트레이스 - 스팬 트리가 포함된 전체 실행 트레이스를 확인합니다

  • 고객 - 고객 데이터와 예산 정보에 액세스합니다

  • 프롬프트 - 프롬프트 템플릿과 버전을 관리합니다

Related MCP server: MCP Datadog Server

빠른 시작

옵션 1: 공용 HTTP (권장)

설치가 필요 없습니다.

  1. platform.respan.ai에서 API 키를 받으세요.

  2. MCP 구성 파일에 추가하세요:

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "respan": {
      "url": "https://mcp.respan.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_RESPAN_API_KEY"
      }
    }
  }
}

Claude Desktop (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "respan": {
      "url": "https://mcp.respan.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_RESPAN_API_KEY"
      }
    }
  }
}

  1. Cursor/Claude Desktop을 다시 시작하세요.

옵션 2: 로컬 Stdio

개인 개발이나 오프라인 사용을 위해 MCP 서버를 로컬에서 실행합니다.

사전 요구 사항: Node.js v18+

git clone https://github.com/respanai/respan-mcp.git
cd respan-mcp
npm install
npm run build
{
  "mcpServers": {
    "respan": {
      "command": "node",
      "args": ["/absolute/path/to/respan-mcp/dist/lib/index.js"],
      "env": {
        "RESPAN_API_KEY": "YOUR_RESPAN_API_KEY"
      }
    }
  }
}

옵션 3: 프라이빗 HTTP (팀)

단일 배포를 공유하는 팀을 위해 자체 인스턴스를 Vercel에 배포합니다.

Deploy with Vercel

Vercel 대시보드 > 설정 > 환경 변수에서 RESPAN_API_KEY를 설정하세요.

이 구성을 팀과 공유하세요:

{
  "mcpServers": {
    "respan": {
      "url": "https://your-project.vercel.app/mcp"
    }
  }
}

사용 가능한 도구

조직

도구

설명

list_organizations

계정이 활동할 수 있는 조직과 현재 활성 조직을 나열합니다

switch_organization

이름, organization_id 또는 team_id로 활성 조직을 전환합니다

다른 모든 도구는 활성 조직만 읽고 씁니다. 전환은 계정 전체에 적용되며 영구적입니다. 백엔드가 활성 조직을 토큰이 아닌 사용자 레코드에 저장하기 때문에 Respan 웹 앱과 다른 모든 세션도 같은 조직으로 이동합니다. OAuth 로그인이 필요합니다. API 키는 이미 하나의 조직에 바인딩되어 있어 전환할 수 없습니다.

로그

도구

설명

list_logs

강력한 쿼리 기능으로 LLM 요청 로그를 나열하고 필터링합니다

get_log_detail

고유 ID로 단일 로그의 전체 세부 정보를 검색합니다

create_log

모든 유형의 LLM 요청에 대한 새 로그 항목을 생성합니다

트레이스

도구

설명

list_traces

정렬 및 페이지네이션으로 트레이스를 나열하고 필터링합니다

get_trace_tree

트레이스의 완전한 계층형 스팬 트리를 검색합니다

고객

도구

설명

list_customers

페이지네이션 및 정렬로 고객을 나열합니다

get_customer_detail

예산 사용량을 포함한 고객 세부 정보를 가져옵니다

프롬프트

도구

설명

list_prompts

조직의 모든 프롬프트를 나열합니다

get_prompt_detail

상세 프롬프트 정보를 가져옵니다

list_prompt_versions

프롬프트의 모든 버전을 나열합니다

get_prompt_version_detail

특정 버전의 세부 정보를 가져옵니다

워크플로우

도구

설명

list_workflows

자동화, 모니터, 예약 내보내기, 평가자 파이프라인을 나열합니다

filter_workflows

유형 또는 다른 필드로 워크플로우를 필터링합니다

get_workflow

워크플로우와 해당 작업 정의를 검색합니다

create_automation_workflow

이벤트 기반 자동화를 생성합니다. 필수 대시보드 샘플링 게이트를 추가합니다

create_monitor_workflow

집계/조건 및 전달 작업에서 모니터를 생성합니다

create_export_workflow

cron 및 내보내기 전용 옵션에서 예약 내보내기를 생성합니다

create_workflow

고급 저수준 워크플로우 생성을 위한 탈출구

update_workflow

편집 가능한 워크플로우 초안을 업데이트합니다

delete_workflow

워크플로우 패밀리와 모든 버전을 삭제합니다

list_workflow_versions

워크플로우 패밀리의 버전을 나열합니다

get_workflow_version

특정 워크플로우 버전을 검색합니다

commit_workflow

현재 초안을 커밋합니다

deploy_workflow

커밋된 워크플로우 버전을 배포합니다

undeploy_workflow

배포된 워크플로우를 중지합니다

validate_workflow

샘플 데이터에 대해 워크플로우 작업을 검증합니다

백엔드 라우트는 공유되지만 MCP 생성 함수는 의도적으로 분리되어 있습니다. 자동화는 이벤트 기반 작업 파이프라인이며 대시보드 호환 auto-sampling 게이트를 받습니다. 모니터는 집계, 조건, 전달 작업을 허용하며 알림 또는 웹훅이 필요합니다. 내보내기는 UTC 5필드 cron과 내보내기 전용 필터, 필드, 인라인 결과 동작 및 샘플링을 허용합니다.

필터 구문

필터링을 지원하는 도구는 filters 객체를 받습니다:

{
  "cost": {"operator": "gt", "value": [0.01]},
  "model": {"operator": "", "value": ["gpt-4"]},
  "customer_identifier": {"operator": "contains", "value": ["user"]},
  "metadata__session_id": {"operator": "", "value": ["abc123"]}
}

연산자: "" (equal), not, lt, lte, gt, gte, contains, icontains, startswith, endswith, in, isnull

프로젝트 구조

respan-mcp/
├── api/
│   └── mcp.ts                # HTTP entry point (Vercel serverless function)
├── lib/
│   ├── index.ts              # Stdio entry point (local mode)
│   ├── shared/
│   │   └── client.ts         # API client, auth config, path validation
│   ├── observe/
│   │   ├── logs.ts           # list_logs, get_log_detail, create_log
│   │   ├── traces.ts         # list_traces, get_trace_tree
│   │   └── users.ts          # list_customers, get_customer_detail
│   ├── account/
│   │   └── organizations.ts  # list_organizations, switch_organization
│   └── develop/
│       └── prompts.ts        # list_prompts, get_prompt_detail, versions
├── vercel.json               # Vercel config (rewrites, function timeout)
├── tsconfig.json             # TypeScript config
└── package.json

아키텍처

  • 두 진입점: api/mcp.ts (Vercel을 통한 HTTP) 및 lib/index.ts (로컬 사용을 위한 stdio)

  • 공유 코어: 두 진입점 모두 AuthConfig를 생성하고 클로저를 통해 동일한 도구 등록 함수에 전달합니다. 전역 변경 가능 상태가 없습니다.

  • 도구 모듈: 도메인별로 구성됩니다 (observe/는 런타임 데이터, develop/는 프롬프트 관리).

  • API 클라이언트: lib/shared/client.ts는 30초 타임아웃, 경로 검증, 인증으로 모든 업스트림 API 호출을 처리합니다.

엔터프라이즈 구성

사용자 지정 API 엔드포인트의 경우 RESPAN_API_BASE_URL 환경 변수를 설정하세요:

Stdio 모드:

{
  "mcpServers": {
    "respan": {
      "command": "node",
      "args": ["/path/to/respan-mcp/dist/lib/index.js"],
      "env": {
        "RESPAN_API_KEY": "YOUR_API_KEY",
        "RESPAN_API_BASE_URL": "https://your-endpoint.example.com/api"
      }
    }
  }
}

프라이빗 배포: Vercel 환경 변수에 RESPAN_API_BASE_URL을 설정하세요.

로컬 개발

npm run build        # Compile TypeScript
npm run stdio        # Build and run in stdio mode

로컬 OAuth 브로커

이 저장소에는 공용 OAuth 및 MCP 라우트를 위한 Vercel 독립 HTTP 하네스가 포함되어 있습니다. 기존 로컬 백엔드 및 Redis 서비스를 사용하며, 두 서비스를 시작하거나 다시 시작하거나 지우지 않습니다.

gitignore된 .env.local을 생성하세요:

OAUTH_SECRET=<locally-generated-random-secret-of-at-least-32-characters>
OAUTH_SESSION_STORE=redis
REDIS_URL=redis://127.0.0.1:6379/15
MCP_REDIS_KEY_PREFIX=respan-mcp:local:
MCP_PUBLIC_BASE_URL=http://127.0.0.1:3100
MCP_ACCESS_TOKEN_TTL_SECONDS=60
RESPAN_API_BASE_URL=http://127.0.0.1:8000/api
RESPAN_ENTERPRISE_API_BASE_URL=http://127.0.0.1:8000/api

# Used only by the complete local verification probe:
OAUTH_TEST_EMAIL=<local-test-account-email>
OAUTH_TEST_PASSWORD=<local-test-account-password>
# Required by the platform probe's API-key compatibility check.
OAUTH_TEST_API_KEY=<local-test-api-key>
# Optional; defaults to platform. Also accepts enterprise.
OAUTH_TEST_REALM=platform

Vercel에서 사용하는 것과 동일한 Upstash REST 어댑터를 사용하려면 로컬 Redis 설정을 다음으로 바꾸세요:

OAUTH_SESSION_STORE=upstash
UPSTASH_REDIS_REST_URL=<upstash-rest-url>
UPSTASH_REDIS_REST_TOKEN=<upstash-rest-token>

로컬 키 접두사는 Preview 및 Production과 구별되게 유지하세요. 프로브는 항상 실행별 고유 접두사로 바꾸고 해당 키만 삭제합니다.

수동 브라우저 테스트를 위해 로컬 서비스를 실행하세요:

npm run dev:oauth

자동화된 검증 명령은 자체 격리된 브로커 하네스를 실행하므로 별도의 dev:oauth 프로세스 없이 실행하세요:

npm run verify:oauth:local

엔터프라이즈 리소스와 백엔드를 통해 동일한 수명 주기를 실행하려면 다음을 실행하세요:

OAUTH_TEST_REALM=enterprise npm run verify:oauth:local

리프레시 회전이 절대 리프레시 세션 기한을 연장하지 않는지 확인하려면 짧은 로컬 수명으로 프로브를 실행하세요:

OAUTH_VERIFY_REFRESH_EXPIRY=true \
MCP_REFRESH_SESSION_TTL_SECONDS=180 \
npm run verify:oauth:local

프로브는 액세스 토큰이 만료된 후 리프레시 토큰을 회전시키고, 원래 세션 발급 시점으로부터 3분이 될 때까지 기다린 다음, 최신 리프레시 토큰에서 invalid_grant를 요구합니다. 이 설정은 로컬 검증 전용입니다.

프로브는 127.0.0.1:3100에서 자체 격리 하네스를 시작하고, 고유한 Redis 키 접두사를 사용하며, 단계 상태와 소요 시간만 출력하고, 해당 고유 접두사의 키만 제거합니다. 같은 포트에서 dev:oauth를 동시에 실행하지 마세요. Google 로그인은 별도로 구성된 로컬 백엔드 자격 증명이 필요합니다. 결정적 자동화 스위트는 자격 증명 없이 브로커 동작을 다룹니다.

호스팅된 OAuth 클라이언트 등록은 HTTPS 콜백과 루프백에 바인딩된 HTTP 콜백을 허용합니다. 즉 리터럴 주소 127.0.0.1 및 [::1] 또는 호스트 이름 localhost이며, Claude Code와 MCP Inspector가 등록하는 주소입니다. 호스트 이름 일치는 정확하므로 localhost.attacker.example와 sub.localhost는 루프백이 아닙니다. 다른 HTTP 호스트, 실행 가능한 URL 스킴, 자격 증명, 프래그먼트, 중복 콜백, 그리고 과도하게 큰 콜백 목록은 거부됩니다.

Vercel 배포는 인메모리 저장소 대신 Upstash가 필요합니다. 프로덕션 공용 및 백엔드 URL은 HTTPS를 사용해야 하며, OAuth 시크릿과 Redis 자격 증명은 배포 비밀 관리자를 통해서만 구성해야 합니다.

전체 Preview 및 Production 설정, 환경 변수 매트릭스, Vercel 서비스 구성, 검증 게이트, 모니터링 및 롤백 절차는 공개 MCP OAuth 브로커: Vercel 배포 런북을 참조하세요.

자동화된 검사:

npm test
TEST_REDIS_URL=redis://127.0.0.1:6379/15 npm test -- --run tests/redis-store.integration.test.ts
npm run build
git diff --check

문서

전체 문서는 docs.respan.ai/documentation/resources/mcp에서 확인하세요.

라이선스

MIT

Install Server
F
license - not found
B
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • Shepherd MCP

    neuralis-in
    A
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to query and analyze AI agent sessions from observability providers like Shepherd (AIOBS) and Langfuse, allowing users to debug agent runs, compare sessions, track performance, and analyze LLM usage patterns.
    18
    MIT

  • Datadog MCP Server

    TANTIOPE
    A
    license
    A
    quality
    B
    maintenance
    Enables AI assistants to access full Datadog observability, including log search, APM trace filtering, smart sampling, and cross-correlation between logs, traces, and metrics.
    23
    1,015
    5
    Apache 2.0

  • datadog-mcp

    techskies11
    A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to search logs, query metrics, manage dashboards, analyze APM traces, and control monitors via Datadog APIs.
    30
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/respanai/respan-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server