Таймаут MCP? Проверьте запись, прежде чем повторять

Почему таймаут не говорит, произошло ли изменение?

Ваш ИИ попросил инструмент сделать изменение и стал ждать. Ответа не пришло, и ИИ-приложение перестало ждать и сообщило об ошибке. Эта метка описывает ожидание, а не изменение. Если повторить уже сделанное изменение, появятся два тикета, две страницы или два сообщения.

Разработчики называют такое изменение записью. Возможны три варианта.

Спецификация MCP это предполагает. Клиент должен задавать таймаут для каждого запроса и, когда он истекает, отменить запрос и перестать ждать. Но отмена не даёт гарантии: сервер может её проигнорировать, если работа уже сделана или её нельзя остановить. Отмена может прийти и после отправки ответа.

В руководстве Stripe по API сказано то же: после сбоя соединения вы можете не знать, выполнился ли запрос. Там же советуют считать и ошибку сервера результатом с неизвестным исходом.

Что делать после таймаута, по порядку?

Делайте по порядку. Первые два шага занимают минуту.

1. Остановите повторСейчас

   Скажите ИИ не повторять вызов: «Не повторяйте. Сначала проверьте, было ли сделано изменение.» Повтор сам по себе — так изменение и делается дважды.

2. Смотрите в инструменте, а не в чате1 минута

   Откройте сам инструмент: страницу Notion, тикеты GitHub, папку. Поищите название или идентификатор, который вы запрашивали. Чат знает только, что вызов не удался.

3. Прочитайте, что нашли2 минуты

   Нашли, всё готово: изменение сделано. Продолжайте и не повторяйте его.
   Нашли, но сделано наполовину: доделайте недостающее обновлением, а не новым созданием.
   Не нашли: оно не дошло или всё ещё выполняется. Подождите минуту и посмотрите снова.

4. Повторите один раз и только безопасный вызовЗатем

   Если его всё ещё нет, повторите один раз. Таблица ниже показывает, какие вызовы безопасно повторять. Перед отправкой посмотрите, куда она попадёт.

5. Если таймаут повторяется, устраните причинуПотом

   Вызов, который всегда выходит по таймауту, упёрся в слишком короткий лимит или слишком большую задачу. Увеличьте лимит для этого сервера или просите за один вызов меньше.

Какие вызовы безопасно повторять?

Вызов безопасно повторять, когда два выполнения дают тот же результат, что и одно. Чтение подходит. Многие изменения — нет. Стандарт HTTP считает безопасными для повтора PUT (задать значение) и DELETE, и таблица ниже следует ему. Подсказка idempotentHint инструмента или его описание важнее них.

Может ли ключ идемпотентности остановить дубликат?

Иногда. Ключ идемпотентности — уникальная метка, которая отправляется вместе с запросом. Если одна и та же метка приходит дважды, сервис выполняет работу один раз и повторяет свой первый ответ. Его делают для запроса, на который не пришёл ответ.

• Как работает ключ в Stripe. Его API версии v1 принимает ключ в запросах POST. Он сохраняет первый результат, даже ошибку, и возвращает его снова при повторе с тем же ключом. Ключи хранятся не меньше 24 часов. Тот же ключ с другими параметрами отклоняется.
• Что должен делать повтор. Отправить тот же ключ и те же параметры. Stripe советует не повторять с новым ключом, пока вы не знаете исход первой попытки. Новый ключ на каждую попытку не защищает.
• Что даёт MCP. Запрос tools/call несёт имя инструмента и его аргументы. Схема спецификации не определяет для него ключ идемпотентности. Но инструмент может принять такой ключ как собственный аргумент, поэтому читайте его аргументы.
• Что может заявить инструмент. idempotentHint говорит, что повторный вызов с теми же аргументами не даёт дополнительного эффекта. Это только подсказка. Спецификация говорит, что клиенты никогда не должны опираться на подсказки от недоверенных серверов.

Поэтому ключ — бонус, а не план. Если инструмент его не предлагает, защищает проверка выше.

Как изменить таймаут MCP?

Слишком короткий лимит обрывает честную работу. Слишком длинный заставляет ждать. Где его задать, зависит от вашего ИИ-приложения. Вот настройки Claude Code.

60 секунд по умолчанию для удалённых серверов. Сервер, к которому подключаются по HTTP, SSE или как коннектор claude.ai, имеет второй таймер. Он работает на каждый запрос до первого байта ответа сервера. Длится 60 секунд, если только MCP_TOOL_TIMEOUT, timeout сервера или MCP_TIMEOUT не заданы больше. У локальных серверов stdio таймера на запрос нет.

Чтобы задать его для одного сервера, добавьте "timeout": 600000 в его запись в .mcp.json. Это десять минут.

Медленный вызов не всегда неудачный. С версии 2.1.212 Claude Code переводит вызов MCP в основном разговоре в фоновую задачу через две минуты. Результат он доставит, когда вызов закончится.

В документации MCP для Cursor настройки таймаута нет. Спецификация MCP не называет числа. Она говорит, что SDK должны позволять задавать таймауты для каждого запроса, а клиент всегда должен держать максимум.

Для работы, которая идёт минутами, сервер может использовать MCP Tasks. Он сразу возвращает дескриптор, а клиент опрашивает результат, даже после переподключения. Нужна поддержка с обеих сторон, а клиенты поддерживают её по-разному.

Что делает Delta MCP, когда ответ потерялся?

Delta MCP — бесплатное приложение на вашем компьютере, между вашим ИИ и его инструментами. Когда на изменение не приходит ответ, оно не угадывает и не повторяет вслепую. Оно перечитывает инструмент.

Прежде чем изменение уйдёт, Delta MCP выбирает чтение, которое может показать, произошло ли оно. Это чтение объекта или повторное чтение списка. Если ответа нет, он сразу выполняет это чтение. Решает то, что показало чтение:

Delta MCP не может откатить вызов, сделанный как есть. Если более ранний вызов удался, он остаётся сделанным, и ответ его перечисляет, чтобы ваш ИИ не повторил его. Каждая задача, которая что-то меняет, хранится в Activity с каждым изменением до и после.

Как задача проверяется и применяется