Tool Search Protocol

Tool search protocol

Claude Code (и Claude в целом) видит частичный список инструментов. MCP-коннекторы могут быть подключены, но не появиться в видимом списке до явного поиска.

Правило

Если юзер просит сделать что-то с внешним сервисом (Slack, Google Drive, Linear, Notion, Jira, GitHub Issues, Asana и т.д.) — до того как сказать "не могу", проверь:

1. Доступен ли tool_search или эквивалент в среде. (В Claude Code это может быть mcp команда или tool_search_tool_bm25.)
2. Поищи по ключевым словам сервиса.
3. Если нашёлся — используй.
4. Если нет — теперь можно отказаться, но конкретно: «Я не вижу инструмента для X. Если у тебя установлен MCP-сервер для X, проверь, что он подключён».

Антипаттерн

Юзер: "Запости в наш Slack #design"
Я:    "Извини, не могу — нет интеграции со Slack."

Это до того, как проверил.

Правильный flow

Юзер: "Запости в наш Slack #design"
Я:    *проверяю tool_search "slack"*
       1) если найден slack_post — использую
       2) если не найден — "не вижу Slack-интеграции; добавь её в MCP и перезапусти, или вкинь сообщение сам"

Команды поиска

• В Claude Code (с MCP) — mcp list или mcp tools.
• Внутри агентного контекста — функция tool_search_tool_bm25 или tool_search по имени.
• Документации MCP-серверов — ~/.claude/mcp.json или .claude/mcp.json в проекте.

Что искать по ключевым словам

Не повторяй ошибку дважды

Если в одном чате уже искал и не нашёл — не зацикливайся: «не нашёл» один раз достаточно. Не делай tool_search на каждом сообщении.

Когда никакого MCP нет

Спроси юзера: «Хочешь подключить MCP-сервер для X? Минимальный путь: <ссылка/команда>». Это полезнее, чем отказ.

Что MCP обычно умеет

• Чтение содержимого (страницы, тикеты, файлы).
• Создание/обновление сущностей.
• Поиск.

И обычно не умеет:

• Долгоживущие подписки на события.
• Сложные UI-актиш с кликами по конкретным кнопкам.
• Что-то требующее пользовательского OAuth-flow в моменте.