Подключение Cursor к API Hubs

Попросите Cursor сделать иллюстрацию для страницы, короткое видео продукта или музыку для прототипа. Подключите API Hubs как MCP-сервер и продолжайте использовать привычную модель Cursor для работы с кодом.

Совместимые чат-запросы также можно направить через ключ API Hubs. Эти два подключения настраиваются отдельно.

Добавьте инструменты генерации

Нажмите Добавить в Cursor выше и проверьте адрес сервера перед установкой. Либо объедините этот фрагмент с .cursor/mcp.json в проекте, сохранив остальные серверы. Для всех проектов используйте ~/.cursor/mcp.json:

{
  "mcpServers": {
    "apihubs": {
      "url": "https://api.apihubs.ru/mcp"
    }
  }
}

Откройте настройки MCP в Cursor, включите сервер и запустите предложенный вход. В браузере войдите в API Hubs и проверьте запрошенные разрешения. В конфигурации нет API-ключа или секрета клиента; после подтверждения Cursor управляет учётными данными OAuth.

Используйте актуальный Cursor. Документация указывает адреса возврата http://localhost:8787/callback и https://www.cursor.com/agents/mcp/oauth/callback. Также поддерживается адрес десктопного клиента cursor://anysphere.cursor-mcp/oauth/callback. Ссылка установки cursor:// выше открывает приложение по другому адресу и не является адресом возврата OAuth.

Проверьте подключение без списания

Откройте новый чат Agent и попросите:

Через MCP-инструменты API Hubs вызови get_account и list_models.
Покажи мой баланс и три модели изображений. Не создавай генерацию.

Эти инструменты читают данные аккаунта и каталога без платного задания. Если инструменты недоступны, проверьте включение сервера, авторизацию и поддержку MCP-инструментов выбранным режимом Cursor.

Создайте иллюстрацию для страницы

Создай одну иллюстрацию для этой страницы: бумажный кораблик на дождливой
улице, вертикальная композиция, без надписей. Сначала проверь параметры
модели через get_model и вызови estimate_cost с итоговыми входными данными.
Покажи стоимость и дождись моего подтверждения перед create_generation.
Передай согласованную сумму как maxCostUsd и задай idempotencyKey для
этого задания. Дождись завершения через get_task и верни ссылку на файл.

Расчёт стоимости не создаёт задание. create_generation списывает баланс; maxCostUsd позволяет серверу отклонить запрос выше вашего предела. При повторной отправке того же задания после обрыва соединения используйте тот же ключ идемпотентности. Для нового результата нужен новый ключ.

Для входного файла попросите агента вызвать create_upload_url, загрузить байты через HTTP PUT и передать publicUrl модели. Для загрузки нужен инструмент HTTP наряду с MCP. Полученный taskId означает, что запрос принят; ссылку на готовый файл берите из завершённого задания.

Отозвать доступ можно в кабинете → Коннекторы. Инструменты, ограничения загрузки и права описаны в справочнике MCP.

Подключите чат-модель отдельно

Создайте API-ключ и откройте Cursor Settings → Models. В API Keys вставьте его в OpenAI API Key и включите использование ключа. Если версия предлагает Override OpenAI Base URL, укажите:

https://api.apihubs.ru/api/v1

Добавьте custom model с точным id из каталога чат-моделей или GET /api/v1/models. Выберите id, который не начинается с claude-: для этого префикса Cursor использует поле ключа Anthropic, поэтому настройка только OpenAI-ключа не авторизует такие модели. Включите модель и выберите её в новом чате. Начните с небольшого запроса и проверьте списание в кабинете.

API Hubs предоставляет /api/v1/chat/completions и /api/v1/messages. Эндпоинта /api/v1/responses нет. Режимы и модели Cursor, которым нужен Responses API, через этот base URL не работают. Успешный ответ в чате не подтверждает совместимость Agent. Для такого режима используйте MCP-инструменты генерации с привычной моделью Cursor для кода.

Свой ключ не заменяет Cursor Tab. Запросы со своим ключом проходят через серверы Cursor; учитывайте его условия обработки данных и тарифного плана. При возврате к встроенным моделям отключите свой ключ и base URL override, если запросы по-прежнему направляются в API Hubs.

Если подключение не работает

Источники: MCP в Cursor, ссылки установки, свои ключи и требования к протоколу Cursor. Также смотрите ответ поддержки Cursor о маршрутизации по имени модели.