Getting started

Connect via MCP

Model Context Protocol (MCP) lets you connect AI tools like Claude Desktop, Cursor, or Codex directly to your Bubble app's data. You'll generate a personal MCP URL in Buildprint, then add it to your AI client.

You'll need your Bubble app already connected to Buildprint and an MCP-compatible AI client installed. Buildprint is unable to offer specific support for setting up MCP servers.

Generate your MCP URL

  1. In Buildprint, select Create MCP Server.

  2. Choose a scope:

    • All projects: Access all Bubble apps in your workspace.

    • Specific projects: Access only some apps.

  3. Copy the generated MCP URL (it looks like https://mcp.buildprint.ai/mcp/<token>).

Your MCP URL contains a personal token. Never share it publicly or commit it to version control. This grants access to any projects you select.

Install in your AI client

Cursor (one-click)

Click the Install in Cursor button in Buildprint. Cursor will automatically add the MCP server.

Claude Desktop

Run this command in your terminal, replacing <url> with your MCP URL:

claude mcp add --transport http buildprint <url>

Other clients

Add this JSON to your client's MCP configuration file:

{
  "mcpServers": {
    "buildprint": {
      "transport": "http",
      "url": "https://mcp.buildprint.ai/mcp/<token>"
    }
  }
}

Manage MCP servers

View your active MCP servers and usage stats at /agent/mcp in Buildprint. You can revoke any server at any time.

Troubleshooting

  • Unauthorized error: Your MCP token may have been revoked. Generate a new URL in Buildprint.

  • No project found: Make sure your scope matches the Bubble app you're querying. Try "All projects" if unsure.

Was this helpful?