Интеграция для разработчиков · Beta

Как подключить Cursor к NeuroAPI

Отдельный API-профиль для подключения Cursor: явный выбор модели и проверка функций, которые нужны в вашем проекте.

Короткий ответ

Краткий ответ

Настройка Cursor через ключ NeuroAPI и отдельный OpenAI-совместимый адрес: выбор модели, проверка чата и инструментов, ограничения BYOK.

Отдельный адрес

Используйте опубликованный профиль /v1/cursor.

Явная модель

Выбирайте точный ID и проверяйте доступ ключа.

Чат и инструменты

Проверьте простой ответ, вызов инструмента и следующий ход.

Границы BYOK

Tab и облачные режимы не входят в эту инструкцию.

Статус подключения

Профиль https://neuroapi.host/v1/cursor опубликован в API NeuroAPI 0.37.95 для OpenAI-совместимого подключения Cursor. На 27 сентября 2026 проверка настоящего Cursor с авторизованными запросами к рабочему API ещё не подтверждена. Перед рабочим использованием проверьте нужные вам режимы с вашим ключом и моделью.

Поддержка пользовательского Base URL зависит от версии и режима Cursor. Успешная проверка ключа ещё не подтверждает работу Agent, Plan или конкретной reasoning-модели: проверяйте каждый нужный сценарий отдельно.

Настройте ключ и модель

Создайте отдельный ключ NeuroAPI с нужными моделями и лимитом. В Cursor откройте Settings → Models, выберите настройку OpenAI API Key и укажите этот ключ. В Override OpenAI Base URL задайте https://neuroapi.host/v1/cursor и сохраните настройки.

Добавьте точный опубликованный ID модели NeuroAPI и выберите его явно в чате. Начните с модели, для которой доступны Chat Completions и вызовы инструментов. Не переименовывайте модель ради обхода проверки клиента: имя может влиять на выбранный им протокол.

Если в вашей версии Cursor нет Override Base URL или клиент отклоняет выбранную модель до запроса, одной настройкой API это не исправить. Проверьте актуальную документацию Cursor и версию приложения.

  • Base URL: https://neuroapi.host/v1/cursor — без /chat/completions на конце.
  • API Key: ключ NeuroAPI; модель: точный ID из вашего каталога.
  • Не используйте Auto для первой проверки: выберите модель вручную.
  • Override может влиять на другие OpenAI-модели в Cursor; сохраните прежнее значение, чтобы вернуться к нему.

Проверьте рабочий сценарий

Откройте небольшой тестовый проект без секретов. Сначала попросите объяснить один файл в Ask. Затем в Agent попросите прочитать файл и предложить небольшое изменение; проверьте вызов инструмента, его результат и продолжение ответа.

Отдельно проверьте Plan, применение правки и следующий ход разговора, если используете эти режимы. Сверьте расходы в кабинете NeuroAPI. Для диагностики сохраните версию Cursor, точный ID модели и код ошибки без ключа и содержимого проекта.

  • 401: проверьте ключ и доступ к API.
  • 404: проверьте Base URL и точный ID модели.
  • 400: проверьте поддерживаемые параметры, инструменты и размер контекста.
  • Чат отвечает, но Agent не работает: проверьте совместимость инструментов выбранной модели и режима клиента.

Что покрывает профиль

Профиль принимает Chat Completions и Responses. Для отдельных версий Cursor предусмотрено преобразование запросов с телом Responses на адресе Chat Completions. В этом режиме доступны текст, входные изображения и локально исполняемые инструменты; сохранённое состояние и серверные инструменты не преобразуются.

Интеграция не обещает поддержку всех reasoning-моделей: официальная BYOK-документация Cursor ограничивает OpenAI-раздел обычными chat-моделями. Фактическая совместимость проверяется для пары «версия Cursor + модель».

Tab использует встроенные модели Cursor. Эта настройка также не подтверждает подключение Cloud Agents, Composer или Cursor CLI. MCP может добавить инструменты и данные, но не заменяет настройку модели.

Куда передаётся ключ

По документации Cursor, BYOK-запросы проходят через его серверы для подготовки промпта. Ключ передаётся туда с каждым запросом по защищённому соединению; Cursor сообщает, что не сохраняет его после запроса.

Учитывайте правила обработки данных обеих сторон. Используйте отдельный ключ с подходящим лимитом и отзывайте его при завершении доступа. Для сетевых ограничений API учитывайте, что запрос может приходить с инфраструктуры Cursor, а не с IP вашего компьютера.