Bucket Feature Flags MCP Server

버킷 CLI

버킷 서비스와 상호 작용하기 위한 명령줄 인터페이스입니다. CLI를 사용하면 앱, 기능, 인증을 관리하고 버킷 기능에 대한 TypeScript 유형을 생성할 수 있습니다. 이 도구를 사용하면 터미널에서 바로 기능 플래깅 워크플로를 간소화할 수 있습니다.

용법

프로젝트에 로컬로 CLI를 설치하여 시작하세요.

지엑스피1

그런 다음 프로젝트의 루트 디렉토리에서 new 명령을 실행하고, CLI를 초기화하고, 기능을 만들고, 유형을 모두 한 번에 생성합니다.

개별 명령

new 실행하는 대신 각 단계를 개별적으로 호출할 수 있습니다.

구성

bucket init 실행하면 CLI가 프로젝트 디렉터리에 bucket.config.json 파일을 생성합니다. 이 파일에는 Bucket 통합에 필요한 모든 설정이 포함되어 있습니다.

구성 파일 구조

bucket.config.json 파일에서 사용할 수 있는 구성 옵션의 포괄적인 목록은 다음과 같습니다.

개별 명령에 대한 명령줄 옵션을 사용하여 이러한 설정을 재정의할 수 있습니다.

명령

bucket init

프로젝트에서 새 버킷 구성을 초기화하세요. 이렇게 하면 설정 내용이 포함된 bucket.config.json 파일이 생성되고, 옵션을 통해 제공되지 않은 필수 정보를 입력하라는 메시지가 표시됩니다.

옵션:

• --overwrite : 기존 구성 파일이 있으면 덮어씁니다.
• --app-id <id> : 애플리케이션 ID를 설정합니다.
• --key-format <format> : 기능에 대한 키 형식을 설정합니다.

bucket new [featureName]

빠르게 시작할 수 있는 올인원 명령어입니다. 이 명령어는 init , 기능 생성, 유형 생성을 한 단계로 통합합니다. Bucket을 가장 빠르게 시작하고 실행하려면 이 명령어를 사용하세요.

옵션:

• --key : 해당 기능에 대한 특정 키입니다.
• --app-id : 사용할 앱 ID.
• --key-format : 기능 키에 대한 형식(사용자 정의, 스네이크, 카멜 등).
• --out : TypeScript 유형을 생성하는 경로입니다.
• --format : 생성된 유형(react 또는 node)의 형식입니다.

각 단계를 더 많이 제어하고 싶다면 개별 명령( init , features create , features types )을 사용할 수 있습니다.

bucket login

버킷 계정에 로그인하세요. 그러면 이후 작업에 필요한 CLI가 인증되고 자격 증명이 안전하게 저장됩니다.

bucket logout

버킷 계정에서 로그아웃하면 저장된 자격 증명이 제거됩니다.

bucket features

다음 하위 명령을 사용하여 버킷 기능을 관리하세요.

bucket features create [featureName]

버킷 앱에서 새 기능을 만드세요. 옵션이 제공되지 않으면 이 명령이 대화형 프롬프트를 통해 기능 생성 과정을 안내합니다.

옵션:

• --key : 해당 기능에 대한 특정 키입니다.
• --app-id : 사용할 앱 ID.
• --key-format : 기능 키의 형식입니다.

bucket features list

현재 앱의 모든 기능을 나열합니다. 이를 통해 사용 가능한 기능과 각 기능의 현재 구성을 시각화하는 데 도움이 됩니다.

옵션:

• --app-id : 사용할 앱 ID.

bucket features types

기능에 대한 TypeScript 타입을 생성하세요. 이렇게 하면 TypeScript/JavaScript 애플리케이션에서 버킷 기능을 사용할 때 타입 안전성이 보장됩니다.

옵션:

• --app-id : 사용할 앱 ID.
• --out : TypeScript 유형을 생성하는 경로입니다.
• --format : 생성된 유형(react 또는 node)의 형식입니다.

bucket companies

회사 관리를 위한 명령어.

bucket companies list

앱에 있는 모든 회사를 나열하세요.

옵션:

• --filter : 이름이나 ID로 회사를 필터링합니다.
• --app-id : 사용할 앱 ID.

이 명령은 다음 열이 포함된 표를 출력합니다.

• id : 회사 ID.
• name : 회사 이름(설정하지 않으면 "(unnamed)"가 표시됨).
• users : 회사의 사용자 수.
• lastSeen : 회사가 마지막으로 활동한 날짜입니다.

bucket companies features access

회사, 세그먼트 및 사용자에게 특정 기능에 대한 액세스 권한을 부여하거나 취소합니다. 기능 키가 제공되지 않으면 목록에서 하나를 선택하라는 메시지가 표시됩니다.

인수:

• featureKey : 접근 권한을 부여/취소할 기능의 키(선택 사항, 생략 시 대화형 선택).

옵션:

