429 Rate Limited: исправление ошибок «слишком много запросов»

Устраните ошибки лимита запросов MCP 429 с помощью стратегий повторов, решений для пакетной обработки и экспоненциальной задержки. Узнайте об уровнях лимитов запросов и лучших практиках, позволяющих не достигать лимитов.

Что такое лимиты запросов

Лимиты запросов предотвращают злоупотребления и обеспечивают справедливое использование API MCP. При превышении лимита вы получаете ошибку 429 и должны подождать, прежде чем делать новые запросы.

Уровни лимитов запросов

Частые причины

1. Плотные циклы без задержек

Вызов инструментов MCP в цикле без какой-либо паузы между запросами:

// ❌ ПЛОХО: нет задержки между запросами
for task_id in task_ids:
    update_task(task_id, status="done")
    // Сразу достигает лимита после 60 запросов

// ✅ ХОРОШО: добавьте задержку между запросами
for task_id in task_ids:
    update_task(task_id, status="done")
    sleep(100)  // задержка 100 мс = макс. 10 запр./сек

2. Параллельные запросы, превышающие лимит

Одновременное выполнение слишком большого числа параллельных запросов:

3. Отсутствие логики повторов

Когда вы достигаете лимита, немедленный повтор только ухудшает ситуацию:

Решения и лучшие практики

1. Реализуйте экспоненциальную задержку

def call_with_retry(func, max_retries=5):
    retry_count = 0
    base_delay = 1  // Начинаем с 1 секунды

    while retry_count 

2. Пакетные операции

3. Используйте заголовок Retry-After

response = make_request()
if response.status == 429:
    retry_after = response.headers.get('Retry-After', 60)
    print(f"Rate limited. Waiting {retry_after}s...")
    sleep(retry_after)
    // Повторить запрос

4. Оптимизируйте шаблоны запросов

Пример: массовое обновление с защитой от лимитов

import time

def bulk_update_tasks(task_ids, status):
    BATCH_SIZE = 10
    DELAY_BETWEEN_BATCHES = 1  // 1 секунда
    MAX_RETRIES = 5

    for i in range(0, len(task_ids), BATCH_SIZE):
        batch = task_ids[i:i+BATCH_SIZE]
        retry_count = 0

        while retry_count 

Мониторинг и предотвращение

Чек-лист быстрого исправления

Когда повышать уровень

Связанные разделы устранения неполадок