Tool search protocol
Claude Code (и Claude в целом) видит частичный список инструментов. MCP-коннекторы могут быть подключены, но не появиться в видимом списке до явного поиска.
Правило
Если юзер просит сделать что-то с внешним сервисом (Slack, Google Drive, Linear, Notion, Jira, GitHub Issues, Asana и т.д.) — до того как сказать "не могу", проверь:
- Доступен ли
tool_search или эквивалент в среде. (В Claude Code это может быть mcp команда или tool_search_tool_bm25.)
- Поищи по ключевым словам сервиса.
- Если нашёлся — используй.
- Если нет — теперь можно отказаться, но конкретно: «Я не вижу инструмента для 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 в проекте.
Что искать по ключевым словам
| Запрос упоминает |
Поиск по |
| Slack |
slack, chat, message |
| Notion |
notion, page, database |
| Linear / Jira |
linear, jira, issue, ticket |
| Google Drive |
drive, gdrive, gdocs |
| Figma |
figma, design, frame |
| GitHub |
github, repo, pr, pull request |
| Email |
email, mail, smtp |
| Calendar |
calendar, event |
| Filesystem outside project |
file, bash, shell |
Не повторяй ошибку дважды
Если в одном чате уже искал и не нашёл — не зацикливайся: «не нашёл» один раз достаточно. Не делай tool_search на каждом сообщении.
Когда никакого MCP нет
Спроси юзера: «Хочешь подключить MCP-сервер для X? Минимальный путь: <ссылка/команда>». Это полезнее, чем отказ.
Что MCP обычно умеет
- Чтение содержимого (страницы, тикеты, файлы).
- Создание/обновление сущностей.
- Поиск.
И обычно не умеет:
- Долгоживущие подписки на события.
- Сложные UI-актиш с кликами по конкретным кнопкам.
- Что-то требующее пользовательского OAuth-flow в моменте.
1---2name: tool-search-protocol3description: "До отказа «нет интеграции» с Slack/Drive/Linear — сначала поиск инструмента через tool_search. Триггеры: «есть ли коннектор», «найди инструмент»."4metadata:5 source: https://skillmd.com/skills/jhamidun/tool-search-protocol6---78# Tool search protocol910Claude Code (и Claude в целом) видит **частичный** список инструментов. MCP-коннекторы могут быть подключены, но не появиться в видимом списке до явного поиска.1112## Правило1314Если юзер просит сделать что-то с внешним сервисом (Slack, Google Drive, Linear, Notion, Jira, GitHub Issues, Asana и т.д.) — **до того как сказать "не могу"**, проверь:15161. Доступен ли `tool_search` или эквивалент в среде. (В Claude Code это может быть `mcp` команда или `tool_search_tool_bm25`.)172. Поищи по ключевым словам сервиса.183. Если нашёлся — используй.194. Если нет — теперь можно отказаться, но конкретно: «Я не вижу инструмента для X. Если у тебя установлен MCP-сервер для X, проверь, что он подключён».2021## Антипаттерн2223```24Юзер: "Запости в наш Slack #design"25Я: "Извини, не могу — нет интеграции со Slack."26```2728Это **до того**, как проверил.2930## Правильный flow3132```33Юзер: "Запости в наш Slack #design"34Я: *проверяю tool_search "slack"*35 1) если найден slack_post — использую36 2) если не найден — "не вижу Slack-интеграции; добавь её в MCP и перезапусти, или вкинь сообщение сам"37```3839## Команды поиска4041- В Claude Code (с MCP) — `mcp list` или `mcp tools`.42- Внутри агентного контекста — функция `tool_search_tool_bm25` или `tool_search` по имени.43- Документации MCP-серверов — `~/.claude/mcp.json` или `.claude/mcp.json` в проекте.4445## Что искать по ключевым словам4647| Запрос упоминает | Поиск по |48|---|---|49| Slack | `slack`, `chat`, `message` |50| Notion | `notion`, `page`, `database` |51| Linear / Jira | `linear`, `jira`, `issue`, `ticket` |52| Google Drive | `drive`, `gdrive`, `gdocs` |53| Figma | `figma`, `design`, `frame` |54| GitHub | `github`, `repo`, `pr`, `pull request` |55| Email | `email`, `mail`, `smtp` |56| Calendar | `calendar`, `event` |57| Filesystem outside project | `file`, `bash`, `shell` |5859## Не повторяй ошибку дважды6061Если в одном чате уже искал и не нашёл — не зацикливайся: «не нашёл» один раз достаточно. Не делай tool_search на каждом сообщении.6263## Когда никакого MCP нет6465Спроси юзера: «Хочешь подключить MCP-сервер для X? Минимальный путь: <ссылка/команда>». Это полезнее, чем отказ.6667## Что MCP **обычно умеет**6869- Чтение содержимого (страницы, тикеты, файлы).70- Создание/обновление сущностей.71- Поиск.7273И **обычно не** умеет:74- Долгоживущие подписки на события.75- Сложные UI-актиш с кликами по конкретным кнопкам.76- Что-то требующее пользовательского OAuth-flow в моменте.