Create the key your MCP client authenticates with, and scope it correctly
An MCP client authenticates as a Quiva API key — there’s no separate credential type for MCP. This page covers what matters for that specific use; for everything else (rotation, storage, incident response) see the full API Keys reference.
Creating a key
1
Open the API keys tab
Open Settings from your user menu, then the API keys tab.
Settings → API keys: the list of keys on the account, with only their last 4 characters shown.
2
Add a new key
Click Add. Name it for what’s using it — “Claude Code”, “Cursor — laptop” — since the name and last four characters are all you’ll have to identify it later.
3
Copy it once
The key is shown once, with Copy and Download Credentials buttons. Put it straight into your client’s config or a secret store — see Connect a client.
Settings → API keys → Add. The dialog asks only for a name.
Scope and expiry
The Settings screen creates a user-scoped key: your MCP client acts with your own role and permissions. That’s the right choice for a personal coding tool. An account-scoped key (root/admin only, created through the API) is rarely what you want for MCP — it broadens the blast radius of a leaked key for no benefit here.A key created in Settings expires after 90 days; the dialog has no expiry option. A key with a different lifetime can only be created through the API (POST /accounts/api-key with expiry_days). A shared CI or automation credential that calls Quiva through MCP should get its own key, not a personal one you might delete without warning.
Restricted keys
A restricted key (the msr- prefix) is pinned to a fixed list of HTTP method/path pairs, and refuses anything outside it. This is the safer choice for an MCP client that only ever needs one area of the platform.The catch: the restriction is enforced on the underlying HTTP call, not on the MCP tool name. A restricted key has to allow every endpoint the tools you’ll use actually call — not just the ones that look obviously related.
A single tool can call more than one endpoint behind the scenes — a reference or validation tool that also fetches examples, say — so the obvious “this tool needs that one path” mapping isn’t always complete. If a call fails with 403 straight from the API (as opposed to a role-based refusal — see Connect a client for that case), the most likely cause is a restricted key missing one of the endpoints its tool needs. Use an unrestricted key during development, watch which paths your session actually calls, then narrow to a restricted key once you know the full list.
A restricted key has no downloadable credentials file — use the key value itself.
Rotating and revoking
There’s no in-place rotation: create the replacement key, update your MCP client’s configuration to use it, confirm the connection still works, then delete the old key. Settings → API keys → Delete Key revokes a key immediately — anything using it stops working at once, so deploy the replacement first.
Treat this key like a password. It authenticates as you (or, for an account-scoped key, as your account) for every tool your MCP client calls, including writes. Never paste it into a shared config file, a chat message or a public repository.
Full API keys reference
Prefixes, expiry emails, downloading credentials, and what to do if a key is compromised
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"QuivaWorks Docs","description":"","colors":{"primary":"#4641F2","light":"#ffffff","dark":"#4641F2"},"logo":{"light":"https://mintcdn.com/microstrate/Eit-IsSh6_6H8X4Q/logo/light.svg?fit=max\u0026auto=format\u0026n=Eit-IsSh6_6H8X4Q\u0026q=85\u0026s=01f10191a8ee36765af69b1436deb5e0","dark":"https://mintcdn.com/microstrate/Eit-IsSh6_6H8X4Q/logo/dark.svg?fit=max\u0026auto=format\u0026n=Eit-IsSh6_6H8X4Q\u0026q=85\u0026s=9dc23bd7a296bc325260ff32d2fc6d17"},"favicon":"https://mintcdn.com/microstrate/bn6ONmpX3KvP6AZn/favicon.svg?fit=max\u0026auto=format\u0026n=bn6ONmpX3KvP6AZn\u0026q=85\u0026s=af71ce7c16b2da43ee49a98290989182","appearance":{"default":"system"},"navbar":{"links":[{"href":"https://app.quiva.ai/en/login","label":"Log in"}],"primary":{"type":"button","label":"Try for free","href":"https://app.quiva.ai/en/signup"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/quivaworks"}},"fonts":{"family":"Be Vietnam Pro"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://quiva.ai/community"},{"anchor":"Support","icon":"headset","href":"https://quiva.ai/help-center/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"microstrate","hasAudioNarration":false,"actualSubdomain":"microstrate","customDomains":["docs.quiva.ai"],"gitSource":{"type":"github","owner":"quivaworks","repo":"quiva.ai","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b01a150bc9bec18ba0f1ea3","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":650},{"language":"default","tag":"Accounts","count":154},{"language":"default","tag":"Guides","count":129},{"language":"default","tag":"Records","count":84},{"language":"default","tag":"Assistants","count":83},{"language":"default","tag":"Workspaces","count":80},{"language":"default","tag":"Hub Flows","count":63},{"language":"default","tag":"Documents","count":52},{"language":"default","tag":"Abbie","count":48},{"language":"default","tag":"Spaces","count":44}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"site-roles","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},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"developers/mcp/api-keys","slug":"/developers/mcp/api-keys","pageMetadata":{"title":"API keys for MCP","description":"Create the key your MCP client authenticates with, and scope it correctly","icon":"key","href":"/developers/mcp/api-keys"},"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: \"Create the key your MCP client authenticates with, and scope it correctly\"\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`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Card,Frame,Heading,OptimizedImage,Step,Steps,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`An MCP client authenticates as a Quiva API key — there’s no separate credential type for MCP. This page covers what matters for that specific use; for everything else (rotation, storage, incident response) see the full `,_jsx(_components.a,{href:`/essentials/security/api-keys`,children:`API Keys`}),` reference.`]}),`\n`,_jsx(Heading,{level:`2`,id:`creating-a-key`,children:`Creating a key`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the API keys tab`,children:[_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Settings`}),` from your user menu, then the `,_jsx(_components.strong,{children:`API keys`}),` tab.`]}),_jsx(Frame,{caption:`Settings → API keys: the list of keys on the account, with only their last 4 characters shown.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-keys-list.png?fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=73bc7891de95e2db5c388ebbed424a94`,alt:`The Settings sidebar with API keys selected, and a table of existing keys showing Name, Account, Last 4 Characters, Created and Expires columns`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`228`,height:`228`,\"data-path\":`images/developers/api-keys-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-keys-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=01f971d6da15a050fa33d29f06bb6cb3 280w, https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-keys-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=3cd77dbfee8a9c232ce8a5b043ea1e84 560w, https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-keys-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=9f2ac62d1163c0c1c210104fc1795c93 840w, https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-keys-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=3b4c87993f46baf943b148d930252b0f 1100w, https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-keys-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=e769e288537eee1fc13656d9e9646636 1650w, https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-keys-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=35751e2f80ab5aa845789d7ebe170acb 2500w`})})]}),_jsx(Step,{title:`Add a new key`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Add`}),`. Name it for what’s using it — “Claude Code”, “Cursor — laptop” — since the name and last four characters are all you’ll have to identify it later.`]})}),_jsx(Step,{title:`Copy it once`,children:_jsxs(_components.p,{children:[`The key is shown once, with `,_jsx(_components.strong,{children:`Copy`}),` and `,_jsx(_components.strong,{children:`Download Credentials`}),` buttons. Put it straight into your client’s config or a secret store — see `,_jsx(_components.a,{href:`/developers/mcp/remote-setup`,children:`Connect a client`}),`.`]})})]}),`\n`,_jsx(Frame,{caption:`Settings → API keys → Add. The dialog asks only for a name.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-key-create.png?fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=1f9b5803a5236352185c4ace6cd462a9`,alt:`The Create API Key dialog with a single Name field and Add and Cancel buttons`,\"data-og-width\":`1488`,width:`1488`,\"data-og-height\":`480`,height:`480`,\"data-path\":`images/developers/api-key-create.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-key-create.png?w=280\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=c107d0ba569648a1703dc11ed2aaa194 280w, https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-key-create.png?w=560\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=e737a956b2d96ec362c11f5d813d9328 560w, https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-key-create.png?w=840\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=e1f79884b691c958bc99d4bfeed702dc 840w, https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-key-create.png?w=1100\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=2d67d2dd177e34322db55e745b20d7d5 1100w, https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-key-create.png?w=1650\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=9f55240205057e87b24a190589942b08 1650w, https://mintcdn.com/microstrate/i3EzDg242bov2haK/images/developers/api-key-create.png?w=2500\u0026fit=max\u0026auto=format\u0026n=i3EzDg242bov2haK\u0026q=85\u0026s=712301a98af5b2dc05aa1fcc118c38d2 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`scope-and-expiry`,children:`Scope and expiry`}),`\n`,_jsxs(_components.p,{children:[`The Settings screen creates a `,_jsx(_components.strong,{children:`user-scoped`}),` key: your MCP client acts with your own role and permissions. That’s the right choice for a personal coding tool. An `,_jsx(_components.strong,{children:`account-scoped`}),` key (root/admin only, created through the API) is rarely what you want for MCP — it broadens the blast radius of a leaked key for no benefit here.`]}),`\n`,_jsxs(_components.p,{children:[`A key created in Settings expires after `,_jsx(_components.strong,{children:`90 days`}),`; the dialog has no expiry option. A key with a different lifetime can only be created through the API (`,_jsx(_components.code,{children:`POST /accounts/api-key`}),` with `,_jsx(_components.code,{children:`expiry_days`}),`). A shared CI or automation credential that calls Quiva through MCP should get its own key, not a personal one you might delete without warning.`]}),`\n`,_jsx(Heading,{level:`2`,id:`restricted-keys`,children:`Restricted keys`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`restricted key`}),` (the `,_jsx(_components.code,{children:`msr-`}),` prefix) is pinned to a fixed list of HTTP method/path pairs, and refuses anything outside it. This is the safer choice for an MCP client that only ever needs one area of the platform.`]}),`\n`,_jsx(_components.p,{children:`The catch: the restriction is enforced on the underlying HTTP call, not on the MCP tool name. A restricted key has to allow every endpoint the tools you’ll use actually call — not just the ones that look obviously related.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`A single tool can call more than one endpoint behind the scenes — a reference or validation tool that also fetches examples, say — so the obvious “this tool needs that one path” mapping isn’t always complete. If a call fails with `,_jsx(_components.code,{children:`403`}),` straight from the API (as opposed to a role-based refusal — see `,_jsx(_components.a,{href:`/developers/mcp/remote-setup`,children:`Connect a client`}),` for that case), the most likely cause is a restricted key missing one of the endpoints its tool needs. Use an unrestricted key during development, watch which paths your session actually calls, then narrow to a restricted key once you know the full list.`]})}),`\n`,_jsx(_components.p,{children:`A restricted key has no downloadable credentials file — use the key value itself.`}),`\n`,_jsx(Heading,{level:`2`,id:`rotating-and-revoking`,children:`Rotating and revoking`}),`\n`,_jsxs(_components.p,{children:[`There’s no in-place rotation: create the replacement key, update your MCP client’s configuration to use it, confirm the connection still works, then delete the old key. `,_jsx(_components.strong,{children:`Settings → API keys → Delete Key`}),` revokes a key immediately — anything using it stops working at once, so deploy the replacement first.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Treat this key like a password.`}),` It authenticates as you (or, for an account-scoped key, as your account) for every tool your MCP client calls, including writes. Never paste it into a shared config file, a chat message or a public repository.`]})}),`\n`,_jsx(Card,{title:`Full API keys reference`,icon:`key`,href:`/essentials/security/api-keys`,children:_jsx(_components.p,{children:`Prefixes, expiry emails, downloading credentials, and what to do if a key is compromised`})})]})}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":"API keys for MCP","description":"Create the key your MCP client authenticates with, and scope it correctly","icon":"key","href":"/developers/mcp/api-keys"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Creating a key","slug":"creating-a-key","depth":2,"children":[]},{"title":"Scope and expiry","slug":"scope-and-expiry","depth":2,"children":[]},{"title":"Restricted keys","slug":"restricted-keys","depth":2,"children":[]},{"title":"Rotating and revoking","slug":"rotating-and-revoking","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"microstrate","siteName":"QuivaWorks Docs","title":"API keys for MCP - QuivaWorks Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-27T23:56:05.635Z","originalFileLocation":"developers/mcp/api-keys.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=\"Create the key your MCP client authenticates with, and scope it correctly\">\u003cmeta data-mint-head name=\"application-name\" content=\"QuivaWorks Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/microstrate/rkD4iFTLdo_icBn3/_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=\"/mintlify-assets/_mintlify/favicons/microstrate/rkD4iFTLdo_icBn3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/microstrate/rkD4iFTLdo_icBn3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/microstrate/rkD4iFTLdo_icBn3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/microstrate/rkD4iFTLdo_icBn3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/microstrate/rkD4iFTLdo_icBn3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/microstrate/rkD4iFTLdo_icBn3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/microstrate/rkD4iFTLdo_icBn3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/microstrate/rkD4iFTLdo_icBn3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"API keys for MCP - QuivaWorks Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create the key your MCP client authenticates with, and scope it correctly\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"QuivaWorks Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.quiva.ai/developers/mcp/api-keys\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://microstrate.mintlify.site/_mintlify/api/og/v2?division=MCP\u0026amp;title=API+keys+for+MCP\u0026amp;description=Create+the+key+your+MCP+client+authenticates+with%2C+and+scope+it+correctly\u0026amp;theme=749a3bdf44d0afc15e32a17f\u0026amp;signature=d568394f574af5929619b249640239b46c52fcf731d25fc3a967471e1c687b8a\">\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=\"API keys for MCP - QuivaWorks Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create the key your MCP client authenticates with, and scope it correctly\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://microstrate.mintlify.site/_mintlify/api/og/v2?division=MCP\u0026amp;title=API+keys+for+MCP\u0026amp;description=Create+the+key+your+MCP+client+authenticates+with%2C+and+scope+it+correctly\u0026amp;theme=749a3bdf44d0afc15e32a17f\u0026amp;signature=d568394f574af5929619b249640239b46c52fcf731d25fc3a967471e1c687b8a\">\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=\"/mintlify-assets/_mintlify/favicons/microstrate/rkD4iFTLdo_icBn3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"QuivaWorks Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4641F2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.quiva.ai/developers/mcp/api-keys\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developers/mcp/api-keys.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.quiva.ai/#organization\",\"name\":\"QuivaWorks Docs\",\"url\":\"https://docs.quiva.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/microstrate/Eit-IsSh6_6H8X4Q/logo/light.svg?fit=max\u0026auto=format\u0026n=Eit-IsSh6_6H8X4Q\u0026q=85\u0026s=01f10191a8ee36765af69b1436deb5e0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.quiva.ai#website\",\"name\":\"QuivaWorks Docs\",\"url\":\"https://docs.quiva.ai\",\"publisher\":{\"@id\":\"https://docs.quiva.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.quiva.ai/developers/mcp/api-keys#webpage\",\"url\":\"https://docs.quiva.ai/developers/mcp/api-keys\",\"name\":\"API keys for MCP\",\"description\":\"Create the key your MCP client authenticates with, and scope it correctly\",\"dateModified\":\"2026-09-27T23:56:05.635Z\",\"isPartOf\":{\"@id\":\"https://docs.quiva.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.quiva.ai/developers/mcp/api-keys#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.quiva.ai/developers/mcp/api-keys#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Developers\",\"item\":\"https://docs.quiva.ai/developers/mcp/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MCP\",\"item\":\"https://docs.quiva.ai/developers/mcp/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"API keys for MCP\",\"item\":\"https://docs.quiva.ai/developers/mcp/api-keys\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.quiva.ai/developers/mcp/api-keys#article\",\"headline\":\"API keys for MCP\",\"name\":\"API keys for MCP\",\"description\":\"Create the key your MCP client authenticates with, and scope it correctly\",\"url\":\"https://docs.quiva.ai/developers/mcp/api-keys\",\"mainEntityOfPage\":{\"@id\":\"https://docs.quiva.ai/developers/mcp/api-keys#webpage\"},\"dateModified\":\"2026-09-27T23:56:05.635Z\",\"publisher\":{\"@id\":\"https://docs.quiva.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.quiva.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"QuivaWorks Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"QuivaWorks Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developers/mcp/api-keys.md","siteName":"QuivaWorks Docs","nav":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://quiva.ai/community"},{"anchor":"Support","icon":"headset","href":"https://quiva.ai/help-center/"}]},"tabs":[{"tab":"Guides","groups":[{"group":"Get Started","pages":[{"title":"Welcome to QuivaWorks","icon":"hand-wave","href":"/get-started/overview"},{"title":"Getting Started","icon":"rocket","href":"/get-started/getting-started"},{"title":"Core Concepts","icon":"puzzle-piece","href":"/get-started/core-concepts"},{"title":"Collaboration","icon":"handshake","href":"/get-started/collaboration"},{"title":"Plans \u0026 Pricing","icon":"credit-card","href":"/get-started/plans-and-pricing"}]},{"group":"Spaces","icon":"folder-tree","pages":[{"title":"Spaces Overview","icon":"folder-tree","href":"/spaces/spaces"},{"title":"Home and cards","icon":"house","href":"/spaces/home-and-cards"},{"title":"Space menu and pages","icon":"bars","href":"/spaces/menu-and-pages"},{"title":"Entities \u0026 Contacts","icon":"address-book","href":"/spaces/entities-contacts"},{"title":"Cases","icon":"briefcase","href":"/spaces/cases"},{"title":"Journeys","icon":"route","href":"/spaces/journeys"},{"title":"Linked accounts and products","icon":"link","href":"/spaces/linked-accounts-and-products"},{"title":"Tasks","icon":"list-check","href":"/spaces/tasks"},{"title":"Task Actions","icon":"circle-check","href":"/spaces/task-actions"},{"title":"Records","icon":"database","href":"/spaces/records"},{"title":"File Management","icon":"folder-tree","href":"/spaces/file-management"},{"title":"Scheduling","icon":"calendar","href":"/spaces/scheduling"},{"title":"Escalations","icon":"angles-up","href":"/spaces/escalations"},{"title":"Client Portal","icon":"user-lock","href":"/spaces/client-portal"},{"title":"Task sync","icon":"rotate","href":"/spaces/task-sync"},{"title":"Task webhooks","icon":"webhook","href":"/spaces/task-webhooks"},{"title":"Staging Spaces","icon":"flask","href":"/spaces/staging-spaces"},{"title":"Service desk","icon":"headset","href":"/spaces/service-desk"}]},{"group":"Meetings","icon":"video","pages":[{"title":"Meetings Overview","icon":"video","href":"/meetings/overview"},{"title":"Connecting a Calendar","icon":"calendar-plus","href":"/meetings/connecting-a-calendar"},{"title":"Bot Settings","icon":"sliders","href":"/meetings/bot-settings"},{"title":"Scheduling Bots","icon":"calendar-check","href":"/meetings/scheduling-bots"},{"title":"On-Demand Bots","icon":"link","href":"/meetings/on-demand-bots"},{"title":"The Bots Tab","icon":"robot","href":"/meetings/bots-tab"},{"title":"Live Transcript","icon":"waveform-lines","href":"/meetings/live-transcript"},{"title":"Recordings","icon":"play","href":"/meetings/recordings"},{"title":"Summaries and Templates","icon":"wand-magic-sparkles","href":"/meetings/summaries"},{"title":"Sharing to a Space","icon":"folder-open","href":"/meetings/sharing-to-a-space"}]},{"group":"Forms","icon":"clipboard-list","pages":[{"title":"Forms","icon":"rectangle-list","href":"/forms/overview"},{"title":"Building a form","icon":"grid-2-plus","href":"/forms/building-a-form"},{"title":"Fields and elements","icon":"input-text","href":"/forms/elements"},{"title":"Form rules","icon":"code-branch","href":"/forms/form-rules"},{"title":"The rule assistant","icon":"wand-magic-sparkles","href":"/forms/rule-assistant"},{"title":"Form flows","icon":"diagram-project","href":"/forms/form-flows"}]},{"group":"Assistants","pages":[{"title":"Assistants Overview","icon":"sparkles","href":"/assistants/overview"},{"title":"Creating Your First Assistant","icon":"rocket","href":"/assistants/creating-first-assistant"},{"group":"Configuration","icon":"sliders","pages":[{"title":"General Settings","icon":"info-circle","href":"/assistants/configuration/information-settings"},{"title":"Provider Settings","icon":"cpu","href":"/assistants/configuration/provider-settings"},{"title":"Context Settings","icon":"brain","href":"/assistants/configuration/context-settings"},{"title":"Knowledge","icon":"book","href":"/assistants/configuration/knowledge"}]},{"title":"Tools \u0026 Connectors","icon":"plug","href":"/assistants/tools-and-connectors"},{"title":"Capabilities","icon":"stars","href":"/assistants/capabilities"},{"title":"Assistant Learning","icon":"sparkles","href":"/assistants/learning"},{"title":"Document Generation","icon":"wand-magic-sparkles","href":"/assistants/document-generation"},{"title":"Deploying Interactive Web Apps","icon":"cloud-upload","href":"/assistants/interactive-apps"},{"title":"Multi-Assistant Systems","icon":"diagram-project","href":"/assistants/multi-agent"},{"title":"Prompt Engineering","icon":"wand-magic-sparkles","href":"/assistants/prompt-engineering"},{"title":"Assistant Best Practices","icon":"star","href":"/assistants/best-practices"}]},{"group":"Collaboration","pages":[{"title":"Collaboration","icon":"users","href":"/collaboration/overview"},{"title":"Sharing a Conversation","icon":"share-nodes","href":"/collaboration/collaborative-sessions"},{"title":"@Mentions","icon":"at","href":"/collaboration/at-mention-guide"},{"title":"Finding Shared Conversations","icon":"list-ul","href":"/collaboration/shared-with-me-section"},{"title":"Notifications","icon":"bell","href":"/collaboration/unread-badges-notifications"},{"title":"Team Practices","icon":"people-group","href":"/collaboration/team-best-practices"}]},{"group":"Flows","pages":[{"title":"Flows Overview","icon":"diagram-project","href":"/flows/overview"},{"title":"Automations","icon":"wand-magic-sparkles","href":"/flows/automations"},{"group":"Triggers","icon":"bolt","pages":[{"title":"Triggers Overview","icon":"bolt","href":"/flows/triggers/overview"},{"title":"Embed Triggers","icon":"window-maximize","href":"/flows/triggers/embed-triggers"},{"title":"HTTP Request Trigger","icon":"globe","href":"/flows/triggers/http-request"},{"title":"Webhook Trigger","icon":"webhook","href":"/flows/triggers/webhook"},{"title":"Schedule Trigger","icon":"clock","href":"/flows/triggers/schedule"},{"title":"Upload Trigger","icon":"upload","href":"/flows/triggers/upload"},{"title":"Email Trigger","icon":"envelope","href":"/flows/triggers/email"},{"title":"Email Delivery Trigger","icon":"envelope-circle-check","href":"/flows/triggers/email-delivery"},{"title":"Mail Trigger","icon":"envelope-open-text","href":"/flows/triggers/mail"},{"title":"Stream Triggers","icon":"stream","href":"/flows/triggers/stream-triggers"}]},{"group":"Steps","icon":"list-check","pages":[{"title":"Flow Steps Overview","icon":"list-check","href":"/flows/steps/overview"},{"title":"Assistant","icon":"robot","href":"/flows/steps/agents"},{"title":"Checkpoint","icon":"user-check","href":"/flows/steps/human-in-the-loop"},{"title":"Delay","icon":"clock","href":"/flows/steps/delay"},{"title":"Condition","icon":"code-branch","href":"/flows/steps/condition"},{"title":"Send Email","icon":"envelope","href":"/flows/steps/email"},{"title":"HTTP Request","icon":"globe","href":"/flows/steps/http-request"},{"title":"Map","icon":"arrow-right-arrow-left","href":"/flows/steps/map"},{"title":"Rules","icon":"scale-balanced","href":"/flows/steps/rules"},{"title":"Eval","icon":"code","href":"/flows/steps/eval"},{"title":"Functions","icon":"function","href":"/flows/steps/functions"},{"title":"Nested Flow","icon":"diagram-project","href":"/flows/steps/nested-flows"},{"title":"Integration","icon":"circle-nodes","href":"/flows/steps/api-integrations"},{"title":"Connector","icon":"plug","href":"/flows/steps/connector"},{"group":"Functions","icon":"book","pages":[{"title":"Functions Overview","icon":"book","href":"/flows/functions/overview"},{"title":"Utility Functions","icon":"shuffle","href":"/flows/functions/utility"},{"title":"Key-Value Storage Functions","icon":"database","href":"/flows/functions/key-value"},{"title":"Object Storage Functions","icon":"box","href":"/flows/functions/object-storage"},{"title":"Stream Functions","icon":"stream","href":"/flows/functions/streams"}]}]},{"title":"Building Reliable Flows","icon":"shield-check","href":"/flows/best-practices"}]},{"group":"Account Management","pages":[{"group":"Account Management","icon":"id-card","pages":[{"title":"Creating Your Account","icon":"user-plus","href":"/essentials/account/creating-account"},{"title":"Account Settings","icon":"gear","href":"/essentials/account/account-settings"},{"title":"Branding \u0026 Global Assistant Settings","icon":"palette","href":"/essentials/account/global-admin-branding-settings"},{"title":"API Integrations","icon":"plug","href":"/essentials/account/api-integrations"},{"title":"Connect a tracker","icon":"plug","href":"/essentials/account/connections"},{"title":"Email sending","icon":"paper-plane","href":"/essentials/account/email-sending"},{"title":"Billing \u0026 Subscriptions","icon":"credit-card","href":"/essentials/account/billing-subscriptions"},{"title":"Closing Your Account","icon":"circle-xmark","href":"/essentials/account/closing-account"}]},{"group":"User Management","icon":"people-group","pages":[{"title":"User Management","icon":"users","href":"/essentials/users/user-management"},{"title":"Roles \u0026 Permissions","icon":"key","href":"/essentials/users/roles-permissions"},{"title":"User Settings","icon":"user-gear","href":"/essentials/users/user-settings"}]},{"group":"Security","icon":"lock","pages":[{"title":"Security Overview","icon":"shield","href":"/essentials/security/overview"},{"title":"Authentication","icon":"key","href":"/essentials/security/authentication"},{"title":"API Keys","icon":"code","href":"/essentials/security/api-keys"},{"title":"Session Management","icon":"clock","href":"/essentials/security/sessions"},{"title":"Incident Response","icon":"triangle-exclamation","href":"/essentials/security/incident-response"}]}]},{"group":"Advanced","pages":[{"title":"Architecture at a Glance","icon":"sitemap","href":"/get-started/development"},{"group":"Variable Mapping","icon":"arrow-right-arrow-left","pages":[{"title":"Variable Mapping","icon":"brackets-curly","href":"/advanced/variable-mapping/overview"},{"title":"JSONPath","icon":"brackets-curly","href":"/advanced/variable-mapping/jsonpath"},{"title":"Concatenation","icon":"text","href":"/advanced/variable-mapping/concatenation"},{"title":"Examples","icon":"code","href":"/advanced/variable-mapping/examples"}]},{"group":"Rules","icon":"gavel","pages":[{"title":"Overview","href":"/advanced/rules/overview"},{"title":"Getting Started","href":"/advanced/rules/getting-started"},{"title":"Core Concepts","href":"/advanced/rules/core-concepts"},{"title":"Operations Reference","href":"/advanced/rules/operations-reference"},{"title":"Common Patterns","href":"/advanced/rules/common-patterns"}]}]},{"group":"Developers","pages":[{"group":"MCP","icon":"server","pages":[{"title":"Quiva MCP servers","icon":"server","href":"/developers/mcp/overview"},{"title":"Connect a client to the remote server","description":"Point Claude Code, Cursor, VS Code or Claude Desktop at Quiva's hosted MCP endpoint","icon":"plug","href":"/developers/mcp/remote-setup"},{"title":"API keys for MCP","icon":"key","href":"/developers/mcp/api-keys"},{"title":"Run the servers locally","description":"Clone the Quiva MCP servers and run them as stdio processes for Claude Code and other local clients","icon":"terminal","href":"/developers/mcp/local-setup"},{"title":"Tool reference","icon":"list-check","href":"/developers/mcp/tools"}]},{"group":"Local AI agents","icon":"terminal","pages":[{"title":"Local AI agents","icon":"terminal","href":"/developers/agents/overview"},{"title":"Claude Code","icon":"terminal","href":"/developers/agents/claude-code"},{"title":"Codex","icon":"terminal","href":"/developers/agents/codex"},{"title":"OpenAPI specs","icon":"file-code","href":"/developers/agents/openapi-specs"},{"title":"Skills","icon":"wand-magic-sparkles","href":"/developers/agents/skills"}]},{"group":"Connectors","pages":[{"title":"Connector definitions","icon":"file-code","href":"/developers/connectors/definition"},{"title":"The sync block","icon":"gears","href":"/developers/connectors/sync"}]}]}]},{"tab":"Abbie","pages":[{"title":"Abbie","href":"/abbie/getting-started/introduction"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/authentication/initiate-oauth-login-flow"}]},{"tab":"Change Log","pages":[{"title":"Change Log","href":"/changelog/product-updates"}]}]},"basePath":"","title":"API keys for MCP - QuivaWorks Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}