MCP подключён, но не работает: поиск сбоя по этапам в Mono
Разберите сбои транспорта, авторизации, обнаружения возможностей, поддержки модели и вызова инструмента в Mono, затем проверьте безопасное чтение.
Сохранённый сервер MCP ещё не значит, что инструмент работает. Адрес может быть верным, а вход — не завершённым. Вход может пройти успешно, а инструменты сервера — не загрузиться. А инструмент может загрузиться, но всё равно получить неверный запрос. Прежде чем менять настройки, найдите первый шаг, на котором всё ломается.
Это руководство посвящено устранению неполадок в Mono by Reunified, который ещё не вышел (запишитесь в список ожидания). Для первого подключения используйте руководство по настройке MCP. Здесь цель — превратить расплывчатое «не работает» в одно понятное наблюдение, которое можно повторить, не повторив случайно запись.
1. Запишите симптом и прекратите неопределённые повторы
Запишите имя сервера, транспорт, устройство, версию приложения, что вы пытались сделать, и точный текст ошибки — без секретов. Отметьте, работала ли та же настройка раньше и что с тех пор изменилось. «После входа список инструментов пуст» полезнее, чем «MCP сломался».
Если последний запрос мог что-то создать, отправить или изменить, проверьте место назначения, прежде чем повторять. Потерянный ответ не значит, что действие не выполнилось. Для проверки перейдите на небольшой запрос только на чтение — например, вывести один элемент тестового проекта, который вы можете проверить.
Сохраните у себя копию последних рабочих настроек. Не вставляйте токены, коды авторизации и приватный вывод инструментов в публичное обращение в поддержку.
2. Проверьте транспорт до проверки аккаунта
Для HTTP-подключения в Mono нужен адрес сервера MCP, а не обычная главная страница или адрес API модели. Сравните полный URL вместе с путём с актуальной документацией издателя сервера. Страница, которая открывается в браузере, доказывает только то, что эта страница доступна, а не то, что там работает MCP.
Для варианта «Стандартный ввод/вывод» (stdio) проверьте команду и аргументы на устройстве, которое должно их запускать. Повторный вход не исправит отсутствующую команду или устройство, которое не может её выполнить. Телефоны и компьютеры различаются, поэтому не ждите, что команда для компьютера запустится на телефоне.
Адрес с localhost указывает на устройство, которое отправляет запрос. Проверяйте с самого устройства, через поддерживаемый путь и после входа. Не ослабляйте контроль доступа у работающего сервера только ради того, чтобы прошла проверка.
3. Различайте сохранение настроек и завершение авторизации
Проверьте выбранный способ аутентификации. Для «Токен Bearer» нужен правильный токен сервиса в его поле. Для OAuth нужны правильный аккаунт, выполнение требований сервера и полное возвращение в Mono; если закрыть браузер раньше времени, вход не считается успешным.
Mono может сохранить сервер до завершения входа, поэтому сохранённый сервер не доказывает, что вход прошёл. Даже после успешного входа загрузка инструментов сервера какое-то время может не удаваться. Ни сохранённая запись, ни сообщение «Подключено к серверу» не доказывают, что конкретный инструмент готов.
Если изменить URL или транспорт сервера, Mono воспримет его как новое подключение, так что может понадобиться войти снова. Исправьте настоящую ошибку в адресе, но не меняйте раз за разом рабочий URL как общий сброс. Не угадывайте значения — следуйте настройкам клиента и перенаправления из документации издателя.
4. Проверьте возможности и выбранную модель
Архитектура MCP различает инструменты, ресурсы и промпты. Сервер может предлагать только часть из них, поэтому сервер, который даёт одни ресурсы, не даст помощнику ни одного инструмента для вызова.
У установленного навыка MCP откройте раздел «Конфигурация», чтобы увидеть инструменты, которые нашёл Mono. Если он пуст, проверьте вход и то, отдаёт ли сервер список своих инструментов; не считайте, что доступны все действия сервиса. Сохранение сервера — это не полная проверка его работы.
Проверьте и модель, которую использует чат. Не каждая модель умеет вызывать инструменты, включая некоторые модели, которые вы подключаете сами. Модель, которая хорошо отвечает текстом, всё равно может быть причиной того, что подключённый инструмент никогда не используется. Это объясняется в руководстве по пользовательскому endpoint.
5. Проверьте одну известную операцию
Используйте безобидный запрос и сравните результат с исходным сервисом:
Прочитай название существующего демонстрационного объекта, который я укажу.
Ничего не создавай, не изменяй, не отправляй и не удаляй.
Если доступ не удался, сообщи об ошибке, а не угадывай название.| Что вы видите | Что проверить дальше |
|---|---|
| Не удаётся подключиться к адресу | Адрес, транспорт, сеть устройства и работает ли сервер |
| Вход не завершается | Аккаунт, способ аутентификации и требования OAuth издателя |
| Не появляется ни одного инструмента | Что предлагает сервер, загрузились ли его инструменты и поддерживает ли модель инструменты |
| Один инструмент не работает | Нужные данные, разрешения в сервисе и возвращённая ошибка |
| Чтение работает, запись блокируется | Доступ, который вы хотели дать, и настройка разрешения инструмента; не открывайте всё |
Ошибка самого инструмента — не то же самое, что пустой, но успешный результат. Храните вместе возвращённый статус и важный текст, без секретов.
6. Подтвердите исправление и сохраните запись
Меняйте по одному параметру, повторяйте ту же проверку только на чтение и записывайте результат. Если позже понадобится запись, проверьте её точную цель и подтвердите результат в сервисе, прежде чем пробовать снова.
Сохраните короткую заметку о шаге, на котором всё ломается, версиях, внесённом изменении и последней успешной проверке. Удаление подключения в Mono и отзыв доступа у поставщика — это разные шаги. О решениях по разрешениям во время работы читайте в руководстве по разрешениям инструментов; повторные одобрения подключение не починят.
