Embiro BI

Documentation › Integrations

AI assistants (ChatGPT and Claude)

Connect ChatGPT, Claude, Claude Code, Cursor or VS Code to Embiro BI so your AI assistant can answer questions from your dashboards, charts and datasets.

You can connect your own AI assistant to Embiro BI and ask it questions in plain language: "Which branches grew fastest last quarter?", "Build a bar chart of revenue by region and add it to the Sales dashboard", "Explain what the Loan portfolio dashboard shows". The assistant uses Embiro BI's tools to list and read your dashboards, charts and datasets, query data and, if you are allowed, create charts and dashboards.

It works through MCP (Model Context Protocol), the open standard AI assistants use to connect to other apps. Embiro BI's MCP address is:

https://app.embirobi.com/mcp

Who can do this: every member, for their own assistant. It is a plan feature ("AI assistant access"). You use your own AI subscription (ChatGPT, Claude and so on): Embiro BI doesn't charge for the AI.

What the assistant can do

The assistant acts as you, in one organization, with your permissions:

Your role The assistant can
Business User Read the dashboards, charts and datasets you can see; read their data only if your organization allows exports
Analyst, Admin, Super Admin Read everything you can, query data, run SQL (if you have SQL Lab), create and edit charts, datasets and dashboards, save queries; read alerts and reports if your plan includes them

It can never reach another organization's data, manage members or roles, or change settings.

Web assistants: ChatGPT and Claude.ai

Web assistants connect by signing you in to Embiro BI. No token to copy.

ChatGPT

  1. In ChatGPT, open Settings → Apps & Connectors → Advanced and turn on Developer mode.
  2. Back in Apps & Connectors, click Create.
  3. Name it Embiro BI, and enter the MCP address https://app.embirobi.com/mcp. Authentication: OAuth.
  4. Click Create. ChatGPT opens Embiro BI.

Claude.ai

  1. Open Settings → Connectors → Add custom connector.
  2. Name it Embiro BI and enter https://app.embirobi.com/mcp.
  3. Click Add, then Connect.

Then, in both:

  1. If asked, enter your organization's address (such as kampala-traders), and sign in as usual.
  2. Embiro BI shows which assistant is asking and which organization it will work in. Click Approve.
  3. You're back in the assistant, connected. Enable the connector in a chat (in Claude, from the tools menu) and ask away.

The connection stays signed in for up to 60 days of use. Settings → AI assistant lists your connected web assistants, with Disconnect to end one at once.

Desktop and coding assistants

Claude Desktop, Claude Code, Cursor and VS Code connect with a personal token.

  1. Open Settings → AI assistant and click Create token. Give it a name, such as My laptop.
  2. Copy the token now. It is shown only once.
  3. Choose your assistant on the same page: it shows the exact configuration with your token filled in. The configurations look like this:

The AI assistant page: choose your assistant, the address to use, connected assistants and tokens

Claude Code (terminal)
bash claude mcp add --transport http embiro-bi https://app.embirobi.com/mcp \ --header "Authorization: Bearer YOUR_TOKEN"
Claude Desktop

Settings → Developer → Edit Config, add to claude_desktop_config.json (needs Node.js), then restart Claude:

json { "mcpServers": { "embiro-bi": { "command": "npx", "args": ["-y", "mcp-remote", "https://app.embirobi.com/mcp", "--header", "Authorization:${AUTH}"], "env": { "AUTH": "Bearer YOUR_TOKEN" } } } }

Cursor

Add to ~/.cursor/mcp.json:

json { "mcpServers": { "embiro-bi": { "url": "https://app.embirobi.com/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

VS Code (with Copilot)

Add to .vscode/mcp.json:

json { "servers": { "embiro-bi": { "type": "http", "url": "https://app.embirobi.com/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

Claude Code on the web

Put this .mcp.json in a repository of its own (not your project's), set EMBIRO_MCP_TOKEN to your token in the cloud environment's settings (a personal environment, not a shared one), and start a new session on that repository:

json { "mcpServers": { "embiro-bi": { "type": "http", "url": "https://app.embirobi.com/mcp", "headers": { "Authorization": "Bearer ${EMBIRO_MCP_TOKEN}" } } } }

Treat the token like a password: never commit it to a repository or paste it in a chat. Revoke it on Settings → AI assistant if it leaks or you no longer need it. A token stops working when you leave the organization or the plan loses the feature.

Asking good questions

  • Name the dashboard, chart or dataset: "In the Sales dataset, what was revenue by branch in October?"
  • Ask it to show its working: "Which SQL did you run?"
  • Ask for a chart to keep: "Create a line chart of monthly revenue for 2026 and save it as 'Revenue trend'." Charts it saves appear in Embiro BI like any other.
  • Check important numbers against the dashboard before acting on them. AI assistants can misread a question.

Troubleshooting

The assistant sees only a "health_check" tool, or none
Disconnect and reconnect the connector so it loads the current tool list.
"Unauthorized" or the connection keeps asking to sign in
For a token, check it was copied whole, with Bearer in front. For web assistants, disconnect and connect again.
"AI assistant access is not included in your plan"
Your organization's plan doesn't include it. See Plans and features.
Too many requests
Each connection may make 120 requests a minute. Wait a moment and ask again.

Something unclear or missing? Tell us and we'll improve this page.