CLI de Bucket
Interfaz de línea de comandos para interactuar con los servicios de Bucket. La CLI permite administrar aplicaciones, funciones, autenticación y generar tipos de TypeScript para las funciones de Bucket. Con esta herramienta, puede optimizar el flujo de trabajo de marcado de funciones directamente desde su terminal.
Uso
Comience instalando la CLI localmente en su proyecto:
Luego, ejecute el new
comando desde el directorio raíz de su proyecto, inicializando la CLI, creando una función y generando los tipos a la vez:
Comandos individuales
En lugar de ejecutar new
, puede llamar a cada paso individualmente.
Configuración
La CLI crea un archivo bucket.config.json
en el directorio del proyecto al ejecutar bucket init
. Este archivo contiene toda la configuración necesaria para la integración de Bucket.
Estructura del archivo de configuración
Aquí hay una lista completa de las opciones de configuración disponibles en el archivo bucket.config.json
:
Opción | Descripción | Por defecto |
---|---|---|
$schema | El autocompletado de la latest configuración se puede reemplazar con una versión específica. | " https://unpkg.com/@bucketco/cli@latest/schema.json " |
baseUrl | URL base para servicios de Bucket. | " https://app.bucket.co " |
apiUrl | URL de API para servicios de Bucket (anula baseUrl para llamadas de API). | " https://app.bucket.co/api " |
appId | Su ID de aplicación Bucket. | Requerido |
typesOutput | Ruta(s) donde se generarán los tipos de TypeScript. Puede ser una cadena o un array de objetos con propiedades path y format . Formatos disponibles: react y node . | "gen/features.ts" con formato "react" |
Puede anular estas configuraciones mediante las opciones de la línea de comandos para comandos individuales.
Comandos
bucket init
Inicialice una nueva configuración de Bucket en su proyecto. Esto crea un archivo bucket.config.json
con su configuración y solicita la información necesaria que no se proporciona en las opciones.
Opciones:
--overwrite
: sobrescribe el archivo de configuración existente si existe.--app-id <id>
: Establece el ID de la aplicación.--key-format <format>
: establece el formato de clave para las funciones.
bucket new [featureName]
Comando todo en uno para empezar rápidamente. Este comando combina init
, creación de características y generación de tipos en un solo paso. Úsalo para empezar a usar Bucket más rápido.
Opciones:
--key
: Clave específica para la función.--app-id
: ID de la aplicación a utilizar.--key-format
: Formato para teclas de función (personalizada, serpiente, camello, etc.).--out
: Ruta para generar tipos TypeScript.--format
: Formato de los tipos generados (react o node).
Si prefiere tener más control sobre cada paso, puede utilizar los comandos individuales ( init
, features create
, features types
) en su lugar.
bucket login
Inicie sesión en su cuenta de Bucket. Esto autenticará su CLI para operaciones posteriores y almacenará las credenciales de forma segura.
bucket logout
Cierre la sesión de su cuenta de Bucket y elimine las credenciales almacenadas.
bucket features
Administre las funciones de su Bucket con los siguientes subcomandos.
bucket features create [featureName]
Crea una nueva función en tu aplicación Bucket. El comando te guía a través del proceso de creación de funciones con indicaciones interactivas si no se proporcionan opciones.
Opciones:
--key
: Clave específica para la función.--app-id
: ID de la aplicación a utilizar.--key-format
: Formato para teclas de función.
bucket features list
Enumera todas las funciones de la aplicación actual. Esto te ayuda a visualizar las funciones disponibles y sus configuraciones actuales.
Opciones:
--app-id
: ID de la aplicación a utilizar.
bucket features types
Genere tipos TypeScript para sus características. Esto garantiza la seguridad de tipos al usar las características de Bucket en sus aplicaciones TypeScript/JavaScript.
Opciones:
--app-id
: ID de la aplicación a utilizar.--out
: Ruta para generar tipos TypeScript.--format
: Formato de los tipos generados (react o node).
bucket companies
Comandos para la gestión de empresas.
bucket companies list
Enumere todas las empresas en su aplicación.
Opciones:
--filter
: Filtrar empresas por nombre o ID.--app-id
: ID de la aplicación a utilizar.
El comando genera una tabla con las siguientes columnas:
id
: ID de la empresa.name
: Nombre de la empresa (muestra "(sin nombre)" si no está configurado).users
: Número de usuarios en la empresa.lastSeen
: Fecha en la que la empresa estuvo activa por última vez.
bucket companies features access
Otorgue o revoque el acceso a funciones específicas para empresas, segmentos y usuarios. Si no se proporciona ninguna clave de función, se le pedirá que seleccione una de una lista.
Argumentos:
featureKey
: Clave de la función a la que se otorgará/revocará el acceso (opcional, selección interactiva si se omite).
Opciones:
--enable
: habilita la función para los objetivos especificados.--disable
: deshabilita la función para los objetivos especificados.--users
: ID de usuario objetivo. Se puede especificar varias veces.--companies
: ID de empresa objetivo. Se pueden especificar varias veces.--segments
: ID de segmento al que se dirige. Se pueden especificar varias veces.--app-id
: ID de la aplicación a utilizar.
Se debe especificar al menos un objetivo (empresas, segmentos o usuarios). También debe especificar --enable
o --disable
, pero no ambos.
Ejemplo:
bucket apps
Comandos para administrar aplicaciones Bucket.
Opciones globales
Estas opciones se pueden utilizar con cualquier comando:
--debug
: habilita el modo de depuración para salida detallada.--base-url <url>
: establece la URL base para la API de Bucket.--api-url <url>
: Establece la URL de la API directamente (anula la URL base).--help
: Muestra información de ayuda para un comando.
Desarrollo asistido por IA
Bucket ofrece potentes capacidades de desarrollo asistido por IA mediante reglas y el Protocolo de Contexto de Modelo (MCP). Estas funciones ayudan a tus herramientas de desarrollo de IA a comprender mejor tus características y a brindar una asistencia más precisa.
Reglas de los cubos (recomendadas)
El comando rules
te ayuda a configurar reglas específicas de IA para tu proyecto. Estas reglas permiten que las herramientas de IA comprendan mejor cómo trabajar con Bucket y los indicadores de características, y cómo deben usarse en tu código base.
Opciones:
--format
: Formato para agregar reglas en:cursor
: agrega reglas a.cursor/rules/bucket.mdc
para la integración de Cursor IDE.copilot
: agrega reglas a.github/copilot-instructions.md
para la integración de GitHub Copilot.
--yes
: omite las solicitudes de confirmación y sobrescribe los archivos existentes sin preguntar.
Este comando agregará reglas a tu proyecto que proporcionan a las herramientas de IA contexto sobre cómo configurar y usar las características de Bucket. Para el formato de copiloto, las reglas se agregarán a una sección específica del archivo, lo que te permitirá mantener otras instrucciones de copiloto junto con las reglas de Bucket.
Protocolo de contexto modelo
El Protocolo de Contexto de Modelo (MCP) es un protocolo abierto que proporciona una forma estandarizada de conectar modelos de IA a diferentes fuentes de datos y herramientas. En el contexto de Bucket, MCP permite al editor de código comprender los indicadores de características, sus estados y sus relaciones dentro del código base. Esto crea una conexión fluida entre el flujo de trabajo de gestión de características y las herramientas de desarrollo basadas en IA. El servidor MCP está alojado por Bucket, por lo que es muy fácil empezar.
**Nota: El comando CLI de Bucket mcp
se usaba anteriormente para un servidor _local . Sin embargo, en versiones recientes de la CLI de Bucket, el comando mcp
se ha reutilizado para facilitar la conexión al nuevo servidor MCP remoto.**_
Configuración de MCP
El comando mcp
te ayuda a configurar tu editor o cliente de IA para que se conecte con el servidor MCP remoto de Bucket. Esto permite que tus herramientas de IA comprendan tus indicadores de características y te brinden asistencia más contextual.
Opciones:
--app-id
: ID de la aplicación que se utilizará para la conexión MCP.--editor
: El editor/cliente a configurar:cursor
: IDE de cursorvscode
: Código de Visual Studioclaude
: Escritorio de Claudewindsurf
: Windsurf
--scope
: si desea configurar ajustes globales o locales para el proyecto.
El comando le guiará a través de:
- Seleccionar qué editor/cliente configurar.
- Elegir a qué aplicación de Bucket conectarse.
- Decidir entre configuración global o local del proyecto.
- Configurar el archivo de configuración apropiado para el editor elegido.
Nota: La configuración utiliza mcp-remote como capa de compatibilidad, lo que permite que el servidor MCP de Bucket alojado remotamente funcione con todos los editores/clientes compatibles con servidores MCP STDIO. Si su editor/cliente admite la transmisión HTTP con OAuth, puede conectarse directamente al servidor MCP de Bucket.
Desarrollo
Requisitos
- Node.js >=18.0.0
Licencia
Licencia MIT Copyright (c) 2025 Bucket ApS
This server cannot be installed
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.
Marque las funciones directamente desde el chat en su editor de código, incluidos VS Code, Cursor, Windsurf, Claude Code y cualquier IDE con soporte para MCP.
Related MCP Servers
- AsecurityAlicenseAqualityreact-mcp integrates with Claude Desktop, enabling the creation and modification of React apps based on user promptsLast updated -919JavaScriptMIT License
- AsecurityAlicenseAqualityA template for creating custom tools for Cursor IDE using Model Context Protocol (MCP), allowing developers to extend Cursor's functionality with their own server-based tools.Last updated -112PythonMIT License
- -securityAlicense-qualitySeekChat supports MCP tool execution, enabling AI to directly control your computer and perform various tasks. Easily automate file management, data analysis, code development, and more, turning AI into a truly intelligent assistant.Last updated -18JavaScriptApache 2.0
- -securityFlicense-qualityAn MCP server that allows AI assistants to programmatically manage Unleash feature flags through natural language, enabling operations like creating, updating, and retrieving feature flags across projects.Last updated -52TypeScript