Point Cursor at your organization’s AI Gateway and add your models by name.
With an AI Gateway API key you can use the
models your organization gives you in Cursor’s chat and agent. Requests go
through AI Gateway like any other: the key only reaches models you’re allowed,
and usage counts toward your limit.Your organization needs Allow 3rd party tools & harnesses turned on, and
Cursor setup available.
Create a key in My Library › Models and pick Cursor under Start using
this key: it shows everything to paste, with your key filled in. Already have
a key? Open Set up Cursor in the same section.
Create an API key. Select Create key, name it (Cursor on my laptop)
and copy it. It’s shown once.
Point Cursor at OpenWork. In Cursor, open Settings › Models › API
Keys. Turn on OpenAI API Key and paste your key. Turn on Override
OpenAI Base URL and paste the base URL from the page. It ends in
/api/v1/cursor.
Add your models. Choose a model on the page and copy its name, for
example openwork/claude-opus-5.5-k3f9. In Cursor’s Models settings,
select Add model and paste it. Repeat for each model you want.
Pick a model and run locally. Open Cursor’s model picker, select one you
added, and run the agent on This Mac (Local), not in the Cloud.
Use Cursor’s Local mode. Cursor’s cloud agents don’t work with OpenWork
models yet: a prompt sent to the Cloud fails. Choose This Mac under the
prompt box before you send.
The base URL must end in /api/v1/cursor, not /api/v1. The Cursor address
answers in the formats Cursor expects for every model, including Claude and
Gemini models.
Cursor has one field per model, used both as its id and as the name it shows.
OpenWork gives each of your models a short name for it:
openwork/<model name>-<4 characters>
The four characters tell apart models with the same name, for example the same
model from two providers. Copy names from the page rather than typing them.
Cursor doesn’t send a thinking level for models added this way, so the level is
part of the name. On the page, choose a level next to a model and copy the name
it shows:
openwork/claude-opus-5.5-k3f9:high
Without a level, the model uses its provider’s default. To switch between
levels in Cursor, add the same model once per level.
Tab completions and Cursor’s own models keep using your Cursor plan.
Cursor calls the base URL from its own servers. A self-hosted AI Gateway
has to be reachable from the internet for Cursor to use it. If it isn’t,
Cursor says the model you selected isn’t available.
While the override is on, Cursor sends its OpenAI models to the base URL too.
Only the names from the page work there.
The key was revoked, has expired, or 3rd party tools are off for your organization. Check it in My Library › Models.
invalid_cursor_model
The model name isn’t an OpenWork one. Copy it again from Set up Cursor.
model_not_found
You no longer have that model. Open Set up Cursor to see your current models.
A prompt fails in a cloud agent
Switch the agent to This Mac (Local). Cloud agents don’t work with OpenWork models yet.
unsupported_thinking_level
That model doesn’t have the level in the name. Copy the name again with a level from the page.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OpenWork Docs","colors":{"primary":"#011627","light":"#cbd5e1","dark":"#011627"},"logo":{"light":"https://mintcdn.com/differentai/bbTblqmGCwQ9TUdJ/logo/light.svg?fit=max\u0026auto=format\u0026n=bbTblqmGCwQ9TUdJ\u0026q=85\u0026s=4467903d12836ac81ccb6eef9dbe7bde","dark":"https://mintcdn.com/differentai/bbTblqmGCwQ9TUdJ/logo/dark.svg?fit=max\u0026auto=format\u0026n=bbTblqmGCwQ9TUdJ\u0026q=85\u0026s=104602207077f80bd2961c67c80dfcf4"},"favicon":"https://mintcdn.com/differentai/bbTblqmGCwQ9TUdJ/logo/light.svg?fit=max\u0026auto=format\u0026n=bbTblqmGCwQ9TUdJ\u0026q=85\u0026s=4467903d12836ac81ccb6eef9dbe7bde","api":{"openapi":"https://api.openworklabs.com/openapi.json?public=1"},"background":{"color":{"light":"#ffffff","dark":"#011627"}},"navbar":{"primary":{"type":"button","label":"Download OpenWork","href":"https://openworklabs.com/download"}},"seo":{"metatags":{"og:image":"https://openworklabs.com/docs/images/openwork-social.png","og:image:alt":"OpenWork — Your AI workspace. Without vendor lock-in.","twitter:image:alt":"OpenWork — Your AI workspace. Without vendor lock-in."}},"errors":{"404":{"redirect":false,"title":"Missing Documentation?","description":"If you're technical and want to use a specific part of the app that is not documented well yet, [send us a quick email](mailto:team@openworklabs.com?subject=missing%20documentation\u0026body=hey%20my%20github%20is%20%7Busername%7D%2C%20I%27m%20interested%20in%20%7Bfeature%7D%20from%20openwork%20but%20I%27m%20missing%20documentation%20on%20it%2C%20could%20you%20create%20it%3F%0A%0AThanks) and tell us what you're missing."}},"markdown":{"instructions":["For agents: install the OpenWork desktop app with `brew install --cask openwork` (macOS) or from https://openworklabs.com/download. Do not run `npx openwork`; the npm package named `openwork` is a different project.","Connect an agent to OpenWork with the MCP Gateway: `claude mcp add --transport http openwork https://api.openworklabs.com/mcp/agent`. Teams sign up at https://app.openworklabs.com?mode=sign-up.","Step-by-step agent guide: https://openworklabs.com/docs/start-here/use-openwork-from-an-ai-agent.md","Connect Slack (any organization admin): https://openworklabs.com/docs/slack/connect-slack.md. OpenWork in Slack (@openwork bot) is private alpha for approved organizations. Setup guide: https://openworklabs.com/docs/slack/overview.md. Agent skill: https://openworklabs.com/.well-known/agent-skills/set-up-openwork-slack/SKILL.md."]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"differentai","hasAudioNarration":false,"actualSubdomain":"differentai","customDomains":["openworklabs.com"],"gitSource":{"type":"github","owner":"different-ai","repo":"openwork","deployBranch":"dev","contentDirectory":"packages/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af3acafc81e7498b331d7ed","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API","count":673},{"language":"default","tag":"Capability Sources","count":86},{"language":"default","tag":"Inference Providers","count":59},{"language":"default","tag":"Admin","count":51},{"language":"default","tag":"Organizations","count":47},{"language":"default","tag":"SSO","count":46},{"language":"default","tag":"Desktop App","count":30},{"language":"default","tag":"Authentication","count":30},{"language":"default","tag":"Connectors","count":30},{"language":"default","tag":"MCP Gateway","count":27}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#topbar-cta-button>a[href=\"https://openworklabs.com/download\"]{padding-right:0.75rem}#topbar-cta-button>a[href=\"https://openworklabs.com/download\"]>div>svg[aria-hidden=\"true\"]{display:none}body:has(.docs-intro) #header{display:none}#content-area h1,#content-area h2,#content-area h3,#content-area h4{color:#011627;letter-spacing:-0.025em}.docs-intro{padding:8px 0 32px;margin-bottom:32px;border-bottom:1px solid #e5e7eb}#content-area .docs-eyebrow{margin:0 0 16px;color:#4b5563;font-family:ui-monospace, SFMono-Regular, Menlo, monospace;font-size:11px;line-height:1.6;letter-spacing:0.1em;text-transform:uppercase}#content-area .docs-intro h1,#content-area .docs-intro .docs-hero-title{margin:0;max-width:680px;font-size:clamp(2.25rem, 4vw, 3rem);font-weight:500;line-height:1.12;letter-spacing:-0.045em;text-wrap:balance}#content-area .docs-lead{margin:20px 0 24px;color:#4b5563;font-size:18px;line-height:1.65}#content-area .docs-section-title{margin:0 0 16px;font-size:clamp(1.75rem, 3vw, 2.25rem);font-weight:500;line-height:1.2;scroll-margin-top:150px}.docs-actions{display:flex;flex-wrap:wrap;gap:12px}#content-area .docs-actions a{display:inline-flex;align-items:center;justify-content:center;min-height:44px;padding:10px 20px;border:1px solid #e5e7eb;border-radius:999px;color:#011627;background:#f0f4f9;font-size:15px;font-weight:500;text-decoration:none}#content-area .docs-actions a:first-child{color:#ffffff;background:#011627;border-color:#011627}#content-area .docs-actions a:hover{opacity:0.85}#content-area .card{background:#f8fafc;border-color:#e5e7eb}a:focus-visible,button:focus-visible{outline:2px solid #011627;outline-offset:4px}@media (max-width: 1023px){#content-area a[aria-label=\"Navigate to header\"]{margin-left:-16px;width:16px}#content-area a[aria-label=\"Navigate to header\"]>div{width:16px;height:24px}}.dark #content-area :is(h1,h2,h3,h4),.dark #content-area :is(.docs-lead,.docs-eyebrow){color:#e2e8f0}.dark .docs-intro{border-color:#334155}.dark #content-area .docs-actions a{color:#e2e8f0;background:#172b3b;border-color:#475569}.dark #content-area .docs-actions a:first-child{color:#011627;background:#e2e8f0}.dark #content-area .card{background-color:#0b1e30;border-color:#334155}.dark :is(a,button):focus-visible{outline-color:#e2e8f0}a[href^=\"https://www.mintlify.com\"][href*=\"utm_campaign=poweredBy\"]{color:#4b5563}.dark a[href^=\"https://www.mintlify.com\"][href*=\"utm_campaign=poweredBy\"]{color:#cbd5e1}"}],"page":{"pagePath":"ai-gateway/cursor","slug":"/ai-gateway/cursor","pageMetadata":{"title":"Use Cursor with AI Gateway","description":"Point Cursor at your organization's AI Gateway and add your models by name.","keywords":["Cursor","Override OpenAI Base URL","custom model","AI Gateway API key","3rd party tools"],"href":"/ai-gateway/cursor"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Point Cursor at your organization’s AI Gateway and add your models by name.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`With an `,_jsx(_components.a,{href:`/ai-gateway/third-party-tools`,children:`AI Gateway API key`}),` you can use the\nmodels your organization gives you in Cursor’s chat and agent. Requests go\nthrough AI Gateway like any other: the key only reaches models you’re allowed,\nand usage counts toward your limit.`]}),`\n`,_jsxs(_components.p,{children:[`Your organization needs `,_jsx(_components.strong,{children:`Allow 3rd party tools \u0026 harnesses`}),` turned on, and\nCursor setup available.`]}),`\n`,_jsx(Heading,{level:`2`,id:`set-it-up`,children:`Set it up`}),`\n`,_jsxs(_components.p,{children:[`Create a key in `,_jsx(_components.strong,{children:`My Library › Models`}),` and pick `,_jsx(_components.strong,{children:`Cursor`}),` under `,_jsx(_components.strong,{children:`Start using\nthis key`}),`: it shows everything to paste, with your key filled in. Already have\na key? Open `,_jsx(_components.strong,{children:`Set up Cursor`}),` in the same section.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Create an API key.`}),` Select `,_jsx(_components.strong,{children:`Create key`}),`, name it (`,_jsx(_components.code,{children:`Cursor on my laptop`}),`)\nand copy it. It’s shown once.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Point Cursor at OpenWork.`}),` In Cursor, open `,_jsx(_components.strong,{children:`Settings › Models › API\nKeys`}),`. Turn on `,_jsx(_components.strong,{children:`OpenAI API Key`}),` and paste your key. Turn on `,_jsx(_components.strong,{children:`Override\nOpenAI Base URL`}),` and paste the base URL from the page. It ends in\n`,_jsx(_components.code,{children:`/api/v1/cursor`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Add your models.`}),` Choose a model on the page and copy its name, for\nexample `,_jsx(_components.code,{children:`openwork/claude-opus-5.5-k3f9`}),`. In Cursor’s `,_jsx(_components.strong,{children:`Models`}),` settings,\nselect `,_jsx(_components.strong,{children:`Add model`}),` and paste it. Repeat for each model you want.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Pick a model and run locally.`}),` Open Cursor’s model picker, select one you\nadded, and run the agent on `,_jsx(_components.strong,{children:`This Mac`}),` (Local), not in the Cloud.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Use Cursor’s `,_jsx(_components.strong,{children:`Local`}),` mode. Cursor’s cloud agents don’t work with OpenWork\nmodels yet: a prompt sent to the Cloud fails. Choose `,_jsx(_components.strong,{children:`This Mac`}),` under the\nprompt box before you send.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The base URL must end in `,_jsx(_components.code,{children:`/api/v1/cursor`}),`, not `,_jsx(_components.code,{children:`/api/v1`}),`. The Cursor address\nanswers in the formats Cursor expects for every model, including Claude and\nGemini models.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`model-names`,children:`Model names`}),`\n`,_jsx(_components.p,{children:`Cursor has one field per model, used both as its id and as the name it shows.\nOpenWork gives each of your models a short name for it:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`openwork/\u003cmodel name>-\u003c4 characters>`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`The four characters tell apart models with the same name, for example the same\nmodel from two providers. Copy names from the page rather than typing them.`}),`\n`,_jsx(Heading,{level:`2`,id:`thinking-level`,children:`Thinking level`}),`\n`,_jsx(_components.p,{children:`Cursor doesn’t send a thinking level for models added this way, so the level is\npart of the name. On the page, choose a level next to a model and copy the name\nit shows:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`openwork/claude-opus-5.5-k3f9:high`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Without a level, the model uses its provider’s default. To switch between\nlevels in Cursor, add the same model once per level.`}),`\n`,_jsx(Heading,{level:`2`,id:`good-to-know`,children:`Good to know`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tab completions`}),` and Cursor’s own models keep using your Cursor plan.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cursor calls the base URL from its own servers.`}),` A self-hosted AI Gateway\nhas to be reachable from the internet for Cursor to use it. If it isn’t,\nCursor says the model you selected isn’t available.`]}),`\n`,_jsx(_components.li,{children:`While the override is on, Cursor sends its OpenAI models to the base URL too.\nOnly the names from the page work there.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`when-it-doesn’t-work`,children:`When it doesn’t work`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Cursor shows`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_api_key`})}),_jsxs(_components.td,{children:[`The key was revoked, has expired, or 3rd party tools are off for your organization. Check it in `,_jsx(_components.strong,{children:`My Library › Models`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_cursor_model`})}),_jsxs(_components.td,{children:[`The model name isn’t an OpenWork one. Copy it again from `,_jsx(_components.strong,{children:`Set up Cursor`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`model_not_found`})}),_jsxs(_components.td,{children:[`You no longer have that model. Open `,_jsx(_components.strong,{children:`Set up Cursor`}),` to see your current models.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A prompt fails in a cloud agent`}),_jsxs(_components.td,{children:[`Switch the agent to `,_jsx(_components.strong,{children:`This Mac`}),` (Local). Cloud agents don’t work with OpenWork models yet.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unsupported_thinking_level`})}),_jsx(_components.td,{children:`That model doesn’t have the level in the name. Copy the name again with a level from the page.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Use Cursor with AI Gateway","description":"Point Cursor at your organization's AI Gateway and add your models by name.","keywords":["Cursor","Override OpenAI Base URL","custom model","AI Gateway API key","3rd party tools"],"href":"/ai-gateway/cursor"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Set it up","slug":"set-it-up","depth":2,"children":[]},{"title":"Model names","slug":"model-names","depth":2,"children":[]},{"title":"Thinking level","slug":"thinking-level","depth":2,"children":[]},{"title":"Good to know","slug":"good-to-know","depth":2,"children":[]},{"title":"When it doesn’t work","slug":"when-it-doesn’t-work","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"differentai","siteName":"OpenWork Docs","title":"Use Cursor with AI Gateway - OpenWork Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T22:28:32.762Z","originalFileLocation":"ai-gateway/cursor.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Point Cursor at your organization\u0026#x27;s AI Gateway and add your models by name.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenWork Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Use Cursor with AI Gateway - OpenWork Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Point Cursor at your organization\u0026#x27;s AI Gateway and add your models by name.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenWork Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://openworklabs.com/docs/ai-gateway/cursor\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openworklabs.com/docs/images/openwork-social.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Use Cursor with AI Gateway - OpenWork Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Point Cursor at your organization\u0026#x27;s AI Gateway and add your models by name.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openworklabs.com/docs/images/openwork-social.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenWork Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#011627\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"OpenWork — Your AI workspace. Without vendor lock-in.\">\u003cmeta data-mint-head name=\"twitter:image:alt\" content=\"OpenWork — Your AI workspace. Without vendor lock-in.\">\u003clink data-mint-head rel=\"canonical\" href=\"https://openworklabs.com/docs/ai-gateway/cursor\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ai-gateway/cursor.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://openworklabs.com/#organization\",\"name\":\"OpenWork Docs\",\"url\":\"https://openworklabs.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/differentai/bbTblqmGCwQ9TUdJ/logo/light.svg?fit=max\u0026auto=format\u0026n=bbTblqmGCwQ9TUdJ\u0026q=85\u0026s=4467903d12836ac81ccb6eef9dbe7bde\"}},{\"@type\":\"WebSite\",\"@id\":\"https://openworklabs.com/docs#website\",\"name\":\"OpenWork Docs\",\"url\":\"https://openworklabs.com/docs\",\"publisher\":{\"@id\":\"https://openworklabs.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://openworklabs.com/docs/ai-gateway/cursor#webpage\",\"url\":\"https://openworklabs.com/docs/ai-gateway/cursor\",\"name\":\"Use Cursor with AI Gateway\",\"description\":\"Point Cursor at your organization's AI Gateway and add your models by name.\",\"dateModified\":\"2026-11-10T22:28:32.762Z\",\"isPartOf\":{\"@id\":\"https://openworklabs.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://openworklabs.com/docs/ai-gateway/cursor#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://openworklabs.com/docs/ai-gateway/cursor#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Overview\",\"item\":\"https://openworklabs.com/docs/ai-gateway/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Use Cursor with AI Gateway\",\"item\":\"https://openworklabs.com/docs/ai-gateway/cursor\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://openworklabs.com/docs/ai-gateway/cursor#article\",\"headline\":\"Use Cursor with AI Gateway\",\"name\":\"Use Cursor with AI Gateway\",\"description\":\"Point Cursor at your organization's AI Gateway and add your models by name.\",\"url\":\"https://openworklabs.com/docs/ai-gateway/cursor\",\"mainEntityOfPage\":{\"@id\":\"https://openworklabs.com/docs/ai-gateway/cursor#webpage\"},\"image\":\"https://openworklabs.com/docs/images/openwork-social.png\",\"dateModified\":\"2026-11-10T22:28:32.762Z\",\"keywords\":\"Cursor, Override OpenAI Base URL, custom model, AI Gateway API key, 3rd party tools\",\"publisher\":{\"@id\":\"https://openworklabs.com/#organization\"},\"isPartOf\":{\"@id\":\"https://openworklabs.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenWork Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OpenWork Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/ai-gateway/cursor.md","siteName":"OpenWork Docs","nav":{"global":null,"tabs":[{"tab":"Start here","pages":[{"title":"Start here","href":"/start-here/get-started"}]},{"tab":"Desktop App","pages":[{"title":"Desktop App","href":"/desktop-app/first-task"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"Slack","pages":[{"title":"Slack","href":"/slack/connect-slack"}]},{"tab":"AI Gateway","pages":[{"group":"Overview","pages":[{"title":"AI Gateway","sidebarTitle":"Overview","href":"/ai-gateway/overview"},{"title":"OpenWork Models","href":"/ai-gateway/openwork-models"},{"title":"Users and teams","href":"/ai-gateway/users-and-teams"},{"title":"AI Gateway API keys","description":"Let members create their own AI Gateway API keys to use your organization's models from 3rd party tools and harnesses, and manage those keys.","href":"/ai-gateway/third-party-tools"},{"title":"Use Cursor with AI Gateway","href":"/ai-gateway/cursor"},{"title":"Use Claude Code with AI Gateway","description":"Point Claude Code at your organization's AI Gateway with a project settings file, and use your models, Claude or not.","href":"/ai-gateway/claude-code"},{"title":"Provider support","href":"/ai-gateway/provider-support"},{"title":"AI Gateway vs LiteLLM vs Bifrost","sidebarTitle":"Compare: LiteLLM and Bifrost","href":"/ai-gateway/compare-litellm-bifrost"},{"title":"Use your LiteLLM proxy","href":"/ai-gateway/litellm"},{"title":"How a prompt reaches a model","sidebarTitle":"How requests flow","href":"/ai-gateway/how-requests-flow"},{"title":"Smart Model Router","href":"/ai-gateway/auto-model-routing"},{"title":"Google Agent Platform (Vertex AI)","href":"/ai-gateway/google-agent-platform"},{"title":"Amazon Bedrock","href":"/ai-gateway/amazon-bedrock"},{"title":"Microsoft Foundry","href":"/ai-gateway/microsoft-foundry"}]},{"group":"Providers for your org","pages":[{"title":"Adding a managed LLM provider","href":"/cloud/share-with-your-team/managed-llm-provider"},{"title":"Adding a custom LLM provider","href":"/cloud/share-with-your-team/custom-llm-provider"},{"title":"Per-member LLM credentials","href":"/cloud/share-with-your-team/per-member-llm-credentials"},{"title":"TrueFoundry: a key for each member","href":"/cloud/share-with-your-team/truefoundry-per-member-keys"}]},{"group":"Usage and cost","pages":[{"title":"Overview tab: spend and usage","sidebarTitle":"Overview tab","href":"/ai-gateway/usage-dashboard"},{"title":"Counting usage","href":"/ai-gateway/counting-usage"},{"title":"Token Costs","href":"/ai-gateway/token-costs"},{"title":"Limits","href":"/ai-gateway/limits"},{"title":"What uses tokens","href":"/start-here/do-work-with-it/what-uses-tokens"}]}]},{"tab":"MCP Gateway","pages":[{"title":"MCP Gateway","href":"/cloud/run-in-the-cloud/cloud-mcp"}]},{"tab":"Dashboards","pages":[{"title":"Dashboards","href":"/dashboards/overview"}]},{"tab":"SSO","pages":[{"title":"SSO","href":"/cloud/get-started"}]},{"tab":"Self-host","pages":[{"title":"Self-host","href":"/start-here/self-host"}]},{"tab":"API","pages":[{"title":"API","href":"/api-reference/system/check-den-api-health"}]},{"tab":"Roadmap","pages":[{"title":"Roadmap","href":"/roadmap"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Use Cursor with AI Gateway - OpenWork Docs","buildId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","deploymentId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","dynamics":[],"chunks":[]}