Подключите Claude Code к своей панели

После такой настройки Claude Code сможет заглядывать в вашу панель, пока вы работаете в терминале: «какой из моих аккаунтов ближе всего к лимиту диска?», «покажи DNS-записи для example.com». Он читает только то, что разрешает ваш токен. Всё, что удаляет или прерывает работу, превращается в запрос, который ждёт, пока вы нажмёте «Одобрить» в панели. Ассистент никогда не одобряет собственный запрос.

Это второй способ пользоваться ИИ в Nimbopanel. Первый — чат внутри самой панели — описан в разделе ИИ-ассистент. Для работы с Claude Code он не нужен.

Что понадобится

• Адрес вашей панели, например https://panel.yourdomain.com. Используйте именно адрес панели, а не IP.
• Установленный на вашем компьютере Claude Code (команда claude работает в терминале).
• Аккаунт в панели: администратор, реселлер, клиент или пользователь команды.

1. Администратор включает подключение (один раз)

Откройте Система → Безопасность → Подключение ИИ-ассистента (MCP), отметьте Разрешить подключение ИИ-ассистентов, выберите, каким ролям разрешено подключаться, и нажмите Сохранить. На карточке показан адрес, который используют ассистенты: /mcp после адреса вашей панели.

В новой установке подключение выключено. Пока оно не включено, /mcp отвечает 404 и ничего из описанного ниже не работает.

2. Создайте токен только для ассистента

Войдите в панель и откройте Токены API: у администраторов и реселлеров они в разделе Безопасность, у клиентов — в разделе Дополнительно. Откройте Подключить ИИ-ассистента (Claude и другие).

1. Дайте токену понятное название, например Claude Code на моём ноутбуке.
2. Для каждого раздела панели выберите Нет доступа, Чтение или Чтение и изменение. Начните с Чтение: ассистент сможет смотреть всё отмеченное и ничего не изменит.
3. Оставьте в поле Перестаёт работать через (дней) значение 90 или укажите своё число.
4. Нажмите Создать токен ассистента.

Панель покажет токен только один раз. Скопируйте его, прежде чем уйти со страницы.

3. Вставьте одну команду

Панель выводит команду, в которой ваш адрес и токен уже подставлены. Скопируйте её и выполните в терминале. Выглядит она так:

claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"

Что она означает: добавить MCP-сервер с именем nimbopanel, доступный по HTTP на адресе панели /mcp, и при каждом обращении отправлять ваш токен в заголовке Authorization.

Где Claude Code это хранит. По умолчанию сервер сохраняется только для текущего проекта — в ~/.claude.json на вашем компьютере, а не в папке проекта. Добавьте --scope user, чтобы использовать его во всех проектах. Не добавляйте --scope project с настоящим токеном: тогда токен попадёт в .mcp.json — файл, который принято коммитить и делиться им. Если подключением пользуется команда, положите в .mcp.json только ссылку, а токен каждый пусть хранит у себя в переменной окружения:

{
  "mcpServers": {
    "nimbopanel": {
      "type": "http",
      "url": "https://panel.yourdomain.com/mcp",
      "headers": { "Authorization": "Bearer ${NIMBOPANEL_TOKEN}" }
    }
  }
}

Пусть каждый создаст собственный токен: так в запросе видно, кто спрашивал, и один токен можно отозвать, не затрагивая остальные.

4. Проверьте, что всё работает

claude mcp list

nimbopanel должен отображаться как подключённый. Внутри Claude Code можно также ввести /mcp. Затем спрашивайте простыми словами:

• «Покажи мои хостинг-аккаунты и скажи, какой занимает больше всего места на диске».
• «Покажи DNS-записи для example.com».
• «Какие из моих баз данных самые большие?»
• Администраторам: «Все ли службы работают?», «Не растёт ли почтовая очередь?»

Ассистент видит аккаунты и их использование, домены, DNS-записи, почтовые ящики (но никогда не пароли), базы данных, резервные копии, нагрузку на сервер и службы, почтовую очередь, реселлеров и обращения в поддержку — в пределах разделов, указанных в токене, и вашей собственной роли.

Когда вы просите что-то изменить

• С правом Чтение и изменение обычная новая адресная запись (A или AAAA) или текстовая (TXT) для нового рядового имени добавляется сразу.
• Всё остальное ждёт вас: удаление записи, приостановка аккаунта или возврат его в работу, почтовые записи, сам домен, записи CNAME, SRV и CAA, wildcard-записи и имена, которые ищут почтовые программы. Это становится запросом.

Откройте Токены API → Запросы ассистента. В каждом запросе простыми словами сказано, что произойдёт. Нажмите Одобрить…, затем Да, выполнить сейчас. Запрос истекает через 30 минут. Читайте сам запрос, а не сообщение ассистента: запрос составляет панель, и в нём точно указано, что будет сделано.

Поскольку изменение запросил ассистент, панель сначала просит подтвердить, что это вы, паролем (и кодом подтверждения, если вы используете двухэтапный вход); после этого несколько минут она не спрашивает снова.

Если не работает

Что вы видите	Что это значит	Что делать
404 Not found от /mcp или страница с сообщением, что для этого адреса не настроен ни один сайт	Подключение выключено, либо вы использовали адрес, который не является собственным адресом панели (IP или другой домен)	Шаг 1; используйте собственный адрес панели, заканчивающийся на /mcp
403 forbidden_host	Адрес доходит до панели, но она не узнаёт его как свой	Используйте собственный адрес панели, например https://panel.yourdomain.com
401 Login required	Токен не указан, набран с ошибкой, истёк или отозван	Создайте новый токен и выполните команду снова
403 mcp_scope_required	Это обычный токен API, а не токен для ассистентов	Создайте токен в разделе Подключить ИИ-ассистента
403 mcp_off_for_role	Вашему типу аккаунта нельзя подключать ассистента	Попросите администратора (шаг 1)
429 rate_limited	Слишком много обращений за короткое время	Подождите минуту
Часть панели недоступна	Для этого раздела выбрано Нет доступа	Создайте новый токен с правом Чтение для этого раздела

Если claude mcp list показывает ошибку, обычно в адресе нет /mcp либо заголовок записан не в точности как Authorization: Bearer <token>.

Как всё отключить

claude mcp remove nimbopanel

Эта команда удаляет подключение с вашего компьютера. Чтобы токен перестал работать везде, удалите его в разделе Токены API; все оставленные им открытые запросы будут отменены. Администратор может выключить подключение целиком на шаге 1, и /mcp снова будет отвечать 404.

Полезные привычки

• Предпочитайте Чтение. Чтение и изменение давайте только тем разделам, где это нужно.
• Один токен на компьютер или человека, с названием, из которого понятно, чей он.
• Оставьте срок по умолчанию в 90 дней или сделайте его короче для общего компьютера.
• Никогда не вставляйте токен в чат, обращение в поддержку или файл, который вы коммитите.

Пока не поддерживается: клиенты, которые умеют подключаться только через вход по OAuth. Эта точка подключения принимает токен в заголовке.