mdbase

mdbase MCP

Set up mdbase MCP

Connect an AI client to the mdbase collections you approve, through one remote MCP endpoint.

What it does

mdbase MCP is a remote Model Context Protocol server. An MCP client, such as Claude, uses it to read and change records in mdbase collections you have approved. It works the same way whether a collection is hosted by mdbase Connect or stays on your computer and is served by the Connector.

The client never receives your Connect account. You approve one collection at a time, with the exact operations you want to allow, and you can revoke that approval from Connect at any time.

Before you start

  • An mdbase Connect account. Sign up if you do not have one.
  • At least one collection. A hosted collection works immediately. A collection on your computer needs the Connector running and online whenever the client uses it.
  • An MCP client that supports remote servers over Streamable HTTP with OAuth sign-in, including dynamic client registration and PKCE.

Add the server to your client

Every client uses the same endpoint:

MCP endpoint
https://mcp.mdbase.dev/mcp

In Claude on the web or desktop, add it as a custom connector. In Claude Code, add it from a terminal:

terminal
claude mcp add --transport http mdbase https://mcp.mdbase.dev/mcp

Other clients have their own screens for adding a remote MCP server. Give them the endpoint above. There is no API key to paste in. The client discovers the sign-in flow from the server.

Approve a collection

When the client first connects, it opens a browser window for sign-in.

  1. Sign in to mdbase Connect.
  2. Choose one collection.
  3. Review the permissions. Read this collection is required. Create records, Edit records, Delete records and Manage definitions are optional, and you can leave any of them out. They appear when the client asked for write access, which it does by default.
  4. Approve. The browser returns you to your client.

Each approval covers one collection. To use more than one, ask the client to connect another collection after setup. See Connect more collections.

Check the connection

Ask your client something that needs the collection:

prompt
List my mdbase collections, then describe the first one.

The client should call list_connections and then describe_collection. list_connections shows each collection's approved operations and whether it is local or hosted;describe_collection returns its types, fields and contracts.

Next steps