Integrations

Buildprint MCP, CLI and API access

Use Buildprint access tokens to connect an MCP client, the Buildprint CLI or your own software through the REST API.

Access tokens page showing project scope, use count and last-used time

Choose an access method

Create the token for the tool that will use it.

  • MCP connects AI clients such as ChatGPT, Claude and Cursor to Buildprint.

  • CLI lets you inspect and edit Bubble apps from a terminal.

  • API lets your own software call Buildprint's REST API.

These methods do not expose exactly the same actions. For Bubble data, public MCP tools can search, fetch and aggregate records. The CLI can also create, update and delete records when the token and project permissions allow editing.

Create an access token

Limit a token to the projects its client needs.

  1. Open Access tokens.

  2. Select Create token.

  3. Choose MCP, CLI or API.

  4. Choose all workspace projects or select individual projects.

  5. Select Create token.

  6. Copy the secret and store it in the client.

Creating an access token for MCP, CLI or API with workspace project scope

The full token secret is shown once. Store it securely and never include it in a screenshot, message or source code.

Choose project access

A token can access all projects in the workspace or only selected projects.

Use selected projects when one client does not need access to the complete workspace. The person creating the token must already have the required project access.

Manage tokens

The token list shows its project scope, number of uses, last-used time and creation date.

Revoke a token when a device, client or team member should no longer have access. Requests using that token stop working immediately.

Fix access problems

A token no longer works

Check that it has not been revoked and still includes the required project. Create a new token if the original secret was lost.

A tool can read but not change data

Check the selected access method and project permissions. Public MCP data tools are read-only; use the CLI or API with editing access for supported data changes.

A client cannot access one project

Check the token's project scope and the Buildprint permissions of the person who created it.

Was this helpful?
Was this helpful?