freemcplab / 디렉터리 / 플레이그라운드 / Agent Gateway

● 커뮤니티 agentgateway ⚡ 바로 사용

Agent Gateway

Name: Agent Gateway MCP Server
Author: agentgateway

제작: agentgateway · agentgateway/agentgateway

모든 MCP 서버 앞에 프록시 하나를 배치 — Rust로 구현된 플러그형 인증, 요청 처리, 관찰성, 서킷 브레이커.

Agent Gateway는 MCP 및 LLM 트래픽에 특화된 고성능 프록시입니다. 인증 종료, 라우트별 정책 적용, 트레이스 방출, 서킷 브레이킹을 제공합니다. MCP 서버가 두 개 이상이고 중앙 제어가 필요할 때 유용합니다.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

MCP 인식 라우팅
플러그형 인증 (OIDC, mTLS, token)
라우트별 속도 제한
분산 추적 (OTel)
서킷 브레이커 및 재시도
핫 설정 리로드

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "agentgateway": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:3000",
        "ghcr.io/agentgateway/agentgateway:latest"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "agentgateway": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:3000",
        "ghcr.io/agentgateway/agentgateway:latest"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "agentgateway": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:3000",
        "ghcr.io/agentgateway/agentgateway:latest"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agentgateway": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:3000",
        "ghcr.io/agentgateway/agentgateway:latest"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "agentgateway",
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:3000",
        "ghcr.io/agentgateway/agentgateway:latest"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "agentgateway": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-p",
          "3000:3000",
          "ghcr.io/agentgateway/agentgateway:latest"
        ]
      }
    }
  }
}

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

claude mcp add agentgateway -- docker run -p 3000:3000 ghcr.io/agentgateway/agentgateway:latest

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

사용 사례

실전 활용법: Agent Gateway

하나의 인증 표면으로 여러 MCP 서버 통합

👤 개발자 ⏱ ~15 min intermediate

언제 쓸까: 내부 MCP가 5개 이상이고 개발자마다 설정을 복사하는 것이 번거로울 때.

흐름

게이트웨이 배포

IdP 뒤에 agentgateway를 실행합니다.✓ 복사됨

→ 로그인 동작
백엔드 등록

각 MCP 서버를 라우트 및 정책과 함께 추가합니다.✓ 복사됨

→ 백엔드 목록 확인
클라이언트 연결

개발자들이 Claude를 https://mcp.corp/로 지정합니다.✓ 복사됨

→ 단일 설정

결과: MCP 트래픽을 위한 중앙 제어 플레인.

조합

다른 MCP와 조합해 10배 효율

agentgateway + mcp-gateway-registry

레지스트리는 검색 UI에; 이것은 저지연 라우팅에

agentgateway와 mcp-gateway-registry 조합: 레지스트리는 검색 UI에, 이것은 저지연 라우팅에✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
gateway-passthrough	(문서 참조)	등록된 백엔드 MCP로 전달	호출 1회

비용 및 제한

운영 비용

API 쿼터: 호스트에 의해 제한됨
호출당 토큰: 패스스루
금액: 무료 OSS; 호스팅 비용 부담
팁: 서킷 브레이커 활성화 — 연쇄 장애 방지에 효과적

보안

권한, 시크릿, 파급범위

최소 스코프: gateway-admin

자격 증명 저장: 인증 시크릿은 vault에

데이터 외부 송신: 등록한 백엔드로 전송

절대 부여 금지: expose admin API publicly

문제 해결

자주 발생하는 오류와 해결

p99 레이턴시 높음

불필요한 플러그인 비활성화; agentgateway는 빠르지만 플러그인이 쌓입니다

대안

Agent Gateway 다른 것과 비교

대안	언제 쓰나	단점/장점
mcp-context-forge	IBM의 대안을 원할 때	다른 운영 모델