ConfigCat

ConfigCat MCP 서버

ConfigCat의 Model Context Protocol (MCP) 서버는 기능 플래그 및 구성 관리를 위해 ConfigCat 공개 관리 API에 대한 액세스를 제공합니다. 또한 코드 편집기가 기능 플래그를 이해하고, 프로젝트에 적절한 ConfigCat SDK를 통합하거나, 코드베이스에서 직접 새 기능 플래그를 생성할 수 있게 해줍니다.

기능

• 도구:
  • ConfigCat 공개 관리 API 작업을 위한 완전한 도구 세트. ConfigCat 내에서 기능 플래그, 구성, 환경 또는 제품과 같은 모든 엔터티를 생성, 읽기, 업데이트 및 삭제할 수 있습니다.
  • 프로젝트에서 원활한 기능 플래그 구현을 위한 포괄적인 SDK 문서 및 코드 예제를 제공합니다.

설정

다음 환경 변수를 사용하여 MCP 서버를 구성할 수 있습니다.

환경 변수	필수	기본값	설명
CONFIGCAT_API_USER	☑		ConfigCat 관리 API 기본 인증 사용자 이름.
CONFIGCAT_API_PASS	☑		ConfigCat 관리 API 기본 인증 비밀번호.
CONFIGCAT_BASE_URL		https://api.configcat.com	ConfigCat 관리 API 호스트.

아래 지침은 클라이언트를 MCP 서버에 연결하는 방법을 보여줍니다.

Cursor

1. Preferences -> Cursor Settings -> MCP & Integrations 열기
2. Add Custom MCP 클릭
3. ConfigCat MCP 서버에 대한 다음 서버 정의를 추가합니다:

