Одинаковые названия tools на разных MCP-серверах: как избежать путаницы
Сделайте выбор инструмента различимым по назначению и контексту сервера. Универсальное имя search плохо объясняет, искать ли клиента, документ или товар, если подключено несколько интеграций.
Разберём рабочий случай
К агенту подключены склад и база знаний. У обоих есть инструмент search с кратким описанием «поиск данных». Пользователь спрашивает про гарантию товара, а модель отправляет запрос на склад и получает технический артикул. Ошибка не обязательно в модели: интерфейс инструментов не различает две реальные операции. Дополнительные инструменты усиливают неоднозначность каталога.
Что изменить
Проверьте, как целевой клиент представляет имена нескольких серверов и разрешает совпадения. На своей стороне выбирайте конкретные названия, например поиск товаров и поиск документов, а в описании укажите результат и ограничения. Не делайте инструментов больше ради названий: два действия с одинаковой семантикой могут оставаться одним с ясными параметрами. Используйте примеры вопросов, где область легко перепутать, и наблюдайте фактический выбор.
Как проверить результат
| Проверка | Ожидаемое поведение |
|---|---|
| Вопрос о гарантийной политике | Выбран поиск документов, а ответ ссылается на найденный источник; склад не получает бессмысленный запрос. |
| Запрос остатка по артикулу | Выбран складской инструмент и проверен доступ пользователя к соответствующим данным. |
| Подключение третьего сервера с похожим именем | Клиентский каталог остаётся различимым; новое подключение не меняет скрыто маршрутизацию прежних задач. |
Слишком похожие описания часто появляются при автоматической генерации обёрток API. Вынесите в начало отличающее назначение и ограничения, а не одинаковое техническое приветствие про удобный доступ к данным.
Сильные описания улучшают выбор, но не гарантируют его на всех формулировках. Для критичной операции оставляйте проверку параметров, прав и при необходимости подтверждение намерения после выбора tool.
Проектирование каталога tools — часть качества интеграции, особенно когда агент работает сразу с несколькими бизнес-системами. В платном курсе AI Agent Integrations PRO: MCP можно продолжить изучение соответствующего инженерного направления. Перед покупкой сравните программу и открытые материалы со своей задачей.
Документация для проверки технических деталей: MCP tools: спецификация 2025-06-18.
Следующий шаг: MCP-интеграции: контракты инструментов, ошибки и доступ. По смежным вопросам: Структурированный ответ MCP tool: как не потерять типы данных, Пагинация MCP tool: как не потерять данные между страницами.
