remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Provides integration with Node.js applications, allowing feature flag management and TypeScript type generation for Node.js projects
Provides CLI commands that can be executed via npm, supporting installation and execution of Bucket features
Offers feature flag management specifically tailored for React applications, including TypeScript type generation with React-specific formats
버킷 CLI
버킷 서비스와 상호 작용하기 위한 명령줄 인터페이스입니다. CLI를 사용하면 앱, 기능, 인증을 관리하고 버킷 기능에 대한 TypeScript 유형을 생성할 수 있습니다. 이 도구를 사용하면 터미널에서 바로 기능 플래깅 워크플로를 간소화할 수 있습니다.
용법
프로젝트에 로컬로 CLI를 설치하여 시작하세요.
지엑스피1
그런 다음 프로젝트의 루트 디렉토리에서 new 명령을 실행하고, CLI를 초기화하고, 기능을 만들고, 유형을 모두 한 번에 생성합니다.
개별 명령
new 실행하는 대신 각 단계를 개별적으로 호출할 수 있습니다.
구성
bucket init 실행하면 CLI가 프로젝트 디렉터리에 bucket.config.json 파일을 생성합니다. 이 파일에는 Bucket 통합에 필요한 모든 설정이 포함되어 있습니다.
구성 파일 구조
bucket.config.json 파일에서 사용할 수 있는 구성 옵션의 포괄적인 목록은 다음과 같습니다.
| 옵션 | 설명 | 기본 |
|---|---|---|
$schema | config.latest에 대한 자동 latest 특정 버전으로 바꿀 수 있습니다. | " https://unpkg.com/@bucketco/cli@latest/schema.json " |
baseUrl | 버킷 서비스의 기본 URL입니다. | " https://app.bucket.co " |
apiUrl | 버킷 서비스에 대한 API URL(API 호출에 대한 baseUrl보다 우선함). | " https://app.bucket.co/api " |
appId | 버킷 애플리케이션 ID입니다. | 필수의 |
typesOutput | TypeScript 유형이 생성될 경로입니다. path 및 format 속성을 가진 문자열 또는 객체 배열일 수 있습니다. 사용 가능한 형식은 react 및 node . | "react" 형식의 "gen/features.ts" |
개별 명령에 대한 명령줄 옵션을 사용하여 이러한 설정을 재정의할 수 있습니다.
명령
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는 아직 개발 초기 단계이며 변경 사항이 빈번하게 발생합니다. 문제가 있는 경우 모델 컨텍스트 프로토콜 웹사이트를 확인하고 여기에서 문제 티켓을 제출해 주세요.
MCP 설정
MCP 서버는 현재 사용자 컴퓨터에서 로컬로 실행됩니다. MCP 서버를 시작하려면 버킷이 초기화된 프로젝트 디렉터리에서 CLI 명령을 실행하세요.
옵션:
--port: SSE 서버를 실행할 포트(기본값은 8050, "자동"은 무작위 포트)--app-id: 사용할 앱 ID.
이렇게 하면 기본적으로 http://localhost:8050/sse 에 SSE 서버가 시작되며, 원하는 클라이언트를 사용하여 연결할 수 있습니다. 아래는 Cursor IDE 와 Claude Desktop 에서 작동하는 예시입니다.
서버 측 이벤트(SSE)
STDIO 프록시
일부 클라이언트는 SSE를 지원하지 않고 대신 STDIO 프록시를 통해 MCP 서버와 인터페이스할 수 있습니다.
커서 IDE
Cursor IDE 에서 MCP 기능을 활성화하려면:
- 커서 IDE를 엽니다.
Settings > MCP로 이동합니다.Add new global MCP server클릭하고SSE구성을 붙여넣습니다.- 저장하고 커서로 돌아갑니다.
클로드 데스크탑
Claude Desktop 에서 MCP 기능을 활성화하려면:
- 클로드 데스크톱을 엽니다.
Settings > Developer로 이동하세요.Edit config클릭하고STDIO구성을 붙여넣습니다.- Claude Desktop을 저장하고 다시 시작하세요.
개발
요구 사항
- 노드.js >=18.0.0
특허
MIT 라이선스 저작권 (c) 2025 Bucket ApS
This server cannot be installed
VS Code, Cursor, Windsurf, Claude Code 등 MCP를 지원하는 모든 IDE를 포함하여 코드 편집기의 채팅에서 직접 플래그 기능을 지정할 수 있습니다.