Molayo

© 2026 Molayo

GitHub요약2026. 05. 22. 22:28

Kong/mcp-konnect

요약

Kong Konnect API와 상호작용하여 AI 어시스턴트가 게이트웨이 설정, 트래픽 및 분석 데이터를 관리할 수 있게 돕는 MCP 서버 프로젝트입니다. 현재 이 저장소는 사용 중단(Deprecated)되어 아카이브될 예정이며, 대신 Konnect 원격 MCP 서버 사용을 권장합니다.

핵심 포인트

  • Claude 등 MCP 호환 AI를 통한 Kong Konnect API 관리 지원
  • API 요청 분석, 게이트웨이 설정 조회 및 컨트롤 플레인 관리 기능
  • 현재 프로젝트는 유지 관리되지 않는 아카이브 예정 상태임
  • Node.js 환경 및 Kong Konnect API 키 필요

경고

이 프로젝트는 더 이상 활발하게 유지 관리되지 않으며 읽기 전용(read-only)으로 아카이브될 예정입니다.

더 이상의 업데이트, 버그 수정 또는 새로운 기능 추가는 이루어지지 않습니다. 이슈(Issues)와 풀 리퀘스트(Pull requests)는 더 이상 모니터링되지 않습니다.

Kong Konnect MCP 지원을 찾고 계신다면, Konnect 원격 MCP 서버를 확인해 주세요.

참고: 이 저장소는 사용 중단(deprecated)되었으며 곧 읽기 전용으로 아카이브될 예정입니다. 자세한 내용은 위의 공지를 참조하십시오.

Kong Konnect API와 상호작용하기 위한 Model Context Protocol (MCP) 서버로, AI 어시스턴트가 Kong Gateway의 설정, 트래픽 및 분석 데이터를 쿼리하고 분석할 수 있도록 지원합니다.

  • 개요 (Overview)
  • 프로젝트 구조 (Project Structure)
  • 설치 (Installation)
  • 설정 (Configuration)
  • 사용 가능한 도구 (Available Tools)
  • Claude와 함께 사용하기 (Usage with Claude)
  • 예시 워크플로우 (Example Workflows)
  • 개발 (Development)
  • 문제 해결 (Troubleshooting)

이 프로젝트는 더 이상 유지 관리되지 않습니다. 아래 정보는 참조용으로만 보존됩니다.⚠️ 사용 중단(Deprecated):

이 프로젝트는 Claude와 같은 AI 어시스턴트가 Kong Konnect의 API Gateway와 상호작용할 수 있도록 하는 Model Context Protocol (MCP) 서버를 제공합니다. 자연어 대화를 통해 분석 데이터를 쿼리하고, 설정 세부 정보를 검사하며, 컨트롤 플레인(control planes)을 관리할 수 있는 일련의 도구를 제공합니다.

주요 기능:

  • 사용자 정의 가능한 필터를 통한 API 요청 분석(analytics) 쿼리
  • 게이트웨이 서비스, 라우트(routes), 컨슈머(consumers) 및 플러그인(plugins) 목록 조회 및 검사
  • 컨트롤 플레인(control planes) 및 컨트롤 플레인 그룹 관리
  • Claude 및 기타 MCP 호환 AI 어시스턴트와의 통합
build/ # 릴리스/배포 흐름에서 사용되는 커밋된 컴파일 JavaScript 출력물
src/
├── index.ts # 메인 엔트리 포인트(Main entry point)
...

참고: 이 프로젝트는 사용 중단되었으므로, 설치 문제에 대한 지원은 제공되지 않습니다.

  • Node.js 20 이상
  • API 접근 권한이 있는 Kong Konnect 계정
  • MCP 기능이 있는 클라이언트 (예: Claude Desktop, Cursor 등...)
# 저장소 클론(Clone)
git clone https://github.com/Kong/mcp-konnect.git
cd mcp-konnect
...

이 저장소는 배포 모델의 일부로 build/ 아래에 커밋된 파일들을 포함하고 있습니다.

만약 src/ 내의 파일을 수정한다면, build/를 다시 생성하십시오.

변경 사항을 커밋하거나 게시하기 전에 수행하십시오.

MCP 서버를 설정하려면 다음 환경 변수 (environment variables)를 설정하십시오:

# 필수: Kong Konnect API 키
export KONNECT_ACCESS_TOKEN=kpat_api_key_here
# 선택 사항: 사용할 API 지역 (기본값은 US)
...

서버는 세 가지 카테고리로 분류된 도구 (tools)를 제공합니다:

사용자 정의 가능한 필터를 사용하여 Kong API 게이트웨이 (API Gateway) 요청을 쿼리하고 분석합니다.

입력값 (Inputs):
- timeRange: 데이터 검색을 위한 시간 범위 (15M, 1H, 6H, 12H, 24H, 7D)
- statusCodes: 특정 HTTP 상태 코드별 필터링
...

특정 소비자 (consumer)에 의해 수행된 API 요청을 분석합니다.

