Skip to content

MCP 서버 관리 개발 중 ​

통합 관리

하나의 중앙 구성으로 여러 CLI 간 동기화

Switch는 Claude Code / Codex / Gemini 각각의 mcp_servers.json에 흩어져 있던 구성을 통합 관리하고, 시각적 디버깅 기능을 제공합니다.

MCP 관리자 ​

Switch 열기 → 왼쪽 "MCP 서버"에서 다음을 확인할 수 있습니다:

등록 상태

현재 등록된 모든 MCP Server, 상태 포함 running stopped errored

참조 관계

각 Server가 어떤 CLI에서 참조되는지

호출 기록

최근 N회의 도구 호출 기록

구성 형식 ​

Switch는 하나의 중앙 ~/.lurus-switch/mcp.yaml을 사용합니다:

yaml
servers:
  github:
    command: npx
    args: [-y, '@modelcontextprotocol/server-github']
    env:
      GITHUB_TOKEN: ${GITHUB_TOKEN}
    visible_to: [claude-code, codex]

  postgres:
    command: docker
    args: [run, -i, --rm, mcp/postgres, 'postgres://localhost/dev']
    visible_to: [claude-code]

  kova:
    url: http://localhost:3333
    type: http
    visible_to: [claude-code, codex, gemini]

visible_to 기반 온디맨드 배포

CLI를 전환할 때마다 Switch는 visible_to에 따라 해당 CLI의 mcp_servers.json을 동적으로 생성하며, 각 도구는 자신에게 할당된 Server만 보게 됩니다.

디버깅 ​

Server 하나를 선택하면 오른쪽 디버그 패널에서:

Tools 목록

Server가 노출하는 모든 도구, 입력 매개변수 schema 포함

수동 호출

매개변수를 입력해 직접 테스트

Request Log

최근 request/response의 전체 JSON

재시작

프로세스 레벨 재시작

자주 쓰는 Server 빠른 연동 ​

Switch에는 원클릭 설치 버튼이 내장되어 있어 구성을 직접 작성할 필요가 없습니다:

Server용도
githubissues / PR / file 읽기·쓰기
postgres데이터베이스 쿼리
filesystem로컬 파일 읽기·쓰기
slack메시지 전송 / 채널 읽기
kovaKova Agent를 도구로 사용
lumenLumen Trace / Replay

팀에 동기화 ​

팀 동기화를 참조하세요.

다음 단계 ​

다음 단계

Powered by Lurus Technologies