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
              list_projects
            

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

          

          

            

              KEY
              create_project
            

            
Новый проект под задачу — бесплатно и без списаний. Дальше агент передаёт его project_id в каждую генерацию, и вся работа лежит в одном месте. Проект с тем же названием переиспользуется, а не дублируется.

          

          

            

              KEY
              get_balance
            

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

          

        

      


      

        

          

            
Workflow

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

          

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

        

        

          

            01
            
Проект под задачу

            
create_project в начале работы: дальше project_id уходит в каждую генерацию, и вы открываете всю задачу одной ссылкой.

          

          

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

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

          

          

            03
            
Промпт по свежим практикам

            
get_model возвращает и блок prompt_research: что поискать в сети про промпты и референсы именно этой модели, прежде чем писать запрос.

          

          

            04
            
Цена до запуска

            
estimate_cost — точная сумма и разбор тарифа; через compare видно, как параметры двигают цену.

          

          

            05
            
Запуск и ожидание

            
create_generation, затем get_generation до готовности. Повторный запуск вместо опроса — вторая оплата.

          

          

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

            
Готовый файл уходит в следующую модель как gen:<id>, а view_url открывает работу в вашем проекте.

          

        

        

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

        

          

            

              

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

              

              
            

            

          

        

      


      

        

          

            
Notes

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

          

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

        

        

          

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

          

          

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

          

          

            Промпт под конкретную модель
            
Правила промптинга у каждой модели свои и меняются с каждым релизом, а агент помнит вчерашние. Поэтому get_model
              прямо просит его поискать актуальные практики — как формулировать запрос и как работают референсы именно у этой модели — и даёт
              готовые поисковые запросы. Ограничения карточки при этом главнее любого совета из сети.

          

          

            Где живут генерации
            
Каждая генерация лежит в проекте — том же, что и переписка в кабинете. Без project_id она попадёт в проект по
              умолчанию, вперемешку с вашими собственными работами. Агент видит историю через list_generations с фильтрами и
              поиском, возвращается к прошлой работе по gen:<id> и отдаёт вам view_url — ссылку на эту генерацию в кабинете.

          

          

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

          

          

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

          

          

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

          

          

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

          

          

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