Step-by-step setup for Claude, ChatGPT, Gemini, Claude Code and Codex.
Each AI app has its own place to add an MCP server, but the Spacebase side is the same every time: enter the connector address, sign in to Spacebase, and approve read-only access.
You need the Enterprise plan, the Spacebase AI module and the Access AI functionality permission. See Who can connect.
Have your Spacebase login ready. During setup the app opens a Spacebase sign-in window (password, Google, or your company’s single sign-on), then a consent screen titled Authorize that lists one permission: Read your Spacebase lease portfolio through AI assistants (read-only). Click Authorize to finish.
The consent screen names the app that made the request and where it will return you. Only authorize a request you started yourself.
Custom connectors are available in Claude on the web, Claude Desktop and Cowork. Claude.ai and Claude Desktop share one connection, so you only need to connect once.
1
Open Connectors
Go to Customize and then Connectors. In Claude Desktop this is under Settings → Connectors.
2
Add a custom connector
Click + Add and choose Add custom connector. Enter Spacebase as the name and https://spacebaseapp.com/mcp as the remote MCP server URL, then continue.
3
Choose how to sign in
Leave the authentication settings at their defaults, pick Sign in now, and click Add. A Spacebase sign-in window opens. Sign in and click Authorize.
4
Turn it on in a chat
In a conversation, click the + button at the lower left, choose Connectors, and make sure Spacebase is switched on. Then ask a question about your portfolio.
Team and Enterprise plans. An Owner or Primary Owner adds the connector once under Organization settings → Connectors using the same steps. Each member then opens Customize → Connectors, finds Spacebase and clicks Connect to sign in with their own Spacebase account.Remove. Open Customize → Connectors, find Spacebase and choose Remove from its menu. Then disconnect it in Spacebase as described in Disconnect an assistant.
ChatGPT manages custom MCP servers on its Plugins page. Custom MCP servers are available on the Plus, Pro, Business, Enterprise and Edu plans. On Business, Enterprise and Edu workspaces an administrator first grants the Create custom MCP servers permission under Workspace settings → Permissions & roles.
1
Open Plugins
From ChatGPT’s main page, click the Plugins button in the left sidebar. You can also go straight to chatgpt.com/plugins.
2
Create the connector
Click Add button and choose Add custom MCP server. Enter Spacebase as the name and a short description, enter https://spacebaseapp.com/mcp as the MCP server URL, and leave authentication set to OAuth.
3
Confirm and create
Read the warning about third-party servers and click I understand and want to continue, then Create as a plugin. ChatGPT scans the server and lists the Spacebase tools.
4
Sign in to Spacebase
ChatGPT opens the Spacebase sign-in window. Sign in and click Authorize.
5
Use it in a conversation
In a new chat, type @ in the message box, choose Spacebase, and ask your question.
Business, Enterprise and Edu workspaces. If ChatGPT says you need workspace admin permission to create a draft app, ask an administrator to grant you Create custom MCP servers. An administrator can also create the connector once and publish it to the whole workspace from the Plugins section of the Admin console. Each member still signs in with their own Spacebase account.Remove. Open Settings → Plugins, open the Spacebase plugin and uninstall it. Then disconnect it in Spacebase as described in Disconnect an assistant.
Custom apps are managed under Connected Apps in the Gemini web app at gemini.google.com.
1
Open Connected Apps
Click Settings at the bottom of the left panel, then Connected Apps. If you don’t see it, open Personal Intelligence first, then Connected Apps.
2
Add a custom app
Under Custom apps, click Add a custom app, enter https://spacebaseapp.com/mcp as the MCP server URL, and click Next.
3
Sign in to Spacebase
Follow the on-screen prompts. When the Spacebase sign-in window opens, sign in and click Authorize.
4
Use it in a chat
Type @ in the message box and choose Spacebase so Gemini uses the connector for that question.
To pause the connector, toggle it off under Custom apps. To remove it, open More details on the Spacebase app and choose Remove app, then disconnect it in Spacebase as described in Disconnect an assistant.Gemini Enterprise. A team administrator adds the connector for the whole team: in Gemini Enterprise, open Settings & help, choose the team, go to Manage team → Connected apps, and click Add MCP Server with the same address. Each member signs in to Spacebase with their own account the first time they use it.
Start Gemini CLI and run /mcp auth spacebase. A browser window opens for the Spacebase sign-in and consent screen. Tokens are stored in ~/.gemini/mcp-oauth-tokens.json.Use gemini mcp list to check the connection and gemini mcp remove spacebase to remove it.
Add the server from the terminal, then sign in from inside Claude Code.
claude mcp add --transport http spacebase https://spacebaseapp.com/mcp
By default the server is available in the current project only. Add --scope user to make it available in every project:
claude mcp add --transport http --scope user spacebase https://spacebaseapp.com/mcp
Start Claude Code and run /mcp. Select spacebase and follow the browser sign-in. You can also sign in without opening Claude Code:
claude mcp login spacebase
Claude Code can fetch complete results into its workspace and analyze them with code, so it’s a good fit for questions that span hundreds of expense records or dates. See Downloading results as CSV.Share with your team. To make the connector part of a repository, add it to .mcp.json at the project root. Each person still signs in with their own Spacebase account.
Remove. Run claude mcp logout spacebase to clear the sign-in and claude mcp remove spacebase to delete the server. Then disconnect it in Spacebase as described in Disconnect an assistant. Each Claude Code installation appears as its own row there.
The second command opens a browser window for the Spacebase sign-in and consent screen. Tokens refresh automatically afterwards.If you prefer editing configuration directly, add this to ~/.codex/config.toml and run codex mcp login spacebase:
Use codex mcp list to check the connection, codex mcp logout spacebase to clear the sign-in, and remove the [mcp_servers.spacebase] section to delete the server.
The app says I'm not authorized, or the connection fails right after I sign in
Your account is failing one of the access checks. Confirm with your administrator that your company is on the Enterprise plan with the Spacebase AI module enabled, and that your user has the Access AI functionality permission. If you connected before and lost access later, the AI Connectors page in Spacebase shows a banner explaining that the connected apps can no longer read your data.
The sign-in window opened but the app never finished connecting
Try again and complete the sign-in in the same browser the app opened. The Authorize screen appears right after you sign in. If your company uses single sign-on and you land on the Spacebase dashboard instead of the consent screen, start the connection again from the app.
ChatGPT says I need workspace admin permission to create a draft app
Your ChatGPT account belongs to a Business, Enterprise or Edu workspace where custom MCP servers are restricted. Ask an administrator to grant you Create custom MCP servers under Workspace settings → Permissions & roles, or to create and publish the Spacebase connector for the workspace.
The app asks me to reconnect after it worked before
Either the connection was disconnected from the AI Connectors page in Spacebase, or its 90-day renewal token expired. Sign in again from the app. If you no longer want the connection, remove it in the app as well.
I see an 'Unsupported protocol version' error
Spacebase serves the MCP 2026-07-28 revision only. The app you’re using is on an older version of MCP. Update the app and connect again. For Claude Code, run claude update.
I see a 'Rate limit exceeded' error
The connector allows 30 tool calls a minute and 300 an hour per user. Wait a minute and ask again. Long analyses go faster when the assistant uses the summary totals or a CSV download instead of paging through every row. See Limits.
I switched companies in Spacebase and the assistant's answers changed
The connector follows the company you’re currently signed in to. If you belong to more than one company, switch back in Spacebase and ask again.
A download link the assistant gave me doesn't work
See Downloading results as CSV for what each message means. Most often the link has expired after 24 hours, or you’re signed in to Spacebase as a different user or company than when the link was created.
If none of these help, email support@spacebaseapp.com with the app you’re using and the time of the failed attempt.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Spacebase Help Center","colors":{"primary":"#0061D5","light":"#4D8FE5","dark":"#9BB8FF"},"logo":{"light":"https://mintcdn.com/spacebase/RRtj8OHjdVtKk7xJ/logo/light.svg?fit=max\u0026auto=format\u0026n=RRtj8OHjdVtKk7xJ\u0026q=85\u0026s=43f10b5c4b93c77335cdaa7763924131","dark":"https://mintcdn.com/spacebase/RRtj8OHjdVtKk7xJ/logo/dark.svg?fit=max\u0026auto=format\u0026n=RRtj8OHjdVtKk7xJ\u0026q=85\u0026s=005026e18a6777e5705f32d8dbc3ae7e"},"favicon":"https://mintcdn.com/spacebase/RRtj8OHjdVtKk7xJ/favicon.png?fit=max\u0026auto=format\u0026n=RRtj8OHjdVtKk7xJ\u0026q=85\u0026s=dc4fec534d7225665caa3e544cdbdb19","navbar":{"links":[{"href":"mailto:support@spacebaseapp.com","label":"Support"}]},"footer":{"socials":{}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spacebase","hasAudioNarration":false,"actualSubdomain":"spacebase","customDomains":["docs.spacebaseapp.com"],"gitSource":{"type":"github","owner":"spacebase-ventures","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6acd74cdb3c8c27f88b0ae39","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Help Center","count":56},{"language":"default","tag":"Settings \u0026 General","count":20},{"language":"default","tag":"Accounting","count":18},{"language":"default","tag":"Company Settings","count":14},{"language":"default","tag":"Modifications","count":10},{"language":"default","tag":"Spacebase AI","count":6},{"language":"default","tag":"Lease Administration","count":5},{"language":"default","tag":"AI Connectors","count":3},{"language":"default","tag":"API \u0026 Webhooks","count":2},{"language":"default","tag":"Payments","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"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":"custom.css","content":":root,body,h1,h2,h3,h4,h5,h6,button,input,select,textarea{font-family:system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\",\n Roboto, Oxygen, Ubuntu, Cantarell, \"Helvetica Neue\", Arial, sans-serif}code,pre,kbd,samp,tt{font-family:ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Monaco,\n Consolas, \"Liberation Mono\", \"Courier New\", monospace}"}],"page":{"pagePath":"ai/connectors/connect","slug":"/ai/connectors/connect","pageMetadata":{"title":"Connect an AI app","description":"Step-by-step setup for Claude, ChatGPT, Gemini, Claude Code and Codex.","href":"/ai/connectors/connect"},"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: \"Step-by-step setup for Claude, ChatGPT, Gemini, Claude Code and Codex.\"\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`,em:`em`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading,Info,Step,Steps,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Each AI app has its own place to add an MCP server, but the Spacebase side is the same every time: enter the connector address, sign in to Spacebase, and approve read-only access.`}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsx(_components.p,{children:`The connector address for every app is:`}),`\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:`https://spacebaseapp.com/mcp`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`You need the Enterprise plan, the Spacebase AI module and the `,_jsx(_components.strong,{children:`Access AI functionality`}),` permission. See `,_jsx(_components.a,{href:`/ai/connectors#who-can-connect`,children:`Who can connect`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[`Have your Spacebase login ready. During setup the app opens a Spacebase sign-in window (password, Google, or your company’s single sign-on), then a consent screen titled `,_jsx(_components.strong,{children:`Authorize`}),` that lists one permission: `,_jsx(_components.em,{children:`Read your Spacebase lease portfolio through AI assistants (read-only)`}),`. Click `,_jsx(_components.strong,{children:`Authorize`}),` to finish.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`The consent screen names the app that made the request and where it will return you. Only authorize a request you started yourself.`})}),`\n`,_jsx(Heading,{level:`2`,id:`claude`,children:`Claude`}),`\n`,_jsx(_components.p,{children:`Custom connectors are available in Claude on the web, Claude Desktop and Cowork. Claude.ai and Claude Desktop share one connection, so you only need to connect once.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Connectors`,children:_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Customize`}),` and then `,_jsx(_components.strong,{children:`Connectors`}),`. In Claude Desktop this is under `,_jsx(_components.strong,{children:`Settings`}),` → `,_jsx(_components.strong,{children:`Connectors`}),`.`]})}),_jsx(Step,{title:`Add a custom connector`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`+ Add`}),` and choose `,_jsx(_components.strong,{children:`Add custom connector`}),`. Enter `,_jsx(_components.em,{children:`Spacebase`}),` as the name and `,_jsx(_components.code,{children:`https://spacebaseapp.com/mcp`}),` as the remote MCP server URL, then continue.`]})}),_jsx(Step,{title:`Choose how to sign in`,children:_jsxs(_components.p,{children:[`Leave the authentication settings at their defaults, pick `,_jsx(_components.strong,{children:`Sign in now`}),`, and click `,_jsx(_components.strong,{children:`Add`}),`. A Spacebase sign-in window opens. Sign in and click `,_jsx(_components.strong,{children:`Authorize`}),`.`]})}),_jsx(Step,{title:`Turn it on in a chat`,children:_jsxs(_components.p,{children:[`In a conversation, click the `,_jsx(_components.strong,{children:`+`}),` button at the lower left, choose `,_jsx(_components.strong,{children:`Connectors`}),`, and make sure `,_jsx(_components.strong,{children:`Spacebase`}),` is switched on. Then ask a question about your portfolio.`]})})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Team and Enterprise plans.`}),` An Owner or Primary Owner adds the connector once under `,_jsx(_components.strong,{children:`Organization settings`}),` → `,_jsx(_components.strong,{children:`Connectors`}),` using the same steps. Each member then opens `,_jsx(_components.strong,{children:`Customize`}),` → `,_jsx(_components.strong,{children:`Connectors`}),`, finds Spacebase and clicks `,_jsx(_components.strong,{children:`Connect`}),` to sign in with their own Spacebase account.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Remove.`}),` Open `,_jsx(_components.strong,{children:`Customize`}),` → `,_jsx(_components.strong,{children:`Connectors`}),`, find Spacebase and choose `,_jsx(_components.strong,{children:`Remove`}),` from its menu. Then disconnect it in Spacebase as described in `,_jsx(_components.a,{href:`/ai/connectors#disconnect-an-assistant`,children:`Disconnect an assistant`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`chatgpt`,children:`ChatGPT`}),`\n`,_jsxs(_components.p,{children:[`ChatGPT manages custom MCP servers on its `,_jsx(_components.strong,{children:`Plugins`}),` page. Custom MCP servers are available on the Plus, Pro, Business, Enterprise and Edu plans. On Business, Enterprise and Edu workspaces an administrator first grants the `,_jsx(_components.strong,{children:`Create custom MCP servers`}),` permission under `,_jsx(_components.strong,{children:`Workspace settings`}),` → `,_jsx(_components.strong,{children:`Permissions \u0026 roles`}),`.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Plugins`,children:_jsxs(_components.p,{children:[`From ChatGPT’s main page, click the `,_jsx(_components.strong,{children:`Plugins`}),` button in the left sidebar. You can also go straight to `,_jsx(_components.a,{href:`https://chatgpt.com/plugins`,children:`chatgpt.com/plugins`}),`.`]})}),_jsx(Step,{title:`Create the connector`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Add`}),` button and choose `,_jsx(_components.strong,{children:`Add custom MCP server`}),`. Enter `,_jsx(_components.em,{children:`Spacebase`}),` as the name and a short description, enter `,_jsx(_components.code,{children:`https://spacebaseapp.com/mcp`}),` as the MCP server URL, and leave authentication set to `,_jsx(_components.strong,{children:`OAuth`}),`.`]})}),_jsx(Step,{title:`Confirm and create`,children:_jsxs(_components.p,{children:[`Read the warning about third-party servers and click `,_jsx(_components.strong,{children:`I understand and want to continue`}),`, then `,_jsx(_components.strong,{children:`Create as a plugin`}),`. ChatGPT scans the server and lists the Spacebase tools.`]})}),_jsx(Step,{title:`Sign in to Spacebase`,children:_jsxs(_components.p,{children:[`ChatGPT opens the Spacebase sign-in window. Sign in and click `,_jsx(_components.strong,{children:`Authorize`}),`.`]})}),_jsx(Step,{title:`Use it in a conversation`,children:_jsxs(_components.p,{children:[`In a new chat, type `,_jsx(_components.strong,{children:`@`}),` in the message box, choose `,_jsx(_components.strong,{children:`Spacebase`}),`, and ask your question.`]})})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Business, Enterprise and Edu workspaces.`}),` If ChatGPT says you need workspace admin permission to create a draft app, ask an administrator to grant you `,_jsx(_components.strong,{children:`Create custom MCP servers`}),`. An administrator can also create the connector once and publish it to the whole workspace from the `,_jsx(_components.strong,{children:`Plugins`}),` section of the Admin console. Each member still signs in with their own Spacebase account.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Remove.`}),` Open `,_jsx(_components.strong,{children:`Settings`}),` → `,_jsx(_components.strong,{children:`Plugins`}),`, open the Spacebase plugin and uninstall it. Then disconnect it in Spacebase as described in `,_jsx(_components.a,{href:`/ai/connectors#disconnect-an-assistant`,children:`Disconnect an assistant`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`gemini`,children:`Gemini`}),`\n`,_jsx(Heading,{level:`3`,id:`gemini-web-app`,children:`Gemini web app`}),`\n`,_jsxs(_components.p,{children:[`Custom apps are managed under `,_jsx(_components.strong,{children:`Connected Apps`}),` in the Gemini web app at `,_jsx(_components.a,{href:`https://gemini.google.com`,children:`gemini.google.com`}),`.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Connected Apps`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Settings`}),` at the bottom of the left panel, then `,_jsx(_components.strong,{children:`Connected Apps`}),`. If you don’t see it, open `,_jsx(_components.strong,{children:`Personal Intelligence`}),` first, then `,_jsx(_components.strong,{children:`Connected Apps`}),`.`]})}),_jsx(Step,{title:`Add a custom app`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Custom apps`}),`, click `,_jsx(_components.strong,{children:`Add a custom app`}),`, enter `,_jsx(_components.code,{children:`https://spacebaseapp.com/mcp`}),` as the MCP server URL, and click `,_jsx(_components.strong,{children:`Next`}),`.`]})}),_jsx(Step,{title:`Sign in to Spacebase`,children:_jsxs(_components.p,{children:[`Follow the on-screen prompts. When the Spacebase sign-in window opens, sign in and click `,_jsx(_components.strong,{children:`Authorize`}),`.`]})}),_jsx(Step,{title:`Use it in a chat`,children:_jsxs(_components.p,{children:[`Type `,_jsx(_components.strong,{children:`@`}),` in the message box and choose `,_jsx(_components.strong,{children:`Spacebase`}),` so Gemini uses the connector for that question.`]})})]}),`\n`,_jsxs(_components.p,{children:[`To pause the connector, toggle it off under `,_jsx(_components.strong,{children:`Custom apps`}),`. To remove it, open `,_jsx(_components.strong,{children:`More details`}),` on the Spacebase app and choose `,_jsx(_components.strong,{children:`Remove app`}),`, then disconnect it in Spacebase as described in `,_jsx(_components.a,{href:`/ai/connectors#disconnect-an-assistant`,children:`Disconnect an assistant`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Gemini Enterprise.`}),` A team administrator adds the connector for the whole team: in Gemini Enterprise, open `,_jsx(_components.strong,{children:`Settings \u0026 help`}),`, choose the team, go to `,_jsx(_components.strong,{children:`Manage team`}),` → `,_jsx(_components.strong,{children:`Connected apps`}),`, and click `,_jsx(_components.strong,{children:`Add MCP Server`}),` with the same address. Each member signs in to Spacebase with their own account the first time they use it.`]}),`\n`,_jsx(Heading,{level:`3`,id:`gemini-cli`,children:`Gemini CLI`}),`\n`,_jsxs(_components.p,{children:[`Add Spacebase to the `,_jsx(_components.code,{children:`mcpServers`}),` section of `,_jsx(_components.code,{children:`~/.gemini/settings.json`}),`. Leave the OAuth details out: Gemini CLI discovers them from the server.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mcpServers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"spacebase\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"httpUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://spacebaseapp.com/mcp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"oauth\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Start Gemini CLI and run `,_jsx(_components.code,{children:`/mcp auth spacebase`}),`. A browser window opens for the Spacebase sign-in and consent screen. Tokens are stored in `,_jsx(_components.code,{children:`~/.gemini/mcp-oauth-tokens.json`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`gemini mcp list`}),` to check the connection and `,_jsx(_components.code,{children:`gemini mcp remove spacebase`}),` to remove it.`]}),`\n`,_jsx(Heading,{level:`2`,id:`claude-code`,children:`Claude Code`}),`\n`,_jsx(_components.p,{children:`Add the server from the terminal, then sign in from inside Claude Code.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`claude`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --transport`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` http`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` spacebase`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://spacebaseapp.com/mcp`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`By default the server is available in the current project only. Add `,_jsx(_components.code,{children:`--scope user`}),` to make it available in every project:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`claude`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --transport`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` http`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` user`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` spacebase`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://spacebaseapp.com/mcp`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Start Claude Code and run `,_jsx(_components.code,{children:`/mcp`}),`. Select `,_jsx(_components.strong,{children:`spacebase`}),` and follow the browser sign-in. You can also sign in without opening Claude Code:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`claude`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` login`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` spacebase`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Claude Code can fetch complete results into its workspace and analyze them with code, so it’s a good fit for questions that span hundreds of expense records or dates. See `,_jsx(_components.a,{href:`/ai/connectors/tools#downloading-results-as-csv`,children:`Downloading results as CSV`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Share with your team.`}),` To make the connector part of a repository, add it to `,_jsx(_components.code,{children:`.mcp.json`}),` at the project root. Each person still signs in with their own Spacebase account.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mcpServers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"spacebase\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"http\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://spacebaseapp.com/mcp\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Remove.`}),` Run `,_jsx(_components.code,{children:`claude mcp logout spacebase`}),` to clear the sign-in and `,_jsx(_components.code,{children:`claude mcp remove spacebase`}),` to delete the server. Then disconnect it in Spacebase as described in `,_jsx(_components.a,{href:`/ai/connectors#disconnect-an-assistant`,children:`Disconnect an assistant`}),`. Each Claude Code installation appears as its own row there.`]}),`\n`,_jsx(Heading,{level:`2`,id:`codex`,children:`Codex`}),`\n`,_jsx(Heading,{level:`3`,id:`codex-cli`,children:`Codex CLI`}),`\n`,_jsx(_components.p,{children:`Register the server and sign in:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`codex`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` spacebase`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://spacebaseapp.com/mcp`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`codex`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` login`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` spacebase`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The second command opens a browser window for the Spacebase sign-in and consent screen. Tokens refresh automatically afterwards.`}),`\n`,_jsxs(_components.p,{children:[`If you prefer editing configuration directly, add this to `,_jsx(_components.code,{children:`~/.codex/config.toml`}),` and run `,_jsx(_components.code,{children:`codex mcp login spacebase`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`toml`,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:`toml`,children:_jsxs(_components.code,{language:`toml`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:`mcp_servers`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:`spacebase`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://spacebaseapp.com/mcp\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`codex mcp list`}),` to check the connection, `,_jsx(_components.code,{children:`codex mcp logout spacebase`}),` to clear the sign-in, and remove the `,_jsx(_components.code,{children:`[mcp_servers.spacebase]`}),` section to delete the server.`]}),`\n`,_jsx(Heading,{level:`3`,id:`codex-ide-extension-and-desktop-app`,children:`Codex IDE extension and desktop app`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open MCP servers`,children:_jsxs(_components.p,{children:[`Open the Codex settings and select `,_jsx(_components.strong,{children:`MCP servers`}),`.`]})}),_jsx(Step,{title:`Add the server`,children:_jsxs(_components.p,{children:[`Choose `,_jsx(_components.strong,{children:`Add server`}),`, select `,_jsx(_components.strong,{children:`Streamable HTTP`}),`, enter `,_jsx(_components.em,{children:`spacebase`}),` as the name and `,_jsx(_components.code,{children:`https://spacebaseapp.com/mcp`}),` as the URL.`]})}),_jsx(Step,{title:`Authenticate`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Authenticate`}),` when prompted and complete the Spacebase sign-in. Restart the extension or app if asked.`]})})]}),`\n`,_jsxs(_components.p,{children:[`After removing the server in Codex, disconnect it in Spacebase as described in `,_jsx(_components.a,{href:`/ai/connectors#disconnect-an-assistant`,children:`Disconnect an assistant`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`The app says I'm not authorized, or the connection fails right after I sign in`,id:`the-app-says-i-m-not-authorized-or-the-connection-fails-right-after-i-sign-in`,children:_jsxs(_components.p,{children:[`Your account is failing one of the access checks. Confirm with your administrator that your company is on the Enterprise plan with the Spacebase AI module enabled, and that your user has the `,_jsx(_components.strong,{children:`Access AI functionality`}),` permission. If you connected before and lost access later, the `,_jsx(_components.strong,{children:`AI Connectors`}),` page in Spacebase shows a banner explaining that the connected apps can no longer read your data.`]})}),_jsx(Accordion,{title:`The sign-in window opened but the app never finished connecting`,id:`the-sign-in-window-opened-but-the-app-never-finished-connecting`,children:_jsxs(_components.p,{children:[`Try again and complete the sign-in in the same browser the app opened. The `,_jsx(_components.strong,{children:`Authorize`}),` screen appears right after you sign in. If your company uses single sign-on and you land on the Spacebase dashboard instead of the consent screen, start the connection again from the app.`]})}),_jsx(Accordion,{title:`ChatGPT says I need workspace admin permission to create a draft app`,id:`chatgpt-says-i-need-workspace-admin-permission-to-create-a-draft-app`,children:_jsxs(_components.p,{children:[`Your ChatGPT account belongs to a Business, Enterprise or Edu workspace where custom MCP servers are restricted. Ask an administrator to grant you `,_jsx(_components.strong,{children:`Create custom MCP servers`}),` under `,_jsx(_components.strong,{children:`Workspace settings`}),` → `,_jsx(_components.strong,{children:`Permissions \u0026 roles`}),`, or to create and publish the Spacebase connector for the workspace.`]})}),_jsx(Accordion,{title:`The app asks me to reconnect after it worked before`,id:`the-app-asks-me-to-reconnect-after-it-worked-before`,children:_jsxs(_components.p,{children:[`Either the connection was disconnected from the `,_jsx(_components.strong,{children:`AI Connectors`}),` page in Spacebase, or its 90-day renewal token expired. Sign in again from the app. If you no longer want the connection, remove it in the app as well.`]})}),_jsx(Accordion,{title:`I see an 'Unsupported protocol version' error`,id:`i-see-an-unsupported-protocol-version-error`,children:_jsxs(_components.p,{children:[`Spacebase serves the MCP 2026-07-28 revision only. The app you’re using is on an older version of MCP. Update the app and connect again. For Claude Code, run `,_jsx(_components.code,{children:`claude update`}),`.`]})}),_jsx(Accordion,{title:`I see a 'Rate limit exceeded' error`,id:`i-see-a-rate-limit-exceeded-error`,children:_jsxs(_components.p,{children:[`The connector allows 30 tool calls a minute and 300 an hour per user. Wait a minute and ask again. Long analyses go faster when the assistant uses the summary totals or a CSV download instead of paging through every row. See `,_jsx(_components.a,{href:`/ai/connectors/tools#limits`,children:`Limits`}),`.`]})}),_jsx(Accordion,{title:`I switched companies in Spacebase and the assistant's answers changed`,id:`i-switched-companies-in-spacebase-and-the-assistants-answers-changed`,children:_jsx(_components.p,{children:`The connector follows the company you’re currently signed in to. If you belong to more than one company, switch back in Spacebase and ask again.`})}),_jsx(Accordion,{title:`A download link the assistant gave me doesn't work`,id:`a-download-link-the-assistant-gave-me-doesnt-work`,children:_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/ai/connectors/tools#downloading-results-as-csv`,children:`Downloading results as CSV`}),` for what each message means. Most often the link has expired after 24 hours, or you’re signed in to Spacebase as a different user or company than when the link was created.`]})})]}),`\n`,_jsxs(_components.p,{children:[`If none of these help, email `,_jsx(_components.a,{href:`mailto:support@spacebaseapp.com`,children:`support@spacebaseapp.com`}),` with the app you’re using and the time of the failed attempt.`]})]})}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":"Connect an AI app","description":"Step-by-step setup for Claude, ChatGPT, Gemini, Claude Code and Codex.","href":"/ai/connectors/connect"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Claude","slug":"claude","depth":2,"children":[]},{"title":"ChatGPT","slug":"chatgpt","depth":2,"children":[]},{"title":"Gemini","slug":"gemini","depth":2,"children":[{"title":"Gemini web app","slug":"gemini-web-app","depth":3,"children":[]},{"title":"Gemini CLI","slug":"gemini-cli","depth":3,"children":[]}]},{"title":"Claude Code","slug":"claude-code","depth":2,"children":[]},{"title":"Codex","slug":"codex","depth":2,"children":[{"title":"Codex CLI","slug":"codex-cli","depth":3,"children":[]},{"title":"Codex IDE extension and desktop app","slug":"codex-ide-extension-and-desktop-app","depth":3,"children":[]}]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"spacebase","siteName":"Spacebase Help Center","title":"Connect an AI app - Spacebase Help Center","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T19:42:25.192Z","originalFileLocation":"ai/connectors/connect.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=\"Step-by-step setup for Claude, ChatGPT, Gemini, Claude Code and Codex.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Spacebase Help Center\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spacebase/zVHGaqrvbsNlzdeJ/_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/spacebase/zVHGaqrvbsNlzdeJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spacebase/zVHGaqrvbsNlzdeJ/_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/spacebase/zVHGaqrvbsNlzdeJ/_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/spacebase/zVHGaqrvbsNlzdeJ/_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/spacebase/zVHGaqrvbsNlzdeJ/_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/spacebase/zVHGaqrvbsNlzdeJ/_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/spacebase/zVHGaqrvbsNlzdeJ/_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/spacebase/zVHGaqrvbsNlzdeJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect an AI app - Spacebase Help Center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Step-by-step setup for Claude, ChatGPT, Gemini, Claude Code and Codex.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Spacebase Help Center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.spacebaseapp.com/ai/connectors/connect\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spacebase.mintlify.site/_mintlify/api/og/v2?division=AI+Connectors\u0026amp;title=Connect+an+AI+app\u0026amp;description=Step-by-step+setup+for+Claude%2C+ChatGPT%2C+Gemini%2C+Claude+Code+and+Codex.\u0026amp;theme=0ce27eb8c67ef64079042f50\u0026amp;signature=33fc5cf86f50131bd205a440f2ab39ea4b055da7b7a01166f56b342e935d678f\">\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=\"Connect an AI app - Spacebase Help Center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Step-by-step setup for Claude, ChatGPT, Gemini, Claude Code and Codex.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spacebase.mintlify.site/_mintlify/api/og/v2?division=AI+Connectors\u0026amp;title=Connect+an+AI+app\u0026amp;description=Step-by-step+setup+for+Claude%2C+ChatGPT%2C+Gemini%2C+Claude+Code+and+Codex.\u0026amp;theme=0ce27eb8c67ef64079042f50\u0026amp;signature=33fc5cf86f50131bd205a440f2ab39ea4b055da7b7a01166f56b342e935d678f\">\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/spacebase/zVHGaqrvbsNlzdeJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Spacebase Help Center\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0061D5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.spacebaseapp.com/ai/connectors/connect\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ai/connectors/connect.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.spacebaseapp.com/#organization\",\"name\":\"Spacebase Help Center\",\"url\":\"https://docs.spacebaseapp.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spacebase/RRtj8OHjdVtKk7xJ/logo/light.svg?fit=max\u0026auto=format\u0026n=RRtj8OHjdVtKk7xJ\u0026q=85\u0026s=43f10b5c4b93c77335cdaa7763924131\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.spacebaseapp.com#website\",\"name\":\"Spacebase Help Center\",\"url\":\"https://docs.spacebaseapp.com\",\"publisher\":{\"@id\":\"https://docs.spacebaseapp.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.spacebaseapp.com/ai/connectors/connect#webpage\",\"url\":\"https://docs.spacebaseapp.com/ai/connectors/connect\",\"name\":\"Connect an AI app\",\"description\":\"Step-by-step setup for Claude, ChatGPT, Gemini, Claude Code and Codex.\",\"dateModified\":\"2026-10-07T19:42:25.192Z\",\"isPartOf\":{\"@id\":\"https://docs.spacebaseapp.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spacebaseapp.com/ai/connectors/connect#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spacebaseapp.com/ai/connectors/connect#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Spacebase AI\",\"item\":\"https://docs.spacebaseapp.com/ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"AI Connectors\",\"item\":\"https://docs.spacebaseapp.com/ai/connectors\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Connect an AI app\",\"item\":\"https://docs.spacebaseapp.com/ai/connectors/connect\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.spacebaseapp.com/ai/connectors/connect#article\",\"headline\":\"Connect an AI app\",\"name\":\"Connect an AI app\",\"description\":\"Step-by-step setup for Claude, ChatGPT, Gemini, Claude Code and Codex.\",\"url\":\"https://docs.spacebaseapp.com/ai/connectors/connect\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spacebaseapp.com/ai/connectors/connect#webpage\"},\"dateModified\":\"2026-10-07T19:42:25.192Z\",\"publisher\":{\"@id\":\"https://docs.spacebaseapp.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.spacebaseapp.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Spacebase Help Center\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Spacebase Help Center\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ai/connectors/connect.md","siteName":"Spacebase Help Center","nav":{"global":null,"tabs":[{"tab":"Help Center","groups":[{"group":"Getting started","pages":[{"title":"Help Documentation","href":""}]},{"group":"Lease Administration","pages":[{"title":"Lease Administration","href":"/leases/overview"},{"title":"Lease Abstraction","href":"/leases/abstraction"},{"title":"Spacebase Abstraction Team","href":"/leases/abstraction-team"},{"title":"Lease Management","href":"/leases/management"},{"title":"Retail Sales Module","href":"/leases/retail-sales"}]},{"group":"Accounting","pages":[{"title":"Spacebase Accounting","href":"/accounting/overview"},{"title":"Accounting Leases","href":"/accounting/leases"},{"title":"Expenses and lease components","href":"/accounting/expenses-and-components"},{"title":"Additional balances and costs","href":"/accounting/balances-and-costs"},{"title":"ASC 842 and IFRS 16 versions","href":"/accounting/multiple-standards"},{"title":"From setup to month-end close","href":"/accounting/month-end-close"},{"group":"Modifications","pages":[{"title":"Accounting lease modifications","sidebarTitle":"Overview","href":"/accounting/modifications"},{"title":"Update existing accounting lease","href":"/accounting/modifications/update"},{"title":"Add lease expiration","href":"/accounting/modifications/expiration"},{"title":"Partially terminate accounting lease","href":"/accounting/modifications/partial-termination"},{"title":"Terminate accounting lease","href":"/accounting/modifications/termination"},{"title":"Create new accounting lease","href":"/accounting/modifications/new-accounting-lease"},{"title":"Correct an error","href":"/accounting/modifications/error-correction"},{"title":"Flow through real estate changes","href":"/accounting/modifications/flow-through"},{"title":"Add impairment","href":"/accounting/modifications/impairment"},{"title":"Abandon lease","href":"/accounting/modifications/abandonment"}]},{"title":"Chart of accounts","href":"/accounting/chart-of-accounts"},{"title":"Company accounting settings","href":"/accounting/settings"}]},{"group":"Payments","pages":[{"title":"Payments","href":"/payments/overview"},{"title":"Payments How-To","href":"/payments/how-to"}]},{"group":"Reports","pages":[{"title":"Reports","href":"/reports/overview"}]},{"group":"Settings \u0026 General","pages":[{"title":"Settings \u0026 General","href":"/general/overview"},{"title":"Dashboard metrics","href":"/general/dashboard-metrics"},{"title":"Integrations \u0026 Sign-on","href":"/general/integrations"},{"group":"Company Settings","pages":[{"title":"Company Settings","sidebarTitle":"Overview","href":"/general/company-settings"},{"title":"General company settings","href":"/general/company-settings/general"},{"title":"Entities","href":"/general/company-settings/entities"},{"title":"Critical date categories","href":"/general/company-settings/critical-dates"},{"title":"Lease clause categories","href":"/general/company-settings/lease-clauses"},{"title":"Custom fields","href":"/general/company-settings/custom-fields"},{"title":"Lease, property, and file types","href":"/general/company-settings/types"},{"title":"Expense categories and accounts","href":"/general/company-settings/expenses"},{"title":"Tax codes","href":"/general/company-settings/tax-codes"},{"title":"Currency conversion rates","href":"/general/company-settings/currency-conversion"},{"title":"Headcount types","href":"/general/company-settings/headcount"},{"title":"Project settings","href":"/general/company-settings/projects"},{"title":"Transaction milestones","href":"/general/company-settings/transaction-milestones"},{"title":"SFTP credentials","href":"/general/company-settings/sftp"}]},{"title":"User Account \u0026 Access Settings","href":"/general/user-access"},{"title":"Security \u0026 Internal Controls","href":"/general/security"},{"title":"Sub-processors","href":"/general/sub-processors"}]},{"group":"API \u0026 Webhooks","pages":[{"title":"API overview","sidebarTitle":"API overview","href":"/api/overview"},{"title":"Webhooks","href":"/api/webhooks"}]},{"group":"Spacebase AI","pages":[{"title":"Spacebase AI","href":"/ai"},{"title":"AI Assistant","href":"/ai/assistant"},{"title":"AI Lease Abstraction","href":"/ai/lease-abstraction"},{"group":"AI Connectors","pages":[{"title":"AI Connectors (MCP)","description":"Connect Claude, ChatGPT, Gemini, Claude Code or Codex to your Spacebase portfolio over the Model Context Protocol.","href":"/ai/connectors"},{"title":"Connect an AI app","href":"/ai/connectors/connect"},{"title":"Tools reference","description":"What each Spacebase MCP tool returns, how results are paged, and how CSV exports work.","href":"/ai/connectors/tools"}]}]},{"group":"Release notes","pages":[{"title":"Release notes","href":"/release-notes"}]}]}]},"basePath":"","title":"Connect an AI app - Spacebase Help Center","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":[],"chunks":[]}