Ошибки и повторы MCP

Подключение и права

При отменённом OAuth или истёкшем согласии повторите вход в клиенте. Если клиент не находит сервер, проверьте точный HTTPS endpoint, настройки клиента, окружение API-ключа и доступность сети. 401 означает недействительный или просроченный доступ: войдите снова либо замените ключ. 403 означает недостаточный scope, роль, workspace или выключенную функцию: сверяйте конкретный код ошибки. Для расширения OAuth-scopes снова подключите клиент.

Повторы без дублей

Для новой изменяющей операции создайте UUID idempotencyKey, если его требует схема инструмента. При сетевом сбое повторяйте тот же ключ и те же параметры; для REST соответствует заголовок Idempotency-Key. Ключ с изменёнными параметрами может дать 409. После тайм-аута, HTTP 202 или UNKNOWN сначала проверьте statusUrl, operation ID и созданный ресурс. Новый UUID создаёт новую операцию, поэтому не используйте его для слепого повтора.

Статусы и квоты

400 — проверьте inputSchema, формат и ограничения файла. 404 — ресурс может быть удалён или принадлежать другому workspace. 409 — сверяйте состояние операции, ключ и файл. 429 — соблюдайте Retry-After; это может быть rate limit или лимит активных загрузок. 503 — проверьте состояние сервиса и повторите после восстановления тем же ключом. Недостаток тарифной функции или квоты отличается от частотного лимита: проверьте Billing и оставшийся период.

Повторы, ограничения и восстановление

MCP/OAuth доступен только при включённом MCP_ENABLED. Регистрация клиента ограничена 10/IP/час, 100/инстанс/час и 10 000 сохранённых клиентов; при недоступной защите возвращается 503. Неиспользуемая регистрация удаляется через 24 часа; активное подключение сохраняет клиента, затем применяется 30 дней неактивности. Подтверждение показывает аккаунт и права. Refresh-token evidence сохраняется до абсолютного срока действия.

Direct автоматически повторяется не более трёх сетевых попыток на операцию, включая повторную очередь. Задержки — 5 и 15 минут. Потерянный ответ означает UNKNOWN: сообщение могло дойти, поэтому каждая потенциально доставленная попытка расходует квоту. Доказанный отказ освобождает резерв. После трёх попыток проверьте переписку; последовательные дубли возможны. Старые неоднозначные резервы автоматически не освобождаются.

Аналитика читает сохранённые снимки; запрос страницы не вызывает Instagram. Очередь обновляет метрики не чаще одного раза в час с общим пределом четырёх одновременных запросов. По умолчанию страница содержит 50 записей, максимум 100; nextCursor открывает следующую страницу. Общие totals относятся ко всему набору. Дата обновления и признак неполных или устаревших данных помогают отличить отсутствие метрик от нуля.