MCP-сервер: подключение Claude, Cursor и других ИИ-ассистентов

Наблюдатель работает как MCP-сервер: к нему подключаются Claude Code, Claude Desktop, Cursor и другие ИИ-ассистенты с поддержкой MCP. Подключённый ассистент видит ваши проекты, серверы, контейнеры, ошибки, события, логи и трассы, помогает найти причину сбоя и по вашей просьбе настраивает мониторинг: создаёт стеки с агентами, проверки сайтов, правила уведомлений.

Почти всё, что можно сделать в кабинете, можно сделать и из чата с ассистентом. В этой статье — как выпустить ключ, какие права выбрать, как подключить популярные клиенты и как это устроено с точки зрения безопасности.

#Что такое MCP

MCP (Model Context Protocol) — открытый протокол, через который ИИ-ассистенты подключаются к внешним сервисам. Ассистент получает список инструментов сервиса — «показать инциденты», «создать проверку сайта» — и сам решает, какие вызвать, чтобы ответить на ваш вопрос.

Для мониторинга это значит, что не нужно искать нужный график или читать документацию: достаточно спросить своими словами. «Почему ночью перезапускался контейнер api?» — ассистент сам посмотрит инциденты, метрики памяти и логи и объяснит, что случилось.

#Как получить ключ для ИИ-ассистента

Ключ выпускается в кабинете, в разделе «MCP» бокового меню — app.nablops.io/mcp.

1. В поле «Название токена» укажите, где он будет использоваться, например Claude Code на ноутбуке. Так потом проще понять, какой ключ отозвать.
2. В поле «Права» выберите «Только чтение» или «Редактирование и удаление» — см. следующий раздел.
3. В поле «Срок действия» выберите 30 дней, 90 дней, 1 год или «Бессрочно». По умолчанию — 90 дней.
4. Нажмите «Создать токен».
5. Скопируйте токен. Он начинается с nabl_pat_ и показывается один раз: после закрытия страницы посмотреть его будет нельзя.

После создания токен сразу подставляется в готовые команды подключения ниже на той же странице — их можно копировать как есть.

Если в аккаунте ещё нет проектов, ключ можно создать прямо на странице «Обзор»: там кнопка «Создать ключ» (права на настройку, срок 90 дней), команда подключения и готовый промпт, который подключает ваш проект одним сообщением. Как это выглядит — в статье Быстрый старт.

Все ваши ключи видны в таблице на странице «MCP»: название, права, когда создан, когда последний раз использовался и когда истекает. Ключ, который больше не нужен или мог утечь, отзовите значком корзины → «Отозвать». Он перестаёт работать сразу. У одного пользователя может быть до 20 ключей.

#Права ключа: только чтение или редактирование

Поверх прав ключа действуют ваши права в проекте. Если в проекте у вас роль «Просмотр», ассистент не сможет его настроить даже с ключом «Редактирование и удаление».

С ключом «Только чтение» ассистент не видит инструментов изменения. Если вы попросите что-то настроить, он скажет, что нужен ключ с правами на редактирование, и предложит готовые значения, чтобы вы задали их сами. Исключение — обращения в поддержку: их ассистент может создать и с ключом только для чтения.

#Как подключить ИИ-ассистента

Данные для любого клиента:

Точный адрес и команды с вашим токеном показаны на странице «MCP» в кабинете — копируйте их оттуда.

#Claude Code

Выполните в терминале:

claude mcp add --transport http nabl https://app.nablops.io/api/v1/mcp --header "Authorization: Bearer nabl_pat_…"

Без дополнительных флагов сервер подключается для текущего проекта. Чтобы Наблюдатель был доступен во всех ваших проектах, добавьте --scope user. Проверить подключение можно командой /mcp внутри Claude Code: в списке должен появиться сервер nabl.

#Cursor и другие клиенты с JSON-конфигом

Большинство клиентов, которые подключают удалённые MCP-серверы по HTTP, принимают такой конфиг:

{
  "mcpServers": {
    "nabl": {
      "type": "http",
      "url": "https://app.nablops.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer nabl_pat_…" }
    }
  }
}

В Cursor добавьте его в ~/.cursor/mcp.json (для всех проектов) или в .cursor/mcp.json в корне репозитория (для одного проекта). Если в репозитории работает команда, не коммитьте файл с ключом.

#Claude Desktop

На странице «MCP» для Claude Desktop показан тот же JSON-конфиг, что и для Cursor. Если ваша версия Claude Desktop не подключает из него удалённый сервер с заголовком авторизации, используйте мост mcp-remote — он запускается локально через Node.js и пересылает запросы в Наблюдатель. Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "nabl": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.nablops.io/api/v1/mcp",
        "--header",
        "Authorization: Bearer nabl_pat_…"
      ]
    }
  }
}

После сохранения перезапустите Claude Desktop.

#Другие ассистенты

Подойдёт любой клиент, который умеет подключать MCP-серверы по Streamable HTTP и передавать свой заголовок. Укажите адрес сервера, транспорт HTTP и заголовок Authorization: Bearer <токен> из таблицы выше — названия полей в конфиге зависят от клиента.

