MCP Setup — Claude Desktop

This guide walks you through connecting the Vibe BI MCP Server to Claude Desktop. The same server URL (https://mcp.vibe-bi.ai) works with any MCP-compatible client.

Prerequisites

• A Vibe BI account with at least one connected database.
• Claude Desktop installed on your machine.

Method 1: Connectors UI (Recommended)

1. Open Connectors

In Claude Desktop, go to Chat > Customize > Connectors. Click the + icon in the top-right corner and select Add custom connector.

2. Add the Vibe BI connector

Fill in the following fields:

Field	Value
Name	Vibe BI
Remote MCP server URL	https://mcp.vibe-bi.ai

Click Add.

3. Authenticate

Claude Desktop will open a browser window for you to log in with your Vibe BI account. After granting access, you’re all set.

Method 2: JSON Config

1. Open Claude Desktop config

Navigate to Settings > Developer > Edit Config. This opens the claude_desktop_config.json file.

2. Add the Vibe BI MCP server

Add the following to the mcpServers section of your config file:

{
  "mcpServers": {
    "vibe-bi": {
      "url": "https://mcp.vibe-bi.ai"
    }
  }
}

3. Save and restart Claude Desktop

Save the config file and restart Claude Desktop. You should see “vibe-bi” appear in the MCP servers list. The first time you use a Vibe BI tool, Claude Desktop will open a browser window for you to authenticate.

Usage

Once connected, you can ask Claude questions about your data:

“Using Vibe BI, what were our top 10 customers by revenue last quarter?”

“Search my database tables for anything related to user signups”

“List all my saved dashboards in Vibe BI”

Claude will automatically use the appropriate MCP tool to answer your question.

Follow-up questions

The ask_question tool supports conversation threads. When you ask a follow-up, Claude passes the thread_id from the previous response to maintain context:

“Now break that down by region”

“Show me the monthly trend instead”

Troubleshooting

”Not authenticated” error

Your OAuth token may have expired. Restart Claude Desktop to trigger a fresh authentication flow.

”No active connection” error

Make sure you have an active database connection in Vibe BI. Log in to app.vibe-bi.ai and verify your connection is set as active.

Slow responses from ask_question

The ask_question tool runs a full AI pipeline (table selection, SQL generation, execution). This typically takes 10–30 seconds but can take up to 2 minutes for complex queries. Other tools (list_tables, search_tables, etc.) respond in under 2 seconds.