Skip to content
Docs Connect Claude, ChatGPT or Claude Code

Connect Claude, ChatGPT or Claude Code

Connect Claude, Claude Code or ChatGPT to Base Captain once, then make your base from a chat, change it there and open it with a link.

Make and change your base from Claude or ChatGPT

Connect Claude or ChatGPT to Base Captain once, and ask in your own words, such as "Make me a base for my hair salon", "Add an Allergies field to the clients" or "Which appointments do I have tomorrow?". Your AI makes the base, changes it and works in it as you, in every base where you have a role, or in the one base you choose. When you want to see a base, it gives you a link that opens it in your browser. For a prompt to start with, see Copy a prompt to start.

Every AI client connects to Base Captain's MCP server at the same address: https://www.basecaptain.com/mcp. You sign in once, on a Base Captain page that opens, and choose what it reaches; there is no token to copy. You need not sign up: click Continue without signing up, and your AI makes temporary bases for you (A temporary base made from a chat).

Connect Claude

Claude connects to Base Captain as a custom connector, added on the web at claude.ai or in the Claude app on your computer. Claude on your phone then has it too; you cannot add it from the phone. Every Claude plan may add it; on the Free plan you may add one custom connector.

  1. In Claude, click Customize, then Connectors.
  2. Click + Add, then Add custom connector.
  3. Enter the name Base Captain and the address https://www.basecaptain.com/mcp, and click Continue. Keep the sign-in settings that Claude finds, and click Add.
  4. Click Connect beside Base Captain, if Claude does not connect at once. On the Base Captain page that opens, sign in, sign up or click Continue without signing up, then click Allow (Sign in and allow your AI).
  5. Start a new chat. Turn on Base Captain under Connectors in the + menu, if it is off, and ask, or send the prompt (Copy a prompt to start).

On the Team and Enterprise plans, an owner of your organization in Claude adds Base Captain first, in Organization settings, Connectors: Add, Custom, Web, with the same name and address. Then each user finds it in Customize, Connectors and clicks Connect, and signs in as themselves.

Connect Claude Code

Claude Code connects to Base Captain with one line in a terminal. Another AI client that connects to an MCP server by its address, with a sign-in, uses the same address, the same way.

  1. In a terminal, in the folder where you use Claude Code, run claude mcp add --transport http basecaptain https://www.basecaptain.com/mcp. Add --scope user to have it in every folder.
  2. Start Claude Code, run /mcp, select basecaptain and select Authenticate. On the Base Captain page that opens in your browser, sign in, sign up or click Continue without signing up, then click Allow (Sign in and allow your AI).
  3. Ask, or send the prompt (Copy a prompt to start). Claude Code asks you before it uses one of the tools.

Codex, Cursor and other clients

The lines for Codex and for other clients are in Settings, API tokens, under Connect an AI client, with copy buttons. For Codex, copy Codex, a [mcp_servers.basecaptain] block with the address, to the end of ~/.codex/config.toml, then run codex mcp login basecaptain. For another client that takes MCP servers as JSON, such as Cursor, copy Other clients (JSON) into the client's MCP settings; it opens the sign-in page when it first connects.

Connect ChatGPT

ChatGPT connects to Base Captain as a custom MCP server from Plugins, on the web only; you do not need developer mode. On the Business, Enterprise and Edu plans, ChatGPT makes and changes your bases through it. On Business, an admin or an owner of your ChatGPT workspace adds Base Captain; on Enterprise and Edu, a user they allow can add it too. Other users of the workspace get it when an admin or an owner publishes it for the workspace.

  1. In ChatGPT on the web, open Plugins, click the + button, then Add custom MCP server. If you do not see it, ask the admin of your workspace for the permission.
  2. Enter the name Base Captain. Under Connection, enter the address https://www.basecaptain.com/mcp, and choose OAuth to sign in.
  3. Read the warning, select I understand and want to continue, and click Create as a plugin.
  4. Install the plugin. On the Base Captain page that opens, sign in, sign up or click Continue without signing up, then click Allow (Sign in and allow your AI).
  5. In a new chat, type @, select Base Captain, and ask, or send the prompt (Copy a prompt to start). Select it again in a later message that needs it.

On the Pro plan, ChatGPT may only read through a server you connect this way, so it cannot make or change a base. The Free plan cannot connect one.

Sign in and allow your AI

