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
- Open Settings → MCP server (user menu at the bottom of the sidebar → My settings → MCP server).
- Click Create endpoint, give it a name (for example
Claude laptop) and pick the workspace the agent may work in. - 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).
- Settings → Apps & Connectors → Advanced settings, turn on Developer mode.
- Click Create, name the connector Basemind, paste the URL, choose No authentication and save.
- 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.