• --enable : 지정된 대상에 대해 기능을 활성화합니다.
• --disable : 지정된 대상에 대한 기능을 비활성화합니다.
• --users : 대상 사용자 ID입니다. 여러 번 지정할 수 있습니다.
• --companies : 타겟팅할 회사 ID입니다. 여러 번 지정할 수 있습니다.
• --segments : 대상 세그먼트 ID입니다. 여러 번 지정할 수 있습니다.
• --app-id : 사용할 앱 ID.

대상(회사, 세그먼트 또는 사용자)을 하나 이상 지정해야 합니다. 또한 --enable 또는 --disable 중 하나만 지정해야 하며, 둘 다 지정할 수는 없습니다.

예:

bucket apps

버킷 앱을 관리하기 위한 명령입니다.

글로벌 옵션

다음 옵션은 모든 명령과 함께 사용할 수 있습니다.

• --debug : 자세한 출력을 위해 디버그 모드를 활성화합니다.
• --base-url <url> : Bucket API의 기본 URL을 설정합니다.
• --api-url <url> : API URL을 직접 설정합니다(기본 URL을 재정의합니다).
• --help : 명령에 대한 도움말 정보를 표시합니다.

AI 지원 개발

버킷은 규칙 및 모델 컨텍스트 프로토콜(MCP)을 통해 강력한 AI 지원 개발 기능을 제공합니다. 이러한 기능은 AI 개발 도구가 기능을 더 잘 이해하고 더욱 정확한 지원을 제공할 수 있도록 도와줍니다.

버킷 규칙(권장)

rules 명령어를 사용하면 프로젝트에 맞는 AI 전용 규칙을 설정할 수 있습니다. 이러한 규칙을 통해 AI 도구는 버킷 및 기능 플래그를 사용하는 방법과 코드베이스에서 이를 사용하는 방법을 더 잘 이해할 수 있습니다.

옵션:

• --format : 규칙을 추가할 형식:
  • cursor : Cursor IDE 통합을 위해 .cursor/rules/bucket.mdc 에 규칙을 추가합니다.
  • copilot : GitHub Copilot 통합을 위해 .github/copilot-instructions.md 에 규칙을 추가합니다.
• --yes : 확인 메시지를 건너뛰고 묻지 않고 기존 파일을 덮어씁니다.

이 명령은 AI 도구에 버킷 기능 플래그를 설정하고 사용하는 방법에 대한 컨텍스트를 제공하는 규칙을 프로젝트에 추가합니다. 부조종사 형식의 경우, 규칙은 파일의 전용 섹션에 추가되어 버킷 규칙과 함께 다른 부조종사 지침을 관리할 수 있습니다.

모델 컨텍스트 프로토콜

모델 컨텍스트 프로토콜(MCP)은 AI 모델을 다양한 데이터 소스 및 도구에 연결하는 표준화된 방식을 제공하는 개방형 프로토콜입니다. 버킷 컨텍스트에서 MCP는 코드 편집기가 피처 플래그, 상태 및 코드베이스 내 관계를 이해할 수 있도록 지원합니다. 이를 통해 피처 관리 워크플로와 AI 기반 개발 도구 간에 원활한 연결이 구축됩니다. MCP 서버는 버킷에 호스팅되므로 시작하기가 매우 쉽습니다.

**참고: Bucket mcp CLI 명령은 이전에는 로컬 서버에 사용되었습니다 . ���지만 최신 버전의 Bucket CLI에서는 mcp 명령이 새로운 원격 MCP 서버에 연결하는 데 도움이 되도록 용도가 변경되었습니다.**_

MCP 설정

mcp 명령어는 편집기 또는 AI 클라이언트가 Bucket의 원격 MCP 서버에 연결되도록 구성하는 데 도움이 됩니다. 이를 통해 AI 도구가 기능 플래그를 이해하고 상황에 맞는 지원을 제공할 수 있습니다.

옵션:

• --app-id : MCP 연결에 사용할 앱 ID입니다.
• --editor : 구성할 편집기/클라이언트:
  • cursor : 커서 IDE
  • vscode : 비주얼 스튜디오 코드
  • claude : 클로드 데스크탑
  • windsurf : 윈드서핑
• --scope : 프로젝트에 대한 설정을 전역적으로 구성할지 아니면 로컬로 구성할지 여부입니다.

이 명령을 사용하면 다음 단계를 안내받을 수 있습니다.

1. 구성할 편집기/클라이언트를 선택합니다.
2. 연결할 Bucket 앱을 선택합니다.
3. 글로벌 구성과 프로젝트 로컬 구성 중 하나를 결정합니다.
4. 선택한 편집기에 적합한 구성 파일을 설정합니다.

참고: 이 설정은 mcp-remote를 호환성 계층으로 사용하여 원격 호스팅된 Bucket MCP 서버가 MCP STDIO 서버를 지원하는 모든 편집기/클라이언트와 작동할 수 있도록 합니다. 편집기/클라이언트가 OAuth를 사용한 HTTP 스트리밍을 지원하는 경우 Bucket MCP 서버에 직접 연결할 수 있습니다.

개발

요구 사항

• 노드.js >=18.0.0

특허

MIT 라이선스 저작권 (c) 2025 Bucket ApS