Connect Bruin Cloud MCP to Claude Code

Overview

Goal - Connect the Bruin Cloud MCP to Claude Code so you can manage pipelines, inspect runs, and trigger actions using natural language from your terminal.

Audience - Data engineers who want to interact with Bruin Cloud programmatically through an AI agent.

Prerequisites

• Bruin CLI installed
• Claude Code installed
• A Bruin Cloud account with at least one pipeline deployed

Steps

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

Key takeaways

• The Cloud MCP lets you query pipeline status, inspect runs, and trigger actions from your terminal
• Always be specific when triggering runs to avoid unintended large backfills
• The agent will ask for confirmation before executing destructive or ambiguous actions

Helpful links

• Bruin Cloud MCP setup
• Bruin Cloud overview
• Video walkthrough