CLI-интерфейс ведра
Интерфейс командной строки для взаимодействия со службами Bucket. CLI позволяет управлять приложениями, функциями, аутентификацией и генерировать типы TypeScript для функций Bucket. С помощью этого инструмента вы можете оптимизировать рабочий процесс пометки функций прямо из терминала.
Использование
Начните с локальной установки CLI в вашем проекте:
Затем запустите new команду из корневого каталога вашего проекта, инициализируйте CLI, создайте функцию и сгенерируйте типы одновременно:
Индивидуальные команды
Вместо того, чтобы запускать new вы можете вызывать каждый шаг по отдельности.
Конфигурация
CLI создает файл bucket.config.json в каталоге вашего проекта при запуске bucket init . Этот файл содержит все необходимые настройки для интеграции Bucket.
Структура файла конфигурации
Вот полный список параметров конфигурации, доступных в файле bucket.config.json :
Вариант | Описание | По умолчанию |
| Автодополнение для конфигурации.
можно заменить на конкретную версию. | " https://unpkg.com/@bucketco/cli@latest/schema.json " |
| Базовый URL для сервисов Bucket. | " " |
| URL-адрес API для служб Bucket (переопределяет baseUrl для вызовов API). | " " |
| Ваш идентификатор приложения Bucket. | Необходимый |
| Путь(и), где будут сгенерированы типы TypeScript. Может быть строкой или массивом объектов со свойствами
и
. Доступные форматы:
и
. | "gen/features.ts" в формате "react" |
Вы можете переопределить эти настройки, используя параметры командной строки для отдельных команд.
Команды
bucket init
Инициализируйте новую конфигурацию Bucket в вашем проекте. Это создаст файл bucket.config.json с вашими настройками и запросит любую необходимую информацию, не предоставленную через параметры.
Параметры:
--overwrite: Перезаписать существующий файл конфигурации, если он существует.--app-id <id>: Установить идентификатор приложения.--key-format <format>: Установить формат ключа для функций.
bucket new [featureName]
Команда «все в одном» для быстрого начала работы. Эта команда объединяет init , создание функций и генерацию типов в одном шаге. Используйте ее для самого быстрого способа начать работу с Bucket.
Параметры:
--key: Конкретный ключ для функции.--app-id: Идентификатор приложения для использования.--key-format: Формат для функциональных клавиш (пользовательский, змея, верблюд и т. д.).--out: Путь для генерации типов TypeScript.--format: Формат сгенерированных типов (react или node).
Если вы предпочитаете больший контроль над каждым шагом, вы можете использовать отдельные команды ( init , features create , features types ).
bucket login
Войдите в свою учетную запись Bucket. Это позволит аутентифицировать ваш CLI для последующих операций и безопасно сохранить учетные данные.
bucket logout
Выйдите из своей учетной записи Bucket, удалив сохраненные учетные данные.
bucket features
Управляйте функциями Bucket с помощью следующих подкоманд.
bucket features create [featureName]
Создайте новую функцию в приложении Bucket. Команда проведет вас через процесс создания функции с интерактивными подсказками, если параметры не предоставлены.
Параметры:
--key: Конкретный ключ для функции.--app-id: Идентификатор приложения для использования.--key-format: Формат для функциональных клавиш.
bucket features list
Перечислите все функции текущего приложения. Это поможет вам визуализировать доступные функции и их текущие конфигурации.
Параметры:
--app-id: Идентификатор приложения для использования.
bucket features types
Генерируйте типы TypeScript для своих функций. Это обеспечивает безопасность типов при использовании функций Bucket в ваших приложениях TypeScript/JavaScript.
Параметры:
--app-id: Идентификатор приложения для использования.--out: Путь для генерации типов TypeScript.--format: Формат сгенерированных типов (react или node).
bucket companies
Команды для управления компаниями.
bucket companies list
Перечислите все компании в вашем приложении.
Параметры:
--filter: Фильтрация компаний по названию или идентификатору.--app-id: Идентификатор приложения для использования.
Команда выводит таблицу со следующими столбцами:
id: идентификатор компании.name: Название компании (если не указано, отображается «(без названия)»).users: Количество пользователей в компании.lastSeen: дата последней активности компании.
bucket companies features access
Предоставьте или отмените доступ к определенным функциям для компаний, сегментов и пользователей. Если ключ функции не указан, вам будет предложено выбрать его из списка.
Аргументы:
featureKey: ключ функции, к которой необходимо предоставить/отозвать доступ (необязательно, интерактивный выбор, если не указан).
Параметры:
--enable: включить функцию для указанных целей.--disable: Отключить функцию для указанных целей.--users: Идентификаторы пользователей для цели. Можно указать несколько раз.--companies: ID компаний для нацеливания. Можно указать несколько раз.--segments: Идентификаторы сегментов для нацеливания. Можно указывать несколько раз.--app-id: Идентификатор приложения для использования.
Необходимо указать хотя бы одну цель (компании, сегменты или пользователи). Также необходимо указать либо --enable , либо --disable , но не оба.
Пример:
bucket apps
Команды для управления приложениями Bucket.
Глобальные возможности
Эти параметры можно использовать с любой командой:
--debug: включить режим отладки для подробного вывода.--base-url <url>: Установить базовый URL для API Bucket.--api-url <url>: задать URL-адрес API напрямую (переопределяет базовый URL-адрес).--help: Отображение справочной информации по команде.
Разработка с использованием ИИ
Bucket предоставляет мощные возможности разработки с помощью ИИ через правила и протокол контекста модели (MCP). Эти функции помогают вашим инструментам разработки ИИ лучше понимать ваши функции и предоставлять более точную помощь.
Правила корзины (рекомендуется)
Команда rules помогает вам настроить специфические правила AI для вашего проекта. Эти правила позволяют инструментам AI лучше понимать, как работать с флагами Bucket и feature и как их следует использовать в вашей кодовой базе.
Параметры:
--format: Формат для добавления правил:cursor: добавляет правила в.cursor/rules/bucket.mdcдля интеграции Cursor IDE.copilot: добавляет правила в.github/copilot-instructions.mdдля интеграции GitHub Copilot.
--yes: Пропустить запросы на подтверждение и перезаписать существующие файлы без запроса.
Эта команда добавит правила в ваш проект, которые предоставляют инструментам ИИ контекст о том, как настраивать и использовать флаги функций Bucket. Для формата copilot правила будут добавлены в специальный раздел в файле, что позволит вам поддерживать другие инструкции copilot наряду с правилами Bucket.
Модель контекстного протокола
Model Context Protocol (MCP) — это открытый протокол, который обеспечивает стандартизированный способ подключения моделей ИИ к различным источникам данных и инструментам. В контексте Bucket MCP позволяет вашему редактору кода понимать ваши флаги функций, их состояния и их связи в вашей кодовой базе. Это создает бесшовный мост между вашим рабочим процессом управления функциями и инструментами разработки на основе ИИ. Сервер MCP размещен на Bucket, поэтому начать работу очень просто.
**Примечание: команда Bucket сервера. Однако в последних версиях Bucket CLI команда mcp была перепрофилирована, чтобы помочь вам подключиться к новому удаленному серверу MCP.**_
Настройка МКП
Команда mcp помогает вам настроить редактор или клиент AI для подключения к удаленному серверу MCP Bucket. Это позволяет вашим инструментам AI понимать ваши флаги функций и предоставлять более контекстную помощь.
Параметры:
--app-id: идентификатор приложения, используемый для подключения MCP.--editor: Редактор/клиент для настройки:cursor: Курсор IDEvscode: Код Visual Studioclaude: Рабочий стол Клодаwindsurf: виндсерфинг
--scope: следует ли настраивать параметры глобально или локально для проекта.
Команда проведет вас через:
Выбор редактора/клиента для настройки.
Выбор приложения Bucket для подключения.
Выбор между глобальной или локальной конфигурацией проекта.
Настройка соответствующего файла конфигурации для выбранного вами редактора.
Примечание: настройка использует
Разработка
Требования
Node.js >=18.0.0
Лицензия
Лицензия MIT Авторские права (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.
Отмечайте функции прямо из чата в редакторе кода, включая VS Code, Cursor, Windsurf, Claude Code — любую IDE с поддержкой MCP.
Related MCP Servers
- -security-license-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 -56Apache 2.0
ZeroPath MCP Serverofficial
-security-license-qualityAllows developers to query security findings (SAST issues, secrets, patches) using natural language within AI-assisted tools like Claude Desktop, Cursor, and other MCP-compatible environments.Last updated -3- -security-license-qualitySo I tried out this cool tool I saw in a LinkedIn post https://openapitools.com All you need is your API schema (OpenAPI/Swagger), and it automatically generates an MCP schema for you. You can then drop it straight into Claude Desktop (or Cursor, LangChain, etc.) and instantly start chatting withLast updated -1
- -security-license-qualityA VSCode extension that enables AI agents to programmatically control VSCode's debugging features through the Model Context Protocol (MCP).Last updated -