Base
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 a sender allows it, comment and contribute documents.

What Base is

Base turns a set of documents into a permissioned, shareable knowledge base. The owner uploads files, Base extracts a cited knowledge index, and a share link gives recipients a read-only site built from it. The connector is the same content for AI apps: a remote MCP server your assistant can query directly.

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, contributing documents where the sender switched that on, and reaching every Base sent to your email address from one connection.

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.
  • For MCP clients configured from a terminal: claude mcp add --transport http base https://createbases.com/api/mcp

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

  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

  1. Open Settings → Plugins, open Developer mode, and turn it on.
  2. Back in Plugins, choose + to add a new plugin, and name it Base.
  3. Paste the Base connector URL as the Server URL and leave Authentication set to OAuth.
  4. Acknowledge the custom server warning, press Create, then complete the Base magic-link sign-in and press Allow on the Base consent screen.
  5. Ask your AI to list your Bases. Ones sent to your email address are in that list too, with no link to paste.

Gemini

  1. Open Gemini and go to Settings → Apps & connections.
  2. Add a custom connection 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.
  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.

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, and additions never overwrite what is there. One tool, sheet editing, can replace cell contents and is marked destructive so hosts ask before running it.

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

Review active AI clients at Settings · AI connections. Revoking a connection stops that client from making new authenticated requests immediately.

More