AI agents

Connect an agent (MCP)

Basemind is an MCP server. The Model Context Protocol lets AI clients such as Claude, ChatGPT, Codex, Cursor, Windsurf and Grok call tools in Basemind: read table schemas, create fields and rows, query data, build applications and dashboards, write project memory and publish reports.

1. Create an endpoint

  1. Open Settings → MCP server (user menu at the bottom of the sidebar → My settings → MCP server).
  2. Click Create endpoint, give it a name (for example Claude laptop) and pick the workspace the agent may work in.
  3. Optional: enable Full access. On projects in Assisted mode, writes from this endpoint are then applied immediately instead of waiting for approval. They are still logged and can be undone. Projects in Safe mode stay read-only.

2. Copy the URL

Each endpoint has two URLs:

URL Transport Use it for
https://your-server/mcp/<key>/mcp Streamable HTTP Every modern client. Use this one.
https://your-server/mcp/<key>/sse Server-sent events (legacy) Older clients that only support SSE.

The URL is a secret. Anyone who has it can act in the workspace with your permissions. Do not paste it in shared chats or commit it to Git. Delete the endpoint in settings to revoke it immediately.

3. Add it to your client

In the examples below replace YOUR_ENDPOINT_URL with the URL from step 2.

Claude Code

claude mcp add --scope user --transport http basemind YOUR_ENDPOINT_URL

Run /mcp inside Claude Code to check that basemind is connected.

Claude (claude.ai, desktop and mobile)

Open Settings → Connectors → Add custom connector, name it Basemind and paste the URL. Enable it for a chat from the tools menu.

Older Claude Desktop versions can use claude_desktop_config.json (Settings → Developer → Edit Config) and restart Claude:

{
  "mcpServers": {
    "Basemind MCP": {
      "command": "npx",
      "args": ["mcp-remote", "YOUR_ENDPOINT_URL"]
    }
  }
}

ChatGPT

Needs a paid plan (Plus, Pro, Business, Enterprise or Edu).

  1. Settings → Apps & Connectors → Advanced settings, turn on Developer mode.
  2. Click Create, name the connector Basemind, paste the URL, choose No authentication and save.
  3. Enable the connector in a chat from the tools menu.

Codex

codex mcp add basemind --url YOUR_ENDPOINT_URL

or add to ~/.codex/config.toml:

[mcp_servers.basemind]
url = "YOUR_ENDPOINT_URL"

Cursor

Cursor settings → MCP → Add MCP Server:

{
  "mcpServers": {
    "Basemind MCP": { "url": "YOUR_ENDPOINT_URL" }
  }
}

Windsurf

Windsurf Settings → Advanced Settings → Cascade → edit the raw mcp_config.json:

{
  "mcpServers": {
    "Basemind MCP": { "serverUrl": "YOUR_ENDPOINT_URL" }
  }
}

Grok

Go to grok.com/connectors → New Connector → Custom, name it Basemind and paste the URL. With the xAI API, pass the URL as server_url of a remote MCP tool.

Any other client

Any MCP client that supports remote servers over Streamable HTTP works. No OAuth or API key is needed: the key is part of the URL.

4. Try it

Ask your agent:

  • “Which databases and tables do I have in Basemind?”
  • “Create a Tasks table with Title, Status (To do, Doing, Done), Owner and Due date fields.”
  • “List my projects and give me the briefing of the Launch project.”

Troubleshooting

Problem Fix
The client says the server is unreachable Check that the server is reachable from where the client runs (claude.ai and ChatGPT connect from the internet, so localhost does not work).
claude.ai says the connector is invalid Use the /mcp URL, not the /sse URL.
Tools are listed but writes do nothing The project is in Assisted mode and the change waits for approval in Agent activity, or it is in Safe mode. See Autonomy & approvals.
The agent cannot see a table For project tools the table’s database must be attached to the project.
You leaked the URL Delete the endpoint and create a new one.

See all available tools in the MCP tool reference.