Documentation

Connect your AI to Base.

Base exposes every Base you own or were sent as a remote MCP server. Connect once and your AI can search your Bases, read the sources behind every fact, and, where your role on a Base allows it, comment, add documents and edit them.

The short way: one line for your AI

Paste this into the AI you want to connect. It reads the setup page, works out where it runs, and does the setup that fits, asking you only to sign in.

Set up Base by following https://createbases.com/llms.txt

The rest of this page is the same setup by hand, app by app.

Try Base before connecting

Every new account starts with a Base Tutorial, a Base whose pages explain what Base can do, so there is a cited answer to inspect right away. Connecting an AI for the first time adds 50 credits to your Personal workspace. Quick answers from your AI are free, and deeper answers use the credits of the workspace that holds the Base. You can use Base in your browser without connecting one.

What Base is

Base is a shared, self-improving knowledge base that a team, and the people it works with, work in toward a goal. Base reads the documents into a cited knowledge index, each person joins with a role, and everyone works from the same Base in a browser or their own AI. The connector is that Base for AI apps: a remote MCP server your assistant can query and, where your role allows, add to.

The connector is free and is not required to read a shared Base. Pasting a share link into any chat already works. Connecting adds live search, following a Base for updates, commenting where the owner allows it, adding and editing documents if the owner made you a contributor, and reaching every Base sent to your email address from one connection.

In Claude and ChatGPT, add it from the directory

Base is listed in the Claude connector directory and the ChatGPT plugin directory, so there is no URL to paste and no advanced settings to leave blank. Sign-in and the consent screen below are the same either way.

  • Claude: open the Base listing and press Connect, or find it under Customize → Connectors → Browse connectors.
  • ChatGPT: open the Base Knowledge listing, press +, and connect it when ChatGPT asks, or open Plugins in ChatGPT and search for Base Knowledge.

On Claude Team and Enterprise plans, an Owner adds or enables connectors for the organization first, and each member then connects with their own account. In a ChatGPT Business, Enterprise or Edu workspace, the admin decides which plugins members can add. In every other app, the connector URL below is the way in.

Connector URL and authentication

The connector is a remote MCP server over Streamable HTTP at:

https://createbases.com/api/mcp

  • Authentication is OAuth 2.1 with dynamic client registration and client ID metadata documents. There is no client ID or secret to enter; leave every optional or advanced OAuth field blank.
  • Signing in sends a one-time link to your email. A Base consent screen follows it, and the connection is not live until you press Allow there.
  • In Claude Code: claude mcp add --transport http createbases https://createbases.com/api/mcp && claude mcp login createbases
  • In Codex: codex mcp add createbases --url https://createbases.com/api/mcp && codex mcp login createbases

Setup, app by app

Hosts move these settings around on their own schedule. If a menu is not where a step says, search the app's settings for “connector” or ask the assistant itself to walk you through its current flow.

Claude

https://claude.ai/directory/createbases

  1. Open the Base listing in the Claude connector directory, or find it under Customize → Connectors → Browse connectors and search for Base.
  2. Press Connect on the listing.
  3. Complete the Base magic-link sign-in, then press Allow on the Base consent screen.
  4. Ask your AI to list your Bases. Ones sent to your email address are in that list too, with no link to paste.

If your workspace has the directory turned off, add it by hand instead:

  1. Open Claude and go to Customize → Connectors.
  2. Choose Add → Add custom connector, name it Base, paste the Base connector URL, and leave the advanced settings blank.
  3. Complete the Base magic-link sign-in, then press Allow on the Base consent screen.
  4. Ask your AI to list your Bases. Ones sent to your email address are in that list too, with no link to paste.

ChatGPT

https://chatgpt.com/plugins/plugin_asdk_app_6aebbd3a8a6c81919a191445b7a31014

  1. Open the Base Knowledge listing in the ChatGPT plugin directory, or open Plugins in ChatGPT and search for Base Knowledge.
  2. Press + on the listing to add it, and Connect if ChatGPT asks.
  3. Complete the Base magic-link sign-in, then press Allow on the Base consent screen.
  4. Ask your AI to list your Bases. Ones sent to your email address are in that list too, with no link to paste.

If your workspace has the directory turned off, add it by hand instead:

  1. Open Plugins in ChatGPT, press +, choose Add custom MCP server, and name it Base.
  2. Paste the Base connector URL as the Server URL and leave Authentication set to OAuth.
  3. Press Create as a plugin, accepting ChatGPT's note about custom servers if it shows one, then complete the Base magic-link sign-in and press Allow on the Base consent screen.
  4. Ask your AI to list your Bases. Ones sent to your email address are in that list too, with no link to paste.

Grok

  1. Open grok.com/connectors and choose New Connector → Custom.
  2. Name it Base and paste the Base connector URL.
  3. Complete the Base magic-link sign-in, then press Allow on the Base consent screen.
  4. Enable Base for the conversation if Grok asks.
  5. Ask your AI to list your Bases. Ones sent to your email address are in that list too, with no link to paste.

Other

  1. Add the Base connector URL wherever your AI app accepts custom connectors.
  2. Complete the Base magic-link sign-in, then press Allow on the Base consent screen.
  3. Enable Base for the current conversation if your app requires it.
  4. Ask your AI to list your Bases. Ones sent to your email address are in that list too, with no link to paste.

Opening a Base once connected

Paste a share link into any chat and ask your assistant to open it. Ask it to follow the Base if you want to hear about changes. A Base sent to the email address you signed in with is already in your list, with no link to paste.

Connecting a team

Each person connects their own AI app and signs in as themselves, so one person's connection never gives anyone else access. What their AI can do on a Base is that person's role there: a viewer reads within the settings the owner chose, a contributor also adds and edits documents, and an admin also manages the Base. The owner adds people by email from the Base's share settings, or from a connected AI. Teammates can use different AI apps on the same Base; see how to share a team knowledge base across ChatGPT, Claude, and other AI tools.

What the tools can and cannot do

Reading tools cover your library and anything shared with you: listing and searching Bases, reading documents, the knowledge graph, timelines, contradictions, and comments. Writing tools create Bases, add files and comments, and manage task threads; they act only on Bases where you have that permission. Tools that can replace what readers see, cut off access, post in your name, or change a published page are marked so your AI app asks before running them. Earlier versions of a document are always kept and can be restored.

Every request is checked against the sender's permissions at the moment it is made. Access is deny by default: a claim publishes to you only when you can see every source behind it, and revocation or expiry cuts access on the next request.

Managing and revoking connections

To disconnect an AI app, remove Base from that app's connector settings. Keys made for agents without a browser are listed and revoked at Settings · Connect, and a revoked key stops working on its next request. An owner or admin who removes a person from a Base cuts that person's AI off on its next request too.

More