> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supamodel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Supamodel to Claude

> Add the Supamodel connector to Claude so you can ask questions about your business data.

## What this is

The Supamodel connector lets Claude read your business data. Once it's connected, you can ask Claude questions such as "How did sales compare to last month?" and it answers using your Supamodel data.

Each person connects Claude to Supamodel themselves. It takes about 5 minutes.

## Before you start

You need:

* A Claude account. Custom connectors are available on paid Claude plans.
* The Supamodel **client ID** we sent you with your login details.
* Your Supamodel sign-in. Depending on how your company is set up, this is your Google work account or the login details we gave you. See [Sign in with Google](https://docs.supamodel.io/google-sso/overview.md) for more.

> [!NOTE]
>
> If your company uses a Claude Team or Enterprise plan, an owner may need to add the Supamodel connector for your organisation first. If you don't see **Add custom connector**, ask your Claude owner.

## Add the connector

**1. Open your connectors**

In Claude, click **Customize** in the sidebar, then click **Connectors**.

Click **Add**, then **Add custom connector**.

![The Connectors tab in Claude with the Add menu open, showing Add custom connector](https://mintcdn.com/supamodel-io/kT26PCZg0L2cnVhD/images/claude-connector/add-custom-connector-menu.webp?fit=max\&auto=format\&n=kT26PCZg0L2cnVhD\&q=85\&s=8def83835e74bd64be8b5f42acfb379b)

**2. Enter the Supamodel details**

Enter these details:

* **Name**: `Supamodel`
* **Server URL**: `https://mcp.supamodel.io/mcp`

Click **Continue**.

![The Add custom connector window with Supamodel as the name and the Supamodel server URL](https://mintcdn.com/supamodel-io/kT26PCZg0L2cnVhD/images/claude-connector/add-custom-connector-dialog.png?fit=max\&auto=format\&n=kT26PCZg0L2cnVhD\&q=85\&s=dee94090744d00a8b2af8c4991a851e3)

**3. Continue past the server check**

Claude tries to check how Supamodel signs in. It shows **Couldn't check the server** with a **403** error. This is expected, because Supamodel needs your client ID first.

Click **Continue anyway**.

![Claude showing Couldn't check the server, with a Continue anyway button](https://mintcdn.com/supamodel-io/UDy1TbvCcg9XoCLg/images/claude-connector/server-check.png?fit=max\&auto=format\&n=UDy1TbvCcg9XoCLg\&q=85\&s=7973d4e40c340b750d4fa77a8543910a)

**4. Enter your client ID**

Leave the sign-in option as it is. Under **OAuth client**, select **Use your own OAuth client**.

* **OAuth client ID**: paste the client ID we sent you with your login details
* **OAuth client secret**: leave this empty

You don't need to add any request headers or change the **Advanced** settings. Click **Add**.

![The OAuth client settings with Use your own OAuth client selected and a client ID entered](https://mintcdn.com/supamodel-io/UDy1TbvCcg9XoCLg/images/claude-connector/oauth-client.png?fit=max\&auto=format\&n=UDy1TbvCcg9XoCLg\&q=85\&s=d6495c5aac63a3e6e3b1799e1c44d3b0)

**5. Connect**

Claude shows **You're not connected to Supamodel yet**. Click **Connect**.

![The Supamodel connector page with a Connect button](https://mintcdn.com/supamodel-io/kT26PCZg0L2cnVhD/images/claude-connector/connect.png?fit=max\&auto=format\&n=kT26PCZg0L2cnVhD\&q=85\&s=891f7ac3833e03ad46677d632cd36915)

**6. Continue connecting**

Claude asks **Finish connecting a connector?** You started this connection yourself, so click **Continue connecting**.

![Claude asking whether to finish connecting a connector](https://mintcdn.com/supamodel-io/kT26PCZg0L2cnVhD/images/claude-connector/finish-connecting.webp?fit=max\&auto=format\&n=kT26PCZg0L2cnVhD\&q=85\&s=b7d37000d798747590f62c11ffc078d8)

> [!WARNING]
>
> Only click **Continue connecting** if you've just clicked **Connect** yourself. If you see this screen when you weren't connecting anything, click **Not now**.

**7. Sign in to Supamodel**

Your web browser opens the Supamodel sign-in page. Type your work email and continue. If your company uses Google sign-in, Supamodel sends you to Google. Otherwise, enter the password we gave you.

**8. Go back to Claude**

If you use the Claude desktop app, your browser asks to open Claude. Click **Open "Claude"**.

![A browser prompt asking to open the Claude app](https://mintcdn.com/supamodel-io/kT26PCZg0L2cnVhD/images/claude-connector/open-claude.webp?fit=max\&auto=format\&n=kT26PCZg0L2cnVhD\&q=85\&s=246fb9a213d948511a0c03b6c1a82a07)

**9. Choose when Claude can use Supamodel**

You're now connected. The Supamodel page shows **Disconnect** and a list of tools under **Tool permissions**.

The Supamodel tools only read your data. They can't change anything. To stop Claude asking for permission every time, set **Other tools** to **Always allow**.

![The Supamodel connector page with Always allow selected for its tools](https://mintcdn.com/supamodel-io/kT26PCZg0L2cnVhD/images/claude-connector/tool-permissions.webp?fit=max\&auto=format\&n=kT26PCZg0L2cnVhD\&q=85\&s=6a2fb25881dc94126c1a3be82aa395c0)

If you'd rather approve each request, choose **Needs approval** instead.

## Check it works

Start a new chat in Claude and ask a question about your business, for example "What data does Supamodel have?" Claude uses the Supamodel connector to answer.

## Add the Supamodel skill (optional)

We may send you a skill file for your company, for example `yourcompany-analysis.zip`. A skill tells Claude how your data fits together, so its answers are more accurate.

**1. Open your skills**

In Claude, click **Customize** in the sidebar, then click **Skills**.

Click **Add**, then **Upload skill**.

![The Skills tab in Claude with the Add menu open, showing Upload skill](https://mintcdn.com/supamodel-io/kT26PCZg0L2cnVhD/images/claude-connector/upload-skill-menu.webp?fit=max\&auto=format\&n=kT26PCZg0L2cnVhD\&q=85\&s=594f5f7dbe83faacc69f2b6ca92b2ff6)

**2. Upload the file**

Drag the skill file we sent you into the box, or click to browse for it. Claude runs a security scan on the file.

Click **Upload**.

![The Upload a skill page with a box to drop skill files into](https://mintcdn.com/supamodel-io/kT26PCZg0L2cnVhD/images/claude-connector/upload-skill.webp?fit=max\&auto=format\&n=kT26PCZg0L2cnVhD\&q=85\&s=74ef71ff0e49604ff0c9a2f075d966e8)

Claude uses the skill automatically when you ask about your business data.

## Reconnect or disconnect

To **reconnect**, for example after your company switches to Google sign-in, go to **Customize** > **Connectors** > **Supamodel**. Click **Disconnect**, then **Connect**, and sign in again.

To **remove the connector**, click **Disconnect**. Claude can no longer read your Supamodel data.

## Troubleshooting

> [accordion] I don't see Add custom connector
>
> Custom connectors need a paid Claude plan. On a Team or Enterprise plan, your Claude owner may need to add the Supamodel connector for your organisation first.

> [accordion] The sign-in page says I don't have access
>
> Your account hasn't been set up yet, or you're signing in with a different email. Check you're using your work email, then contact us.

> [accordion] Claude asks me to sign in again
>
> This is normal if you haven't used Claude for a while, or if your company changed how you sign in. Click **Connect** and sign in again.

## Need help?

Contact us at [hello@supamodel.io](mailto:hello@supamodel.io).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.