{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

4. 설정을 저장합니다.

Visual Studio Code

1. 프로젝트 루트에 다음 내용으로 .vscode/mcp.json 파일을 생성합니다:

{
  "servers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

2. 설정 파일을 저장합니다. 이제 MCP 서버를 VS Code에서 사용할 수 있습니다.

Claude Desktop

1. 설정 → 개발자 열기
2. 구성 편집 클릭
3. claude_desktop_config.json 열기
4. ConfigCat MCP 서버에 대한 다음 서버 정의를 추가합니다:

{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

5. 저장하고 Claude를 다시 시작합니다.

사용 가능한 도구

멤버십 관리

조직

• list-organizations - 모든 조직 나열

멤버

• list-organization-members - 조직 멤버 나열
• list-pending-invitations - 보류 중인 초대 나열
• list-pending-invitations-org - 조직 보류 중인 초대 나열
• list-product-members - 제품 멤버 나열
• invite-member - 새 멤버 초대
• update-member-permissions - 멤버 권한 업데이트
• delete-organization-member - 조직 멤버 제거
• delete-product-member - 제품 멤버 제거
• delete-invitation - 초대 취소

권한 그룹

• list-permission-groups - 권한 그룹 나열
• create-permission-group - 새 권한 그룹 생성
• get-permission-group - 권한 그룹 세부 정보 가져오기
• update-permission-group - 권한 그룹 업데이트
• delete-permission-group - 권한 그룹 삭제

일반

제품

• list-products - 모든 제품 나열
• get-product - 특정 제품 세부 정보 가져오기
• update-product - 기존 제품 업데이트
• delete-product - 제품 삭제
• get-product-preferences - 제품 기본 설정 가져오기
• update-product-preferences - 제품 기본 설정 업데이트
• create-product - 새 제품 생성

구성

• list-configs - 제품의 구성 나열
• create-config - 새 구성 생성
• get-config - 특정 구성 세부 정보 가져오기
• update-config - 기존 구성 업데이트
• delete-config - 구성 삭제

환경

• list-environments - 제품의 환경 나열
• create-environment - 새 환경 생성
• get-environment - 특정 환경 세부 정보 가져오기
• update-environment - 기존 환경 업데이트
• delete-environment - 환경 삭제

세그먼트

• list-segments - 사용자 세그먼트 나열
• create-segment - 새 세그먼트 생성
• get-segment - 특정 세그먼트 세부 정보 가져오기
• update-segment - 기존 세그먼트 업데이트
• delete-segment - 세그먼트 삭제

SDK 키

• get-sdk-keys - 구성/환경에 대한 SDK 키 가져오기

웹훅

• list-webhooks - 웹훅 나열
• get-webhook - 웹훅 세부 정보 가져오기
• replace-webhook - 웹훅 구성 교체
• update-webhook - 기존 웹훅 업데이트
• delete-webhook - 웹훅 삭제
• get-webhook-signing-keys - 웹훅 서명 키 나열
• create-webhook - 새 웹훅 생성

통합

• list-integrations - 통합 나열
• create-integration - 새 통합 생성
• get-integration - 통합 세부 정보 가져오기
• update-integration - 기존 통합 업데이트
• delete-integration - 통합 삭제

코드 참조

• get-code-references - 코드 참조 가져오기

진단

감사 로그

• list-auditlogs - 제품 감사 로그 가져오기
• list-organization-auditlogs - 조직 감사 로그 가져오기

좀비(오래된) 플래그

• list-staleflags - 오래된 기능 플래그 보고서 가져오기

기능 플래그 메타데이터

기능 플래그 및 설정

• list-settings - 구성의 기능 플래그 나열
• create-setting - 새 기능 플래그 생성
• list-predefined-variations - 사전 정의된 변형 나열
• update-predefined-variations - 사전 정의된 변형 업데이트
• get-setting - 특정 기능 플래그 세부 정보 가져오기
• replace-setting - 기능 플래그 구성 교체
• update-setting - 기존 기능 플래그 업데이트
• delete-setting - 기능 플래그 삭제

태그

• list-tags - 제품의 태그 나열
• create-tag - 새 태그 생성
• list-settings-by-tag - 태그별 기능 플래그 가져오기
• get-tag - 특정 태그 세부 정보 가져오기
• update-tag - 기존 태그 업데이트
• delete-tag - 태그 삭제

기능 플래그 및 설정 값 (v1 및 v2 API)

• get-setting-value - 기능 플래그 값 가져오기
• update-setting-value - 기능 플래그 값 업데이트
• replace-setting-value - 기능 플래그 값 교체
• get-setting-values - 여러 설정 값 가져오기
• post-setting-values - 여러 설정 값 업데이트
• V2 변형: 위 도구의 *-v2 버전 (Config V2용)

변경 요청

• get-change-request - 특정 변경 요청의 세부 정보 반환
• update-change-request - 제목, 메모, 일정 등 변경 요청의 메타데이터 업데이트
• list-change-requests - 변경 요청 나열
• get-change-request-proposed-changes - 변경 요청에 포함된 설정에 대한 제안된 변경 사항 반환
• update-change-request-proposed-change - 변경 요청에 포함된 설정에 대한 제안된 변경 사항 업데이트
• add-change-request-comment - 변경 요청에 새 댓글 추가
• apply-change-request - 변경 요청 적용
• approve-change-request - 변경 요청에 승인 추가
• claim-change-request-ownership - 변경 요청 소유권 주장
• close-change-request - 적용하지 않고 변경 요청 닫기
• create-change-request - 지정된 구성 및 환경에 대한 새 변경 요청 생성
• remove-change-request-approval - 변경 요청에서 기존 승인 제거
• resolve-change-request-setting-conflicts - 동시에 게시된 변경으로 인한 충돌을 해결하기 위해 변경 요청에 포함된 설정의 제안된 변경 사항 업데이트
• update-change-request-comment - 기존 변경 요청 댓글 업데이트
• delete-change-request-comment - 변경 요청 댓글 삭제
• delete-change-request-proposed-change - 변경 요청에서 설정 제거

SDK 문서

• update-sdk-documentation - 프로젝트에서 원활한 기능 플래그 구현을 위한 포괄적인 SDK 문서 및 코드 예제 가져오기

API 속도 제한

ConfigCat 공개 API에는 속도 제한이 있습니다. 서버는 이러한 제한을 준수하며 제한을 초과하면 적절한 오류 메시지를 반환합니다.

보안 참고 사항

이 서버는 관리 작업 전용으로 설계되었습니다. 프로덕션 애플리케이션에서 기능 플래그 값을 평가하는 데 사용하지 마십시오. 대신 ConfigCat SDK 또는 ConfigCat Proxy를 사용하십시오.

도움이 필요하신가요?

https://configcat.com/support

기여

기여를 환영합니다. 자세한 내용은 기여 지침을 읽어주세요.

ConfigCat 소개

• ConfigCat MCP 서버 문서
• 문서
• 블로그