Guide · MCP connection

Bluestars in your own AI assistant

Connect your dashboard to Claude, ChatGPT or another AI tool in three steps. Then ask about your customers, visitors and BSR segments right in your own conversation.

Your AI assistant Claude, ChatGPT, Copilot

The Bluestars connection bluestars.app/api/mcp

Your dashboard with your permissions

The address you use everywhere https://bluestars.app/api/mcp

How it works

Three steps, about five minutes

Copy the address

Above, or in the dashboard under Settings → API, on the AI assistants (MCP) card.

30 seconds

Add it to your tool

Paste the address as a connector or MCP server. Pick your tool below for the exact steps.

2 minutes

Sign in and allow access

Your tool opens a Bluestars page. Sign in with your dashboard account and click Allow.

1 minute

Step 2 in detail

Pick your tool

Claude (claude.ai and the desktop app)

Connector

Open Customize › Connectors (claude.ai/customize/connectors)
Click Add custom connector
Enter Bluestars as the name and https://bluestars.app/api/mcp as the MCP server URL
Click Add, then Connect next to Bluestars

Claude Team or Enterprise: only an Owner adds the connector, via Organization settings › Connectors › Add › Custom › Web. Each colleague then clicks Connect next to Bluestars in Customize › Connectors. On the free plan you can add one connector of your own.

ChatGPT

Plugin

In your browser, go to Plugins (chatgpt.com/plugins)
Click the + and choose Add custom MCP server
Enter Bluestars as the name and https://bluestars.app/api/mcp as the Server URL
Choose OAuth as the authentication
Choose I understand and want to continue, then Create as a plugin
Install the plugin. In a chat, pick it with @Bluestars

This works on chatgpt.com in the browser. If you use ChatGPT through work, your admin may have turned off custom MCP servers.

Claude Code

Plugin

The plugin installs the connection and a guide for your assistant in one go. Type in Claude Code:

/plugin marketplace add bluestars-org/bluestars-skill
/plugin install bluestars@bluestars

Cowork

Plugin

Open the Cowork tab, then Customize
Open the Plugins tab and click Add › Add marketplace › Add from a repository
Enter bluestars-org/bluestars-skill
Open Discover, pick Bluestars and click Add

Codex

Plugin

Type in your terminal:

codex plugin marketplace add bluestars-org/bluestars-skill
codex plugin add bluestars@bluestars

Microsoft Copilot, Cursor and others

MCP server

Look in the settings for Add MCP server, also called "remote MCP server" or "custom connector"
Paste https://bluestars.app/api/mcp
Choose OAuth if the tool asks how to sign in

You never enter an API key or password. You always sign in on the Bluestars page.

Done?

Try a first question

If the answer holds data from your own account, the connection works.

Help me set up my Bluestars account.Your assistant walks you through it: website, measurement script and customer postcodes.

How do my customers differ from my website visitors in BSR segments?Which type buys from you, and which type only looks.

Which pages does the blue segment visit most?Statistics per BSR segment.

Which accounts can I see?Useful when one email address gives you access to several Bluestars accounts.

Safe

You stay in control

Your permissions

The connection sees exactly what you see in the dashboard. Nothing more.

Nothing on your site

The connection never changes or publishes anything on your website.

Easy to undo

Remove the connector in your AI tool. Access then expires on its own.

Not working?

Quick fixes

The sign-in window does not open

Allow pop-ups for your AI tool and try connecting again.

The sign-in link does not arrive

Check your spam folder. A link is valid for 30 minutes; otherwise request a new one.

"I am not allowed to see that"

Your account has no access to that part, or it is not in your plan. Ask your team manager for the permission.

The connector says "not connected"

Remove it and add it again. You then sign in again.