Skip to main content
Glama
deenesjakoruzh
s-b-e-n-s-o-n

portkey-admin-mcp

by s-b-e-n-s-o-n
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

Portkey 관리 MCP 서버

Portkey 관리 API를 위한 MCP 서버입니다. 모든 MCP 클라이언트에서 프롬프트, 구성, 분석, API 키 등을 관리하세요.

빠른 시작

적절한 범위(scope)가 설정된 Portkey API 키가 필요합니다. Portkey 대시보드의 API 키 섹션에서 발급받으세요.

Claude Code

claude mcp add -e PORTKEY_API_KEY=your_key portkey-admin -- npx -y portkey-admin-mcp

Cursor / Windsurf / VS Code

MCP 설정 파일(.cursor/mcp.json, .windsurf/mcp.json 또는 .vscode/mcp.json)에 추가하세요:

{
  "mcpServers": {
    "portkey-admin": {
      "command": "npx",
      "args": ["-y", "portkey-admin-mcp"],
      "env": {
        "PORTKEY_API_KEY": "your_api_key"
      }
    }
  }
}

직접 실행

PORTKEY_API_KEY=your_key npx -y portkey-admin-mcp
git clone https://github.com/s-b-e-n-s-o-n/portkey-admin-mcp.git
cd portkey-admin-mcp
npm install && npm run build

그런 다음 이 설정을 사용하세요:

{
  "mcpServers": {
    "portkey-admin": {
      "command": "node",
      "args": ["/path/to/portkey-admin-mcp/build/index.js"],
      "env": {
        "PORTKEY_API_KEY": "your_api_key"
      }
    }
  }
}

주요 기능

카테고리

도구

예시

프롬프트

14

프롬프트 생성, 버전 관리, 렌더링, 실행, 마이그레이션, 승격

프롬프트 파셜

7

버전 관리가 포함된 재사용 가능한 프롬프트 조각

프롬프트 라벨

5

프롬프트 버전 구성 (프로덕션, 스테이징, 개발)

구성

6

게이트웨이 라우팅, 캐싱, 재시도, 로드 밸런싱

API 키

5

범위가 지정된 API 키 생성 및 관리

가상 키

5

공급자 액세스 키 관리

컬렉션

5

앱 또는 프로젝트별 프롬프트 그룹화

공급자

5

AI 공급자 구성 관리

통합

10

공급자 통합, 모델, 워크스페이스 액세스

MCP 통합

10

외부 MCP 도구 통합

MCP 서버

10

MCP 서버 레지스트리 및 기능

가드레일

5

콘텐츠 안전 정책

사용량 제한

7

비용 및 토큰 소비 제한

속도 제한

5

요청 빈도 제어

분석

20

비용, 지연 시간, 오류, 토큰, 캐시, 피드백

로깅

8

로그 수집 및 내보내기

추적

3

피드백 및 추적 검색

사용자 및 워크스페이스

20

사용자 관리, 초대, 워크스페이스 멤버

감사

1

감사 로그 액세스

총 151개의 도구. 전체 목록과 설명은 ENDPOINTS.md를 참조하세요.

API 키 범위(Scopes)

도구마다 필요한 API 키 범위가 다릅니다. 대부분의 작업에는 광범위한 권한을 가진 워크스페이스 범위의 서비스 키가 적합합니다. 일부 기능은 추가 액세스 권한이 필요합니다:

기능

필수 사항

분석, 로그 내보내기, 감사 로그

엔터프라이즈 플랜 + analytics.view 범위

사용자 관리, 초대

조직 수준 API 키

통합 모델/워크스페이스

조직 수준 API 키

프롬프트 완성

completions.write 범위 + 결제 메타데이터

도구가 Portkey 오류 AB03과 함께 403을 반환한다면, 엔드포인트 문제가 아니라 범위가 누락된 것입니다.

HTTP 서버 (실험적)

상태: HTTP 전송은 작동하지만 호스팅 배포는 프로덕션 환경에서 완전히 검증되지 않았습니다. 안정적인 운영을 위해 stdio(npx)를 사용하세요.

이 서버는 원격 액세스를 위한 스트리밍 가능한 HTTP를 지원합니다:

PORTKEY_API_KEY=your_key \
MCP_HOST=127.0.0.1 \
MCP_PORT=3000 \
MCP_PUBLIC_BASE_URL=https://mcp.example.com \
MCP_AUTH_MODE=bearer \
MCP_AUTH_TOKEN=your_secret \
node build/server.js

