Connect Bruin Cloud MCP to Claude Code

Set up the Bruin Cloud MCP so your AI agent can query pipelines, inspect runs, and trigger actions in Bruin Cloud directly from your terminal.

Connect the MCP

1) Create an API token

  1. Go to Bruin Cloud and open Team Settings
  2. Navigate to Team Members and scroll to Create API Token
  3. Give the token a name and select the permissions you need
  4. Click Create and copy the token - it will only be shown once

2) Add the MCP to Claude Code

Run the following command in your terminal, replacing YOUR_TOKEN_HERE with the token you just created:

claude mcp add --transport http bruin_cloud https://cloud.getbruin.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN_HERE"

This configures Claude Code to communicate with Bruin Cloud via the MCP protocol.

3) Query your pipelines

Open Claude Code inside a Bruin project and ask questions like:

"Use Bruin Cloud MCP and tell me which pipelines are enabled."

The agent will make API calls to Bruin Cloud and return the information.

4) Trigger runs

You can also ask the agent to trigger pipeline runs:

"Create a full refresh of the stock_market_prices asset."

The agent may ask for confirmation before executing, especially when there are similarly named assets. It will also provide a link to monitor the run in Bruin Cloud.

5) Be careful with prompts

Be specific when triggering actions. A vague prompt like "do a full refresh" could create a large backfill job spanning months of data. Always specify:

  • Which asset or pipeline to run
  • The date range if applicable
  • Whether you want a full refresh or incremental run

Sign up to our newsletter

Practical updates on open-source data pipelines, AI analysts, governance, and what we are shipping at Bruin.