The first time your AI connects to Base Captain, a Base Captain page opens at www.basecaptain.com, where you sign in, choose what it reaches and allow it.

  1. If you are not signed in, sign in with your password, a code we mail you, or Google or Microsoft. Or sign up with your email and the code we mail you, or with Google or Microsoft (Sign up for Base Captain). Or click Continue without signing up and pass the check that you are a person.
  2. The page names your AI and its address, such as Claude and claude.ai, and says "It will work as you, <your name>, with your role in each base." If you continued without signing up, it says "It will work in the temporary bases it makes for you.", and you choose nothing more.
  3. Under Bases, choose All your bases, or one of your bases. With all your bases, select It can create bases to let it make new bases for you, each yours, on the Free plan. When you have no base yet, it is selected for you. Your AI with one base works in that base alone and cannot make bases.
  4. Check that the AI and its address are the ones you expect, and click Allow. Click Deny to send it away with nothing.

Limits and details

  • Your AI stays connected until you revoke its token (Disconnect your AI).
  • Connecting the same AI again replaces the earlier connection, with what you choose then. To change what it reaches, connect it again.
  • Each connection is one of your API tokens. You may have up to 50 API tokens, your AIs' connections among them.
  • All your bases means the bases where you have a role now and those you join later. When you leave a base, a connection to that base alone is removed.

Copy a prompt to start

To make your first base from a chat, connect your AI to Base Captain (Connect Claude, Connect Claude Code, Connect ChatGPT), then send it this prompt in a new chat:

Use Base Captain to make me a base for my hair salon: the appointments, the clients and the services. Give me the link to open it, then help me change it to fit how I work.

Put your own business in place of the hair salon, and what you keep track of in place of the appointments, the clients and the services.

Claude, ChatGPT and Claude Code connect at the same address:

https://www.basecaptain.com/mcp

What your AI does with the prompt

After the prompt, your AI finds the app for your business, makes the base with its sample data and gives you a link that opens it in your browser. Then ask it for the changes you want, such as "Add an Allergies field to the clients", and it makes them in the base (What your AI can and cannot do).

If you signed in and allowed it to create bases, your AI asks you for your base's name, and makes your base on the Free plan, and it stays (What the Free plan includes).

If you continued without signing up, the base your AI makes is temporary:

  • It closes 24 hours after it is made, and only its assistant uses AI. Your AI tells you the time it closes.
  • It sends no mail, and has no user but you.
  • To keep it, ask your AI for the link to keep it. Open the link, sign up, or sign in if you are a user already, then check your base's name, and you keep the base with all you put in it (Keep a temporary base as your own).

What else a temporary base does not do, and when it is deleted: Make a temporary base with no sign-up.

Fix a connection that fails

When connecting your AI to Base Captain fails, find what it says here:

  • The Base Captain page does not open when you connect: your browser blocked the pop-up. Allow pop-ups for claude.ai or chatgpt.com, and click Connect again.
  • Your AI says the base is closed: a temporary base closes 24 hours after it is made. Open the keep link your AI gives you, sign in, and keep it, on the Free plan (Keep a temporary base as your own). 24 hours after it closes, it is deleted and cannot be kept: ask your AI to make a new one.
  • Claude says the connection failed, or every call is refused: remove Base Captain in Claude and add it again (Connect Claude), and revoke its old token in API tokens (Disconnect your AI). You may have at most 50 API tokens: revoke one you no longer use.
  • Your AI says there is no such base, or cannot make a base: you allowed it one base alone, or all your bases without It can create bases. Connect it again and choose what it needs.
  • Claude does not let you add Base Captain: on Claude's Free plan you may add one custom connector. Remove the other one first, or use another plan.

Disconnect your AI

To disconnect your AI from Base Captain, remove it in the AI, then revoke its token in Base Captain, which ends its access. Removing Base Captain in Claude or ChatGPT alone does not end its access.

In Claude, click Customize, then Connectors, and click Remove or the three dots beside Base Captain. On the Team and Enterprise plans, an owner removes it for everyone in Organization settings, Connectors. In Claude Code, run claude mcp remove basecaptain. In ChatGPT, remove it where you added it.

Then, in Base Captain:

  1. In any of your bases, click Settings, then API tokens under Personal. At www.basecaptain.com, click Settings at the foot of the page, then the tab API tokens. Each AI you allowed is listed by its name, marked AI client, with what it reaches and when it was last used.
  2. Click the bin beside it, then Revoke token. Its next call is refused. To use it again, connect it again.

Connect a client that cannot sign in

An AI client that cannot sign in sends one of your API tokens with every call instead, to the same address, https://www.basecaptain.com/mcp.

  1. Click Settings, then API tokens, then New token. Name it for the client, such as "My client", and choose its bases (Make an API token for a program).
  2. Leave the page open: the token is shown only until you leave it. Under Connect an AI client, copy Header, for a client that cannot sign in, with your new token filled in, into the client's settings.

The token shows in API tokens as any other, and you revoke it there.

Get help with your AI

For help with connecting your AI to Base Captain, write to [email protected]. Say which AI you use and what it said.

Loading