MCP и внешние инструменты
Симптомы
- агент не может получить данные из базы знаний или другого сервиса;
- MCP-сервер не подключается;
- инструменты сервера не появляются в Tools;
- агент видит сервер, но не может выполнить нужное действие;
- не работает поиск в интернете или браузерный сценарий.
Что проверить
- Добавлен ли сервер в настройках Veai и находится ли он в состоянии
Connected. - Корректны ли адрес, команда запуска и параметры сервера.
- Переданы ли нужные переменные окружения и учётные данные.
- Разрешён ли нужный инструмент в меню Tools.
- Есть ли у учётной записи права на запрашиваемое действие.
Ошибки подключения
Veai показывает основное сообщение, причину, возможные действия и технические подробности. Точный текст от сервера может отличаться, поэтому ориентируйтесь и на заголовок ошибки, и на её поля.
| Симптом или ошибка | Где искать причину | Что обычно произошло | Что сделать |
|---|---|---|---|
| Исполняемый файл не найден | Команда запуска, executable или технические подробности | Путь к STDIO-серверу неверен либо программа недоступна в окружении IDE | Укажите абсолютный путь или добавьте программу в окружение, затем переподключите сервер |
| Процесс завершился при запуске | Причина запуска и код завершения | Команда, аргументы или переменные окружения не подходят серверу | Запустите ту же команду отдельно с безопасными тестовыми данными, исправьте параметры и переподключитесь |
Connection Timeout | Стадия подключения и timeout | Сервер не успел запуститься, ответить на инициализацию или вернуть инструменты | Проверьте сеть и процесс сервера, затем выполните Reconnect; не запускайте много повторов параллельно |
Authentication Failed, HTTP 401 | Ответ сервера и заголовки авторизации | Учётные данные отсутствуют, истекли или отклонены | Повторите авторизацию либо обновите токен в безопасном хранилище или переменной окружения |
Access Denied, HTTP 403 | Ответ сервера | Учётная запись распознана, но ей не хватает прав | Запросите нужную роль или сузьте действие до разрешённого |
Rate Limit, HTTP 429 | Ответ сервера, при наличии Retry-After | Превышена частота или квота запросов | Подождите указанный срок, уменьшите параллельные вызовы и повторите один раз |
Handshake Incomplete | Стадия initialize | Клиент и сервер не завершили согласование MCP | Проверьте URL или транспорт, совместимость версии сервера и его журнал |
Tools Endpoint Failed | Стадия list tools | Соединение установлено, но сервер не вернул список инструментов | Проверьте права и реализацию tools endpoint, затем выполните Reconnect |
| Protocol error или некорректный ответ | Технические подробности и ответ сервера | Сервер вернул сообщение, не соответствующее MCP | Обновите сервер или исправьте его конфигурацию; приложите очищенный фрагмент ответа в поддержку |
Подключение включает инициализацию и получение списка инструментов. При Reconnect Veai запрашивает список заново. Отдельная кнопка обновления только списка инструментов текущей реализацией не подтверждена.
После подключения
Сначала выполните безопасный запрос только на чтение. Если сервер подключён, но инструмент не виден, проверьте его наличие на стороне сервера, выполните Reconnect, а затем откройте меню Tools.
Не храните токены в Markdown, AGENTS.md и сообщениях чата. Для инструментов, которые изменяют внешние данные, оставьте запрос подтверждения.
Для фронтенда можно подключить Chrome MCP или Playwright MCP, чтобы агент видел результат в браузере. Для обычного поиска и чтения страниц используйте Web Search.