#Что умеет ИИ-ассистент

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

Смотреть и разбирать (любой ключ):

• сводка по проекту: статусы стеков, открытые ошибки, инциденты за сутки, проблемные проверки и серверы;
• карта проекта и слепые зоны: что не подключено и кто это закрывает — сам ассистент, правка в приложении или команда на сервере;
• контейнеры и поды, их метрики и текущая нагрузка, последние строки логов и поиск строки (например, id запроса) по последним 5000 строкам лога;
• серверы: метрики, топ процессов, история заполнения дисков;
• ошибки приложений, инциденты (OOM, падения, перезапуски), ленты событий стеков и серверов;
• трассы, медленные операции, запросы к базе, карта сервисов, сравнение с прошлым периодом; записи потоков с тем же trace_id, что у трассы;
• сервис: кто его вызывает и кого вызывает он, его контейнеры, события и цель сервиса — как он держал её за сутки и неделю и сколько осталось запаса;
• поиск по событиям и логам приложения, подсчёт и разбивка по полям;
• HTTP-проверки: статус, этапы времени ответа, сертификат, история за период;
• свои метрики и S3-хранилища;
• поиск причины сбоя: от сервиса вниз по зависимостям до базы, диска или сервера.

Настраивать (ключ «Редактирование и удаление»):

• создать проект, стек или сервер вместе с агентом и готовой инструкцией установки; выпустить агенту новый токен, а серверу или стеку без агента — нового агента;
• подключить сервер к проекту, отключить его от проекта или удалить сервер;
• указать, на каких серверах работает стек;
• задать свою цель сервиса по времени ответа и доле ошибок или вернуть автоматическую;
• создать, изменить и удалить HTTP-проверки, запустить проверку сейчас;
• правила уведомлений: включить типовые, подобрать пороги по истории, добавить свои;
• каналы Telegram, MAX и почты: включить, выбрать уровни и фильтр, отправить тестовое сообщение;
• источники своих метрик, названия и единицы метрик, удаление истории ненужных метрик;
• потоки событий: название, колонки таблицы, лишние поля;
• S3-хранилища и отслеживаемые папки с бекапами;
• отметить ошибку решённой или заглушить.

Поддержка. Если ассистент упрётся в ошибку Наблюдателя или не найдёт ответа, он предложит написать в поддержку: соберёт подробности, покажет черновик и отправит его только после вашего согласия. Когда поддержка ответит, ассистент перескажет ответ и продолжит работу.

Примеры запросов по сценариям — в статье Что спросить у ИИ-ассистента.

#Безопасность

• Видит только ваше. Ассистент работает от вашего имени и видит только проекты, к которым у вас есть доступ. Права в проекте те же, что в кабинете.
• Ключ — как пароль. Храните его как пароль, не публикуйте в репозиториях. Выпускайте отдельный ключ для каждого клиента и устройства и задавайте срок действия.
• Минимальные права. Для разбора инцидентов достаточно «Только чтение». Утёкший ключ с этими правами даёт только чтение. Ключ «Редактирование и удаление» выпускайте там, где ассистент действительно должен настраивать.
• Удаление — с подтверждением. Инструменты удаления помечены для клиента как опасные, и ассистенту предписано спрашивать вас перед любым удалением. Удаление в Наблюдателе необратимо — проверяйте, что именно ассистент предлагает удалить.
• Секреты не проходят через ассистента. Токены ботов Telegram и MAX задаются только в кабинете: ассистент их не принимает и не видит. Ключ S3-хранилища ассистент может передать при подключении бакета, но обратно его не получит.
• Персональные данные скрыты. Email, телефоны, номера карт, ИНН, СНИЛС, пароли и токены агент маскирует ещё на вашем сервере — в логах, ошибках, трассах и событиях. Ассистент получает уже обезличенные данные, поэтому найти строку лога по email или телефону нельзя.
• Отзыв в один клик. Ключ отзывается на странице «MCP», и доступ пропадает сразу.

Поставщика ассистента выбираете вы: данные, которые ассистент прочитал из Наблюдателя, обрабатываются по условиям этого поставщика.

#Если ассистент не подключается

• Ошибка авторизации. Проверьте, что токен скопирован целиком, начинается с nabl_pat_ и передаётся как Authorization: Bearer <токен>. На странице «MCP» проверьте, не истёк ли ключ и не отозван ли он.
• Ассистент не видит инструментов настройки. У ключа права «Только чтение» — выпустите ключ «Редактирование и удаление».
• Ассистент не может изменить проект. У вас в проекте роль «Просмотр» — попросите владельца дать роль «Редактор».
• Ассистент не видит логи контейнера. Последние строки логов ассистент получает через агента, поэтому агент стека должен быть на связи.

Остальные проблемы — в статье Если что-то не работает.

#Что дальше

• Что спросить у ИИ-ассистента — готовые запросы по сценариям.
• Быстрый старт — подключить первый стек вручную или через ассистента.
• Правила уведомлений — какие правила уже есть в проекте.
• Поддержка — как задать вопрос команде Наблюдателя.