Дайте MonstarX инструменты через подключения MCP

КраткоВ разделе «Облачные сервисы → Облако → Подключения → MCP» добавьте удалённый сервер MCP по имени и адресу HTTPS или вставьте конфигурацию JSON сразу для нескольких серверов. MonstarX проверит подключение, покажет инструменты сервера и затем сможет пользоваться ими в режиме «Создать» в этом проекте. До 32 серверов на проект.

MCP (Model Context Protocol) — распространённый способ, которым ИИ-инструменты предлагают друг другу свои возможности. Сервер MCP — это сервис с набором инструментов: поиск по документации, поиск данных в системах вашей компании, выполнение задачи. Сейчас такие серверы публикуют многие продукты.

Подключите сервер MCP к проекту — и конструктор MonstarX сможет пользоваться его инструментами, пока работает над этим приложением. Например, подключите сервер с документацией и скажите: «загляни в документацию платёжного провайдера и сделай возврат средств так, как там рекомендуют».

Перед началом

Нужен общедоступный адрес HTTPS сервера из документации провайдера. Обычно он заканчивается на /mcp или /sse.
Если сервер требует входа, получите у провайдера токен доступа или ключ API.

Как добавить сервер MCP?

Откройте проект, нажмите Облачные сервисы на верхней панели, а затем Облако.
В списке Подключения найдите карточку MCP и нажмите Добавить сервер.
Заполните форму:
- Имя сервера — любое понятное вам имя, например «Поиск по документации»;
- URL сервера — адрес HTTPS сервера;
- Тип подключения — Streamable HTTP для современных серверов или Прежний протокол SSE, если провайдер дал адрес SSE;
- Bearer-токен (необязательно) — токен доступа, если он нужен серверу;
- Пользовательские заголовки (JSON, необязательно) — для серверов, которые ждут ключ в собственном заголовке, например { "X-Api-Key": "…" }.
Нажмите Подключить и проверить инструменты. MonstarX подключится к серверу и покажет его инструменты, прежде чем что-либо сохранить. Если подключиться не удастся, ничего не сохранится, а MonstarX подскажет, что проверить.

Можно ли добавить сразу несколько серверов?

Да, если у вас уже есть конфигурация MCP из другого инструмента. Вместо Добавить сервер нажмите Импортировать JSON, вставьте объект mcpServers и нажмите Подключить и проверить инструменты:

{
  "mcpServers": {
    "documentation": {
      "url": "https://mcp.example.com/mcp"
    },
    "workspace": {
      "type": "http",
      "url": "https://tools.example.org/mcp",
      "headers": { "Authorization": "Bearer YOUR_ACCESS_TOKEN" }
    },
    "legacy": {
      "type": "sse",
      "url": "https://legacy.example.net/sse"
    }
  }
}

MonstarX проверяет каждый сервер, прежде чем сохранить хоть один из них. Имена должны быть разными. Серверы, которые запускают программу на вашем компьютере (command вместо url), импортировать нельзя.

Форма «Импортировать JSON»: поле для конфигурации MCP, пометка, что серверы, запускаемые командами, не поддерживаются, кнопки «Подключить и проверить инструменты» и «Отмена»

Как MonstarX пользуется инструментами?

Когда сервер подключён и включён, MonstarX знает его инструменты и понимает, когда к ним обращаться. Пишите в чат как обычно и, если это поможет, упомяните сервер: «через сервер „Поиск по документации“ проверь, как работают вебхуки».

В режиме Создать MonstarX может просматривать инструменты и пользоваться ими.
В режимах План и Чат он видит, какие инструменты есть, но не пользуется ими.
У двух серверов могут быть инструменты с одинаковыми именами — MonstarX их не перепутает.
Это работает и для импортированных приложений.

Как управлять подключённым сервером?

У каждого сервера в карточке MCP указано число инструментов и есть кнопки:

нажмите на число инструментов, чтобы увидеть, какие инструменты предлагает сервер;
Проверить подключение заново подключается и обновляет список инструментов — пригодится, когда провайдер добавит новые;
Отключить запрещает MonstarX пользоваться сервером, даже в запросе, который уже выполняется. Включить возвращает доступ;
Удалить удаляет сервер и его сохранённые учётные данные после подтверждения.

Что не поддерживается?

Серверы, которые работают на вашем компьютере (запускаются командой), в частной сети или на localhost. Адрес должен быть общедоступным адресом HTTPS.
Вход через всплывающее окно (интерактивный OAuth). Вместо этого получите токен у провайдера и вставьте его как bearer-токен.
Обновление токена с истекающим сроком. Когда срок истечёт, удалите сервер и добавьте его заново с новым токеном.
Ресурсы и промпты MCP, а также серверы, которым нужно задавать MonstarX встречные вопросы (sampling или elicitation). Используются только инструменты.

Полезно знать

До 32 серверов на проект.
Учётные данные остаются секретными. Адрес, токен и заголовки хранятся в зашифрованном виде. Они никогда не появляются в чате, в коде приложения и в опубликованном приложении.
Только один проект. Серверы принадлежат проекту, в котором вы их добавили, и добавлять их может только владелец проекта.

Вопросы и ответы

Где найти адрес сервера MCP?

В документации самого провайдера, обычно в разделе «MCP» или «ИИ-интеграции». Это адрес HTTPS, часто он заканчивается на /mcp.

Почему MonstarX не может пользоваться инструментами в режиме «Чат»?

Инструменты могут что-то менять в других системах, поэтому MonstarX запускает их только в режиме Создать. В режимах Чат и План по-прежнему видно, какие инструменты есть у сервера.

Сервер требует входа. Что делать?

Попросите у провайдера токен доступа или ключ API и вставьте его в поле Bearer-токен (необязательно) или в Пользовательские заголовки (JSON, необязательно), если провайдер называет другой заголовок.

Срок действия токена истёк. Как его обновить?

Удалите сервер и добавьте его заново с новым токеном. Сам MonstarX токены не обновляет.

Может ли приложение пользоваться этими серверами MCP?

Нет. Подключения MCP предназначены для конструктора MonstarX. Чтобы дать сервис приложению, воспользуйтесь подключением или попросите MonstarX интегрировать его с ключом в разделе Облачные сервисы → Секреты. Для актуальных открытых данных страны — погоды, транспорта, реестров — есть данные стран, которые размещает MonstarX.