Model Context Protocol

MCP для ИИ-агентов

Подключите aiRetry к Claude, Cursor, Codex или любому другому MCP-клиенту — и агент сам найдёт модель, узнает цену, запустит генерацию изображения или видео и заберёт результат.

Ключи API Каталог моделей REST API
Streamable HTTP Claude Code / Desktop Cursor / VS Code Codex / Gemini CLI n8n
Endpoint

Один URL для всех клиентов. Транспорт — Streamable HTTP, без сессий и OAuth.

Авторизация Bearer

Тот же ключ, что и для REST API: заголовок Authorization: Bearer <ключ>. Если клиент не умеет заголовки — добавьте ?key=<ключ> к URL.

Quick Start

Три шага до первой генерации

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

03

Подключите агента

Скопируйте конфиг для вашего клиента из раздела ниже, подставьте ключ — агент увидит инструменты aiRetry.

Setup

Подключение популярных агентов

Во всех примерах замените sk-air-ВАШ_КЛЮЧ на свой ключ из настроек. Endpoint везде один: .

CLI

Claude Code


          

          

            

              

                .mcp.json в проекте
                
Claude Code (конфиг)

              

              
            

            

          

          

            

              

                Настройки → Коннекторы
                
Claude Desktop и claude.ai

              

              
            

            
В веб-версии и приложении Claude: Settings → Connectors → «Add custom connector». Заголовки там задать нельзя, поэтому ключ передаётся прямо в URL:

            

          

          

            

              

                claude_desktop_config.json
                
Claude Desktop (mcp-remote)

              

              
            

            

          

          

            

              

                ~/.cursor/mcp.json
                
Cursor

              

              
            

            

          

          

            

              

                .vscode/mcp.json
                
VS Code (Copilot)

              

              
            

            

          

          

            

              

                ~/.codeium/windsurf/mcp_config.json
                
Windsurf

              

              
            

            

          

          

            

              

                ~/.codex/config.toml
                
OpenAI Codex CLI

              

              
            

            

          

          

            

              

                ~/.gemini/settings.json
                
Gemini CLI

              

              
            

            

          

          

            

              

                Любой stdio-клиент
                
Универсально: mcp-remote

              

              
            

            
Если клиент поддерживает только локальные (stdio) серверы, используйте прокси mcp-remote:

            

          

        

        

          n8n:
          узел «MCP Client Tool» → Endpoint , транспорт HTTP Streamable, авторизация Header Auth со значением Bearer sk-air-ВАШ_КЛЮЧ.
        

      


      

        

          

            
Tools

            
Что умеет агент через MCP

          

          
Семь инструментов. Первые три работают без ключа — агент может изучить каталог и цены ещё до авторизации.

        

        

          

            

              FREE
              list_models
            

            
Каталог моделей с типом результата, издателем и ценой «от» в рублях. Фильтры по типу и поисковой строке.

          

          

            

              FREE
              get_model
            

            
Карточка модели: поля с типами и ограничениями, инструкция, пример промпта — и полная тарификация: модель оплаты, каждый тариф с условиями срабатывания, какие параметры двигают цену и базовая цена.

          

          

            

              FREE
              estimate_cost
            

            
Точная стоимость до запуска с разбивкой: что тарифицируется, сколько единиц и откуда взято количество, какой тариф сработал. Через compare — цены сразу нескольких вариантов параметров.

          

          

            

              KEY
              create_generation
            

            
Запуск генерации. Ждёт результат до 50 секунд, длинные видео возвращают статус для дальнейшего опроса.

          

          

            

              KEY
              get_generation
            

            
Статус и результат по id: ссылки на файлы, итоговая стоимость, ссылка gen:<id> для цепочек.

          

          

            

              KEY
              list_generations
            

            
Последние генерации пользователя: статусы, стоимость, ссылки на результаты.

          

          

            

              KEY
              get_balance
            

            
Баланс в рублях, ссылка на пополнение и отметка о принятых условиях использования.

          

        

      


      

        

          

            
Workflow

            
Как агент генерирует контент

          

          
Типовой сценарий, который агент выполняет сам — достаточно задачи вида «сделай постер к запуску».

        

        

          

            01
            
Выбор модели

            
list_models по типу задачи, затем get_model — поля, ограничения и инструкция.

          

          

            02
            
Цена и запуск

            
estimate_cost — точная сумма и разбор тарифа, можно сравнить варианты параметров. Затем create_generation.

          

          

            03
            
Результат и цепочки

            
get_generation до готовности; результат можно передать в следующую модель как gen:<id>.

          

        

        

          Проверка подключения без клиента:
          выполните запрос ниже — в ответе будет список инструментов.
        

        

          

            

              

                curl
                
Список инструментов

              

              
            

            

          

        

      


      

        

          

            
Notes

            
Практические замечания

          

          
Коротко о деньгах, файлах и ограничениях — это же агент получает в описаниях инструментов.

        

        

          

            Прогноз стоимости
            
Агент видит тариф целиком: за что берётся плата (секунды видео, токены, кадры), какой тариф сработал и почему.
              Если точное количество известно только после генерации, ответ помечается confidence: approximate
              и объясняет причину — в этом случае спишется большая из сумм: резерв или факт.

          

          

            Деньги и резерв
            
Стоимость резервируется с баланса при запуске и фиксируется по завершении. Неудачные генерации не оплачиваются — резерв возвращается.

          

          

            Долгие генерации
            
Видео может рендериться несколько минут. Агенту нужно опрашивать get_generation, а не создавать генерацию заново — повтор будет оплачен как новая.

          

          

            Файлы на вход
            
Поля-файлы принимают https-ссылки, data:-URI, gen:<id> прошлых генераций и id файлов из библиотеки. До 50 МБ: jpg, png, webp, heic, mp4, mov, webm, mp3, wav и другие.

          

          

            Условия использования
            
До первой генерации нужно один раз отметить галочку с условиями. Сделать это может только сам пользователь — агент увидит подсказку в ответе.

          

          

            Лимиты
            
До 20 запусков генераций в минуту на аккаунт. Опрос статуса не ограничен этим лимитом.

          

          

            Ключ в URL
            
Вариант ?key= существует для клиентов без поддержки заголовков. Такой URL — это и есть ваш ключ: не публикуйте его, а при утечке отзовите ключ в настройках.