MCP-сервер

CoreMind работает как MCP-сервер: агент в Claude, Cursor, Codex или любом другом клиенте Model Context Protocol сам выбирает модель, узнаёт цену, запускает генерацию и забирает результат. Инструменты — тонкая обёртка над теми же операциями /v1, поэтому цены, лимиты, области доступа и коды ошибок у них общие с REST API.

Подключение

Адрес сервера — https://api.coremind.ru/mcp, транспорт Streamable HTTP. Ключ не нужен: клиент сам откроет браузер, вы войдёте в CoreMind и отметите, что агенту можно делать.

Быстрее всего — попросить агента

Вставьте это в чат Claude Code, Cursor, Codex или другого агента:

Подключи MCP-сервер CoreMind: адрес https://api.coremind.ru/mcp, транспорт Streamable HTTP, вход через OAuth.
Если ты Claude Code — выполни: claude mcp add --transport http coremind https://api.coremind.ru/mcp --scope user
Если ты Cursor — добавь сервер "coremind" с полем "url": "https://api.coremind.ru/mcp" в файл mcp.json в папке .cursor моего домашнего каталога (~/.cursor/mcp.json на macOS и Linux, %USERPROFILE%\.cursor\mcp.json на Windows).
Если ты Codex — выполни в терминале: codex mcp add coremind --url https://api.coremind.ru/mcp (или дай мне эту команду, чтобы я выполнил её сам). Codex сам откроет вход в браузере; если вход не открылся, выполни codex mcp login coremind. Потом скажи мне перезапустить Codex.
Потом скажи мне, где нажать вход, а после входа вызови инструмент whoami и покажи, что мне доступно.

Claude Code

claude mcp add --transport http coremind https://api.coremind.ru/mcp --scope user

Затем в Claude Code откройте /mcp, выберите coremind и войдите.

Cursor

Добавьте сервер в mcp.json в папке .cursor домашнего каталога — ~/.cursor/mcp.json на macOS и Linux, %USERPROFILE%\.cursor\mcp.json на Windows. Cursor предложит войти при первом подключении:

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

Codex

codex mcp add coremind --url https://api.coremind.ru/mcp

Codex сам откроет вход в браузере. Если вход не открылся или нужно войти заново, выполните:

codex mcp login coremind

Codex CLI, расширение Codex для IDE и десктопное приложение ChatGPT используют одну конфигурацию MCP на одном компьютере (~/.codex/config.toml), поэтому сервер, добавленный в одном из них, виден в остальных. Уже запущенный сеанс Codex подхватит сервер после перезапуска.

По API-ключу

Для клиента без входа через браузер, скрипта или сервера выпустите ключ в профиле с областями нужных инструментов и передайте его в заголовке:

{
  "mcpServers": {
    "coremind": {
      "type": "http",
      "url": "https://api.coremind.ru/mcp",
      "headers": { "Authorization": "Bearer cmk_…" }
    }
  }
}

Codex хранит те же настройки в ~/.codex/config.toml и берёт ключ из переменной окружения COREMIND_API_KEY, поэтому сам ключ в файл не попадает:

[mcp_servers.coremind]
url = "https://api.coremind.ru/mcp"
bearer_token_env_var = "COREMIND_API_KEY"

Вход через браузер выдаёт токен только для /mcp; токен, выданный приложению для /v1, здесь не принимается. Сессионная кука не подходит ни в каком виде. Свойства ключа и ошибки аутентификации — на странице Аутентификация, вход через браузер подробно — на странице OAuth для приложений.

Сервер понимает обе версии протокола — рукопожатие 2025 года и современное — на одном адресе и не держит сессий: каждый запрос самодостаточен.

Инструменты

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

У каждого инструмента есть MCP-аннотации: чтение помечено как безопасное, generate и workflow_run — как тратящие кредиты, а cancel_generation, workflow_delete и library_folder_delete — как необратимые. Клиент, который спрашивает подтверждение перед опасными действиями, видит это без разбора имён.

Кредиты и месячный лимит

Списывают только generate и запуск цепочки в workflow_run. Для этого у аккаунта должен быть активный платный тариф — прошлые оплаты не считаются, — иначе ответ payment_required. Точный повтор уже принятого запроса с тем же ключом идемпотентности возвращает прежний ответ и без тарифа.

У ключа и у приложения, подключённого через вход, может быть месячный лимит в кредитах. Ключу его задают в профиле при создании и меняют там же, приложению — в профиле, в разделе «Доступ приложений». Сколько потрачено и когда сброс, показывают whoami и estimate_price в поле spend_limit. Все суммы в ответах инструментов — в кредитах, как на сайте, в полях с окончанием _credits; REST API те же суммы отдаёт в сантикредитах (_cc). Запрос, который вышел бы за лимит, получает key_spend_limit_reached (у приложения — grant_spend_limit_reached) с остатком и датой сброса и ничего не списывает.

Свои файлы-референсы

Картинку или видео по публичной ссылке агент передаёт в генерацию напрямую. Файл с вашего компьютера сначала загружается: агент получает адрес через create_upload и отправляет на него файл сам, обычной командой в терминале. Так работают агенты с доступом к терминалу — Claude Code, Codex, агент Cursor. Клиент без терминала передаёт файл прямо в вызове: upload_file принимает его байты как base64. Файл, который уже лежит в вашей библиотеке, загружать не нужно: его передают как library:<id>. Результат прошлой генерации передают той ссылкой, которую вернул get_status, — сервер сам найдёт по ней файл.

Забрать результат

get_output возвращает сам файл готовой генерации или загруженного референса. Картинка и аудио приходят прямо в ответе инструмента. Видео, 3D-модель, другие файлы и всё, что не помещается в ответ, приходят ссылкой на /v1: скачать по ней можно с тем же заголовком Authorization, с которым клиент ходит в MCP-сервер, — API-ключом или токеном, полученным при входе.