Подключение в приложении Claude (пользовательский коннектор)

В приложении Claude (claude.ai и Claude Desktop) MCP-сервер BLACKBOX добавляется как пользовательский коннектор: в Claude откройте «Customize» → «Connectors» → «Add custom connector» и укажите адрес https://api.app.blackbox.md/mcp. API-токен создаётся на blackbox.md в разделе «Личный кабинет» → «API-токены» (blackbox.md/ru/account/api-tokens) и передаётся в заголовке x-api-key. В этом заголовке токен указывается без префикса Bearer, а обычный заголовок Authorization в некоторых версиях диалога зарезервирован под OAuth.

Доступно: владельцу аккаунта blackbox.md, который создал API-токен. В Claude — на тарифах Free, Pro, Max, Team и Enterprise, если в диалоге «Add custom connector» есть раздел «Request headers». На тарифе Free можно добавить только один пользовательский коннектор.

Примечание Интерфейс Claude со временем меняется. Названия ниже приведены на английском, как в Claude, и соответствуют документации Anthropic на 9 октября 2026. Если на экране они другие, ориентируйтесь на то, что видите: например, в старых версиях меню называлось «Settings» → «Connectors».

Что подготовить

Вам понадобится API-токен. На blackbox.md откройте «Личный кабинет» → «API-токены», введите название в поле «Название токена», отметьте разрешения и нажмите «Создать токен». Сразу скопируйте токен — страница предупреждает: «Скопируйте токен сейчас — он не будет показан снова.» Для начала хватит разрешений только на чтение; остальные можно добавить позже, создав новый токен. Подробнее: API-токены: создание, копирование и отзыв и Разрешения токенов (scopes).

Как добавить коннектор (тарифы Free, Pro и Max)

1. Откройте claude.ai или Claude Desktop и перейдите в «Customize» → «Connectors».
2. Нажмите «Add custom connector». В некоторых версиях сначала нажмите «+ Add», затем «Add custom connector».
3. Введите название, например BLACKBOX.
4. В поле URL укажите https://api.app.blackbox.md/mcp. Если в диалоге два шага, затем нажмите «Continue».
5. OAuth Client ID и Client Secret не заполняйте (в некоторых версиях они в разделе «Advanced settings»). Если диалог просит выбрать «Authentication», выберите «No sign-in».
6. Откройте «Request headers» и выберите в списке имя x-api-key.
7. Вставьте токен в значение: только bbx_pat_…, без Bearer, без пробелов и переносов строки.
8. Включите «Required».
9. Нажмите «Add». Если рядом с коннектором появилась кнопка «Connect», нажмите её.

Коннектор появится в списке «Connectors». Claude сохраняет значение заголовка и больше его не показывает.

Тарифы Team и Enterprise

Коннектор добавляет владелец организации Claude (роль «Owner» или «Primary Owner»): «Organization settings» → «Connectors» → «Add» → «Custom» (тип «Web», если спрашивает) с теми же значениями. Участники находят его в «Customize» → «Connectors» с меткой «Custom» и нажимают «Connect».

Безопасность Заголовок из «Request headers» общий для всей организации Claude. Все участники, которые подключатся, работают с одним и тем же токеном, то есть в вашем аккаунте blackbox.md и со всеми разрешениями этого токена. На тарифах Team и Enterprise давайте коннектору токен только на чтение. Для действий с серверами и деньгами каждый может использовать собственный токен в клиенте вроде Claude Code: Подключение из Claude Code, Cursor, VS Code и других клиентов.

Проверьте подключение

1. Откройте новый чат, нажмите «+» → «Connectors» и убедитесь, что BLACKBOX включён.
2. Напишите: «Вызови whoami».
3. Claude подтвердит, что токен принят (authenticated), и покажет идентификатор вашего аккаунта blackbox.md (customer_id), разрешения токена (scopes) и недостающие разрешения (missing_scopes). Если у токена есть все разрешения, в ответе будет «All scopes granted — every tool is available.»
4. Задайте настоящий вопрос, например «Покажи мои серверы BLACKBOX и их статус».