또는 npx를 통해 실행하세요 (portkey-admin-mcp 패키지에 HTTP 바이너리가 포함되어 있습니다):

PORTKEY_API_KEY=your_key MCP_AUTH_MODE=bearer MCP_AUTH_TOKEN=your_secret \
  npx -y -p portkey-admin-mcp portkey-admin-mcp-http

로컬 전용 HTTP 사용 시 MCP_HOST를 기본값인 127.0.0.1로 유지하세요. Docker나 다른 인터페이스의 리버스 프록시와 같이 외부에서 연결을 수락해야 하는 경우에만 MCP_HOST=0.0.0.0으로 설정하세요.

구성

변수

기본값

설명

PORTKEY_API_KEY

(필수)

Portkey API 키

MCP_HOST

127.0.0.1

바인딩 주소

MCP_PORT

3000

포트

MCP_PUBLIC_BASE_URL

—

/auth/info 및 상태 페이지에서 광고할 공개 절대 기본 URL; 호스팅 배포 시 권장

MCP_AUTH_MODE

none

none, bearer 또는 clerk (none은 명시적으로 재정의되지 않는 한 HTTP에서 차단됨)

MCP_AUTH_TOKEN

—

Bearer 인증을 위한 비밀 토큰

MCP_ALLOW_UNAUTHENTICATED_HTTP

—

의도적인 로컬 비인증 HTTP 디버깅을 위해서만 true로 설정

MCP_SESSION_MODE

stateful

stateful 또는 stateless

MCP_MAX_SESSIONS

100

새 초기화 요청이 거부되기 전의 최대 동시 상태 유지 MCP 세션 수

MCP_EVENT_STORE

off

off, memory 또는 redis

MCP_REDIS_URL

—

공유 이벤트 저장소를 위한 Redis URL

MCP_TLS_KEY_PATH

—

네이티브 HTTPS를 위한 TLS 키

MCP_TLS_CERT_PATH

—

네이티브 HTTPS를 위한 TLS 인증서

ALLOWED_ORIGINS

—

CORS 허용 목록

MCP_TRUST_PROXY

false

프록시 헤더 신뢰 여부 (리버스 프록시용)

RATE_LIMIT_MAX_BUCKETS

10000

새 클라이언트가 오버플로 버킷을 공유하기 전의 최대 메모리 내 속도 제한 버킷 수

실험적인 Vercel 지원이 포함되어 있습니다. 설정 지침은 docs/VERCEL_DEPLOYMENT.md를 참조하세요.

주요 사항:

  • Redis 이벤트 저장소를 사용하는 상태 비저장(stateless) 모드 사용

  • Clerk 또는 Bearer 인증 필요

  • MCP_TLS_*는 설정하지 마세요 (Vercel이 HTTPS를 종료함)

  • 광고된 MCP 엔드포인트가 요청 헤더에 의존하지 않도록 MCP_PUBLIC_BASE_URL을 배포 URL로 설정하세요

  • Vercel은 WebSocket을 지원하지 않으므로 스트리밍 가능한 HTTP/SSE만 사용 가능합니다

docker build -t portkey-admin-mcp .
docker run \
  -e PORTKEY_API_KEY=your_key \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=3000 \
  -e MCP_AUTH_MODE=bearer \
  -e MCP_AUTH_TOKEN=your_secret \
  -p 3000:3000 \
  portkey-admin-mcp

상태 확인 엔드포인트

경로

목적

GET /health

서버 활성 상태

GET /ready

준비 상태 (선택적 Portkey 연결 확인 포함)

GET /auth/info

인증 구성 메타데이터

개발

npm run dev           # stdio with hot reload
npm run dev:http      # HTTP with hot reload
npm test              # unit + contract tests
npm run test:e2e      # MCP protocol tests
npm run test:http     # HTTP endpoint smoke test
npm run ci            # full pipeline (lint + typecheck + test + build + e2e + verify)

npm run dev:http는 이제 기본적으로 MCP_AUTH_MODE=bearer 또는 MCP_AUTH_MODE=clerk를 요구합니다. 의도적인 로컬 비인증 테스트를 위해서는 MCP_ALLOW_UNAUTHENTICATED_HTTP=true로 설정하세요.

MIT 라이선스 · r-huijts/portkey-admin-mcp-server에서 영감을 받음

↑ 맨 위로

Install Server
A
security – no known vulnerabilities
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Tools

View all tools

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/s-b-e-n-s-o-n/portkey-admin-mcp'

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