입력값 (Inputs):
- consumerId: 분석할 소비자의 ID
- timeRange: 데이터 검색을 위한 시간 범위
...

컨트롤 플레인 (control plane)과 연결된 모든 서비스를 나열합니다.

입력값 (Inputs):
- controlPlaneId: 컨트롤 플레인 ID
- size: 반환할 서비스 수
...

컨트롤 플레인 (control plane)과 연결된 모든 라우트 (routes)를 나열합니다.

입력값 (Inputs):
- controlPlaneId: 컨트롤 플레인 ID
- size: 반환할 라우트 수
...

컨트롤 플레인 (control plane)과 연결된 모든 소비자를 나열합니다.

입력값 (Inputs):
- controlPlaneId: 컨트롤 플레인 ID
- size: 반환할 소비자 수
...

컨트롤 플레인 (control plane)과 연결된 모든 플러그인 (plugins)을 나열합니다.

입력값 (Inputs):
- controlPlaneId: 컨트롤 플레인 ID
- size: 반환할 플러그인 수
...

조직 내의 모든 컨트롤 플레인 (control planes)을 나열합니다.

입력값 (Inputs):
- pageSize: 페이지당 컨트롤 플레인 수
- pageNumber: 가져올 페이지 번호
...

특정 컨트롤 플레인 (control plane)에 대한 상세 정보를 가져옵니다.

입력값 (Inputs):
- controlPlaneId: 가져올 컨트롤 플레인 ID

특정 그룹의 멤버인 모든 컨트롤 플레인 (control planes)을 나열합니다.

입력값 (Inputs):
- groupId: 컨트롤 플레인 그룹 ID
- pageSize: 페이지당 반환할 멤버 수
...

컨트롤 플레인 (control plane)이 어떤 그룹의 멤버인지 확인합니다.

입력값 (Inputs):
- controlPlaneId: 확인할 컨트롤 플레인 ID

참고: 이 설정은 과거 참조용으로 제공됩니다. 설정 문제에 대한 지원은 제공되지 않습니다.

Claude for Desktop에서 이 MCP 서버를 사용하려면:

Claude for Desktop 설치

Claude Desktop 설정 파일을 생성하거나 편집합니다:

Macos:
~/Library/Application Support/Claude/claude_desktop_config.json

Windows:
%APPDATA%\Claude\claude_desktop_config.json

Macos:

다음 설정을 추가합니다:

{
"mcpServers": {
"kong-konnect": {
...

Claude for Desktop 재시작

  • 이제 Claude가 사용할 수 있도록 Kong Konnect 도구들이 준비됩니다.

먼저, 모든 컨트롤 플레인 (control planes)을 나열합니다:

Please list all control planes in my Kong Konnect organization.

그 다음, 특정 컨트롤 플레인에 대한 서비스들을 나열합니다:

List all services for control plane [CONTROL_PLANE_ID].

특정 서비스에 대한 API 요청을 조회합니다:

Show me all API requests for service [SERVICE_NAME/ID] in the last hour that had 5xx status codes.

컨트롤 플레인의 컨슈머 (consumers)를 나열합니다:

List all consumers for control plane [CONTROL_PLANE_ID].

특정 컨슈머의 요청을 분석합니다:

Show me all requests made by consumer [CONSUMER_NAME/ID] in the last 24 hours.

일반적인 오류나 패턴을 확인합니다:

What are the most common errors experienced by this consumer?

이 저장소는 읽기 전용 (read-only)으로 아카이브될 예정입니다. 풀 리퀘스트 (Pull requests) 및 이슈 (issues)는 검토되거나 병합되지 않습니다.⚠️ 이 프로젝트는 더 이상 기여를 받지 않습니다.

과거 개발 기록:

npm test

은 TypeScript 빌드 및 저장소 테스트 스위트 (test suite)를 실행합니다.

build/

은 이 저장소에 커밋된 생성된 아티팩트 (artifact)이며, src/ 에 변경 사항이 생긴 후에는 npm run build로 다시 생성해야 합니다.

참고: 이 지원 중단 (deprecated)된 프로젝트에 대해서는 지원이 제공되지 않습니다. 아래 정보는 참조용으로만 보존됩니다.

연결 오류 (Connection Errors)

  • API 키가 유효하고 필요한 권한을 가지고 있는지 확인하세요
  • API 리전 (region)이 올바르게 지정되었는지 확인하세요
  • 네트워크가 Kong Konnect API에 연결할 수 있는지 확인하세요

인증 오류 (Authentication Errors)

  • Kong Konnect 포털에서 API 키를 재발급하세요
  • 환경 변수 (environment variables)가 올바르게 설정되었는지 확인하세요

데이터를 찾을 수 없음 (Data Not Found)

  • 요청에 사용된 ID가 올바른지 확인하세요
  • 지정된 컨트롤 플레인 (control plane)에 리소스가 존재하는지 확인하세요
  • 분석 쿼리 (analytics queries)를 위한 시간 범위가 유효한지 확인하세요

Kong에서 제작되었습니다. 원래 Stripe의 Agent Toolkit에서 영감을 받았습니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0