Перейти к основному содержанию
Krea предоставляет размещённый сервер Model Context Protocol (MCP) для агентов и помощников по написанию кода. Используйте его, когда хотите, чтобы MCP-совместимый клиент обращался к Krea напрямую, вместо того чтобы вручную писать API-запросы.
API-ключ для подключения не требуется. Добавьте https://api.krea.ai/mcp в качестве URL MCP-сервера, а затем войдите в свою учётную запись Krea через OAuth-процесс вашего клиента.

​
Параметры сервера

НастройкаЗначение
ТранспортStreamable HTTP
URLhttps://api.krea.ai/mcp
АутентификацияOAuth
Способ списания зависит от того, как вы аутентифицируетесь:
Метод аутентификацииИсточник биллинга
OAuthCompute-юниты вашей учётной записи Krea, в которую выполнен вход
API-токенОтдельный API-баланс вашего рабочего пространства

​
Аутентификация

Большинство MCP-клиентов используют OAuth автоматически. Когда клиент попросит вас подключиться, пройдите вход через браузер и авторизуйте Krea. Использование через OAuth списывается с вашей учётной записи Krea, в которую выполнен вход, и оплачивается compute-юнитами. Если ваш MCP-клиент не поддерживает OAuth, вы можете пройти аутентификацию с помощью API-токена:
Ключ заголовкаЗначение заголовка
AuthorizationBearer KREA_API_TOKEN
Замените KREA_API_TOKEN на токен, полученный на странице krea.ai/app/api/tokens. Создавать API-токены могут только владельцы и администраторы рабочего пространства. Использование через API-токен списывается с API-баланса вашего рабочего пространства — так же, как и прямые вызовы API. Подробнее об API-балансе см. в разделе API-ключи и биллинг.
Храните учётные данные MCP с API-токеном так же, как и сами API-ключи. Не размещайте в системах контроля версий файлы конфигурации MCP, содержащие реальные токены.

​
Claude Code

Выполните в терминале следующую команду: 
claude mcp add --transport http krea-ai https://api.krea.ai/mcp
Когда Claude Code попросит вас подключиться, войдите в свою учётную запись Krea. После добавления сервера перезапустите Claude Code или перезагрузите список MCP-серверов.

​
Codex

  1. Откройте Settings > MCP servers в Codex.
  2. Добавьте новый сервер.
  3. Выберите Streamable HTTP в качестве транспорта.
  4. Вставьте URL сервера:
https://api.krea.ai/mcp
  1. Сохраните сервер и войдите в свою учётную запись Krea, когда Codex попросит вас подключиться.

​
Cursor

Откройте палитру команд, найдите пункт Open MCP settings и добавьте в mcp.json следующую запись: 
{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}
После сохранения файла перезапустите Cursor, а затем войдите в свою учётную запись Krea, когда Cursor попросит вас подключиться.

​
Использование Krea через MCP

После подключения попросите своего агента вывести список моделей Krea или изучить схему конкретной модели перед генерацией. Идентификаторы моделей совпадают с путями API, используемыми в остальной документации для разработчиков, например image/krea/krea-2/medium или video/google/veo-3.1. Например: 
List the available Krea image models, then generate an image with Krea 2 using a 16:9 aspect ratio.
Если модель устарела, Krea возвращает метаданные об устаревании через механизм обнаружения моделей MCP. Рекомендации по миграции см. в разделе Устаревания.

​
Устранение неполадок

ПроблемаРешение
Сбой аутентификацииПереподключите MCP-сервер и заново пройдите OAuth-процесс Krea в браузере. Если вы используете API-токен, убедитесь, что заголовок имеет вид ровно Authorization: Bearer KREA_API_TOKEN и что токен не был отозван.
Клиент не может подключитьсяУбедитесь, что клиент настроен на Streamable HTTP и использует https://api.krea.ai/mcp.
Генерация отклоняется по причинам биллингаЕсли вы подключились через OAuth, проверьте количество compute-юнитов на вашей учётной записи Krea, в которую выполнен вход. Если вы подключились с API-токеном, пополните API-баланс на krea.ai/app/api.
Сбой вызова моделиПопросите агента изучить схему модели перед повторной попыткой. Запросы через MCP используют те же входные параметры модели, что и API.

​
Дальнейшие шаги

API-ключи и биллинг

Создавайте API-токены и управляйте API-балансом для запросов с токен-аутентификацией.

Интерактивная песочница

Опробуйте запросы в приложении Krea, прежде чем поручать их агенту.

Устаревания

Узнайте, как MCP передаёт метаданные о миграции моделей.

API моделей

Просматривайте схемы эндпоинтов и параметры моделей.