Инструменты, на которые у токена нет разрешения, в списке Claude вообще не появляются. Добавить разрешение к существующему токену нельзя: создайте новый токен и заново добавьте коннектор.

Подтверждение инструментов в Claude

BLACKBOX отдельно помечает инструменты, которые только читают данные (серверы, баланс, счета, ключи), и инструменты, которые что-то меняют. Claude показывает их по группам в «Customize» → «Connectors» → BLACKBOX → «Tool permissions» с тремя вариантами: «Always allow», «Needs approval» и «Blocked».

• Для инструментов, которые только читают, «Always allow» допустимо.
• Для инструментов, которые записывают или удаляют, выберите «Needs approval»: Claude покажет вызов и дождётся вашего согласия.
• Ненужные инструменты переведите в «Blocked» или, что надёжнее, не выдавайте токену соответствующее разрешение.

Не выбирайте «Always allow» для этих инструментов:

Важно BLACKBOX не может принудительно включить подтверждение: оно зависит только от настроек Claude. Ассистенту предписано спрашивать согласие, прежде чем оформить или оплатить заказ, сделать апгрейд, отменить заказ, удалить SSH-ключ с сервера или отключить вход по паролю. Команды на сервере и перезагрузки, о которых вы попросили, он выполняет сразу. Если для этих инструментов выбрано «Always allow», перед выполнением вы ничего не увидите.

Другие допустимые заголовки

Альтернативные заголовки BLACKBOX читает, только когда нет заголовка Authorization, в порядке из таблицы, и берёт первый, в котором есть токен bbx_pat_. Значение без токена bbx_pat_ игнорируется. Если выбрать «Custom header», Claude примет только имена заголовков, одобренные Anthropic, поэтому проще использовать x-api-key.

Если раздела «Request headers» нет

По данным Anthropic, аутентификация через «Request headers» находится в бета-версии и доступна только части организаций. Без неё Claude не может передать токен, и подключение не удаётся. Варианты:

• Используйте Claude Code или другой клиент, который отправляет заголовок Authorization: Bearer bbx_pat_…: Подключение из Claude Code, Cursor, VS Code и других клиентов.
• Файл конфигурации Claude Desktop (claude_desktop_config.json) предназначен для локальных серверов, работающих на вашем компьютере, поэтому пример JSON со страницы https://blackbox.md/ru/info/mcp не для него. Опытные пользователи могут прописать в этом файле локальный мост, например mcp-remote (нужен Node.js), который передаёт запросы на https://api.app.blackbox.md/mcp вместе с заголовком токена.

Ошибки при подключении

Изменить заголовки сохранённого коннектора в Claude нельзя. Чтобы исправить заголовок или сменить токен, удалите коннектор («Remove» в «Customize» → «Connectors»; на тарифах Team и Enterprise его удаляет владелец в «Organization settings» → «Connectors») и добавьте его заново. На Team и Enterprise участникам затем нужно снова нажать «Connect».

Частые вопросы

Работает ли коннектор в Claude Desktop? Да. Пользовательские коннекторы работают в claude.ai и в Claude Desktop, шаги одинаковые: «Customize» → «Connectors».

Как заменить токен в коннекторе? Создайте новый токен, удалите коннектор и добавьте его заново с новым токеном. Затем отзовите старый токен на странице «API-токены» кнопкой «Отозвать».

Claude советует пресет «AI agent — full access». Где он? На странице «API-токены» эта кнопка называется «AI-администратор — полный доступ». Она отмечает все разрешения, включая команды от root на серверах и оплату с баланса.

Какие данные попадают к Anthropic? Всё, что возвращают инструменты BLACKBOX, получает Claude и его провайдер — Anthropic. С разрешением «Просматривать пароли/доступы к серверам» (servers:credentials) это включает пароли и ключи серверов. Подробнее: Безопасность токенов и AI-агентов.