При подключении ИИ-ассистент автоматически вызывает метод tools/list у MCP-сервера. В рекомендуемом /mcp/v3 обычному пользователю сервер возвращает маленький набор meta-инструментов и пять прямых инструментов личной поддержки, включая read-only support_prepare_report. Он готовит очищенный черновик и ничего не отправляет; support_send_message разрешён только после явного согласия пользователя. Нужные инструменты Яндекс Директа, VK Ads, Авито Рекламы, LidFly и Пространств ИИ находит через search_tools. Если публичный API провайдера заведомо не поддерживает действие, поиск дополняет обычную ранжированную выдачу понятным capability_notice и безопасным следующим шагом, не скрывая легитимные инструменты смешанного запроса.
Верхнеуровневые meta-инструменты ИИ вызывает напрямую. Для внутреннего инструмента он получает схему через get_tool_schema, затем вызывает чтение через call_tool, а действия на запись — через call_write_tool. Детерминированный отказ VK сохраняется с очищенными кодом, путём и сообщением. Если VK не подтвердил исход создания кампании, ИИ проверяет тот же operation ID через прямой read-only get_write_operation_status: проверка делает только GET, а нужную остановку возвращает отдельным подтверждаемым next_write. Create при этом не повторяется. Если пользователь назвал кампанию, прямой вызов resolve_campaign_scope сначала ищет её в Пространствах; campaign write без проекта проходит только при однозначном preflight. Primary-кабинет Яндекс Директа выбирается через connection_id без выдуманного client_login.
Бухгалтерский контур из 44 инструментов для ИП и малого ООО на УСН «Доходы» подключается отдельно через /mcp/accounting и не входит в v3 или встроенный чат. Он принимает только пользовательские файлы, хранит их зашифрованно, считает подтверждённые отпуск и обычный больничный, ничего не отправляет в банки или ведомства и отделяет расчётные копии от XSD-проверенных и профессионально проверенных форм. Подключение и инструкции находятся в личном кабинете: Интеграции → Бухгалтерия. Подробнее о границах.
name
Уникальное имя инструмента для вызова
description
Подробное описание — что делает, когда использовать, что возвращает
inputSchema
JSON Schema параметров — Claude знает какие аргументы передать
annotations
Подсказки: только чтение, деструктивное действие и т.д.
// Ответ /mcp/v3 на tools/list
{
"tools": [
{
"name": "search_tools",
"description": "Поиск внутренних provider tools...",
"inputSchema": {
"properties": {
"query": { "type": "string" },
"provider": { "enum": ["yandex", "vk", "avito_ads", "lidfly", "workspace"] }
}
},
"annotations": {
"readOnlyHint": true
}
},
// get_tool_schema, call_tool, call_write_tool, get_methodology, get_provider_context, resolve_campaign_scope, subscription_status
]
}
