AI-интеграция · MCP
Управляйте инфраструктурой через AI
Подключите вашего AI-ассистента (Claude Desktop, Cursor или любой MCP-совместимый клиент) напрямую к аккаунту blackbox.md. Спрашивайте о серверах, балансе и счетах и управляйте своими серверами — на естественном языке. Доступ ограничен персональным токеном, который вы можете отозвать в любой момент.
Подключение за 3 шага
Создайте токен доступа
Войдите в аккаунт и откройте «API-токены». Выберите разрешения (по умолчанию — только чтение), задайте имя и создайте токен. Он показывается один раз — скопируйте его сразу.
Добавьте подключение в AI-клиент
Откройте настройки Claude Desktop, Cursor или другого MCP-совместимого клиента и добавьте сервер BLACKBOX, указав адрес и токен в заголовке Authorization (см. пример ниже).
Перезапустите клиент и спросите
После перезапуска AI-ассистент увидит инструменты BLACKBOX. Просто спросите его о своих серверах или счетах — он вызовет нужный инструмент сам.
Пример конфигурации
Замените bbx_pat_... на созданный вами токен. Адрес подключения один для всех клиентов:
Адрес MCP-сервера
https://api.app.blackbox.md/mcp{
"mcpServers": {
"blackbox": {
"url": "https://api.app.blackbox.md/mcp",
"headers": {
"Authorization": "Bearer bbx_pat_..."
}
}
}
}Примеры запросов
«Покажи мои серверы BLACKBOX и их статус»
«Какой у меня баланс и какие счета не оплачены?»Доступные инструменты
Каждый инструмент требует соответствующего разрешения токена. Инструмент недоступен, если вы не выдали токену это разрешение.
| Инструмент | Что делает | Разрешение | Статус |
|---|---|---|---|
| Список серверов | Все ваши серверы с их статусом | servers:read | Доступно |
| Данные сервера | Статус, IP-адрес, состояние питания | servers:read | Доступно |
| Баланс | Текущий баланс кошелька | billing:read | Доступно |
| Операции | История пополнений и списаний | billing:read | Доступно |
| Заказы | Список ваших заказов | billing:read | Доступно |
| Счета | Список ваших счетов | billing:read | Доступно |
| Управление питанием | Перезагрузка / выключение / включение | servers:power | Доступно |
| Доступы к серверу | Просмотр и сброс пароля root | servers:credentials | Доступно |
| Заказ и оплата | Создание и оплата заказа из баланса | orders:write | Доступно |
Инструменты управления (питание, доступы, заказы) запускаются поэтапно. Действия, тратящие деньги или меняющие сервер, всегда требуют явного подтверждения в вашем AI-клиенте.
Ваши серверы
AI видит список серверов, их статус и IP-адреса — только те, что принадлежат вам.
Баланс и счета
Спросите о балансе кошелька, истории операций, заказах и неоплаченных счетах.
Доступ под контролем
Токен ограничен выбранными разрешениями и привязан только к вашему аккаунту. Отзыв — в один клик.
Стандарт MCP
Открытый протокол Model Context Protocol — работает с Claude Desktop, Cursor и другими клиентами.
Частые вопросы
Что такое MCP?
Model Context Protocol — открытый стандарт, позволяющий AI-ассистентам безопасно подключаться к внешним сервисам через набор «инструментов». BLACKBOX предоставляет такой MCP-сервер для вашего аккаунта.
Может ли AI потратить мои деньги?
По умолчанию токен даёт доступ только на чтение. Действия, тратящие деньги (оформление и оплата заказов), требуют отдельного разрешения orders:write И явного подтверждения в вашем AI-клиенте при каждом вызове. Не выдавайте это разрешение, если не хотите такой возможности.
Кто увидит мои данные?
Только тот AI-клиент и его провайдер, которому вы передали токен. Разрешение «Доступы к серверу» передаёт пароли серверов AI-клиенту — выдавайте его осознанно.
Как отозвать доступ?
Откройте «API-токены» в аккаунте и отзовите нужный токен. Он немедленно перестаёт работать. Вы можете иметь несколько токенов с разными разрешениями.
Какие клиенты поддерживаются?
Любой MCP-совместимый клиент: Claude Desktop, Cursor и другие. Подключение — по адресу сервера и токену в заголовке Authorization.
Создайте токен и подключитесь
Создание токена бесплатно и занимает минуту. Начните с доступа только на чтение и расширяйте разрешения по мере необходимости.