Dashboard

Cursor

Connect Cursor to the iCreat API

Cursor is an AI-powered code editor with Chat, Agent, Composer, and more. It understands your codebase, edits files, and runs terminal commands. With iCreat's OpenAI-compatible endpoint, you can use platform models in Cursor with a single iCreat API Key—no separate vendor keys required.

Capabilities

  • Chat and Agent — Ask questions, plan features, fix bugs, and review changes in the editor
  • Composer / Plan Mode — Multi-file edits and multi-step task orchestration
  • MCP extensions — Connect external tools and data sources (optional iCreat MCP)
  • OpenAI-compatible routing — Point Override Base URL at iCreat and switch models by ID

How it connects

Cursor connects to iCreat through OpenAI API Key and Override OpenAI Base URL under Settings → Models. iCreat's LLM endpoint speaks the OpenAI Chat Completions protocol, so Cursor sends chat traffic to iCreat.

Setting Value
OpenAI API Key Your iCreat API Key (<sk-your-token>)
Override OpenAI Base URL https://api.icreat.ai/v1/llm
Model name Add manually in Cursor; must exactly match the iCreat model ID

Note

Tab completion (Cursor Tab) usually uses Cursor's subscription model pool and may not use this custom endpoint. This guide focuses on Chat / Agent / Composer.

Before you start

  • An API Key created on iCreat (replace <sk-your-token> below)
  • Cursor installed (macOS / Windows / Linux)
  • Network access to https://api.icreat.ai
  • The target model ID from the Model Plaza, and an API Key group that includes that model

Configure Cursor

Open model settings

  1. Launch Cursor and sign in if needed
  2. Open settings: macOS Cmd + Shift + J, Windows / Linux Ctrl + Shift + J
  3. Go to the Models tab

You can also use Cursor → Settings → Models.

Enter API details

  1. Enable OpenAI API Key and paste your iCreat API Key
  2. Enable Override OpenAI Base URL
  3. Set the base URL to:
https://api.icreat.ai/v1/llm
  1. If a Verify button is shown, click it to confirm the connection

Note

  • Enter the host root only—do not append /chat/completions; Cursor adds paths automatically
  • Even when not using OpenAI models directly, keep OpenAI API Key enabled; Cursor uses it to authenticate to iCreat

Add models

Cursor does not auto-discover iCreat models. Add them manually:

  1. In the Models panel, click Add model (or +)
  2. Enter the model ID from iCreat (for example gpt-5.5, deepseek-chat, etc.—check your console or docs)
  3. Select the model from the Chat / Composer dropdown

Tip

The model ID must match iCreat exactly, including case and prefixes. See the Model Plaza for available IDs.

Verify the connection

  1. Open Chat or Composer and select the model you added
  2. Send a test message, for example: Reply with "Cursor is connected to iCreat!"
  3. Confirm the call appears in Usage Logs in the iCreat console
  • iCreat only: disable unused built-in Cursor models in the Models list to avoid selecting the wrong one
  • Connection errors: open Settings → Network and try HTTP Compatibility Mode (some gateways have incomplete HTTP/2 support)
  • Avoid key conflicts: if Anthropic or Google keys are also configured, chat may not route through iCreat; prefer the OpenAI custom endpoint path only

Configuration reference

Setting Description
OpenAI API Key Your iCreat API Key; Cursor sends it as OpenAI BYOK to iCreat
Override OpenAI Base URL iCreat LLM endpoint: https://api.icreat.ai/v1/llm
Model ID Model identifier on iCreat; must be added manually in Cursor

Optional: iCreat MCP

To query iCreat capabilities via MCP in Cursor, add an HTTP MCP server:

  • Name: icreat-api-mcp (or custom)
  • URL: https://icreat.ai/mcp

The exact path is under Settings → MCP in your Cursor version.

FAQ

"Model not found" or the model is unavailable?

  • Confirm you added the model ID under Add model in the Models panel
  • Confirm your API Key group includes that model
  • Check that the ID matches iCreat docs exactly (no extra spaces or wrong prefix)

401 Unauthorized or connection failures?

  • Verify the API Key is valid and not expired
  • Confirm the base URL is https://api.icreat.ai/v1/llm (including /v1/llm)
  • Try enabling HTTP Compatibility Mode and retry

Override Base URL keeps turning on or settings do not stick?

  • Clear the Base URL field → turn the toggle off → fully quit Cursor (macOS Cmd + Q) → reopen and reconfigure
  • Close extra Cursor windows and change settings in a single instance
  • If it persists, remove the API Key, restart Cursor, then add the key again

Tab completion is not using iCreat?

Cursor Tab usually uses subscription models, separate from OpenAI Base URL override. For unified billing and model source, rely on Chat / Agent / Composer.

How do I confirm traffic goes through iCreat?

After a successful reply, check Usage Logs in the iCreat console for token consumption.