# Connect Claude, ChatGPT or Cursor (https://docs.getbeel.com/en/guide/connect-ai)

How to connect your AI assistant to Getbeel, step by step.

*Video tutorial coming soon.*

Getbeel connects to AI assistants through MCP, the standard that lets an assistant use outside tools. You add one address and sign in with your Getbeel account: no key to copy.

![The API keys & MCP page: test and live keys, permissions and the MCP server address.](/screenshots/api-keys-mcp.en.webp)

## Before you start [#before-you-start]

- **A Getbeel account** with a team where you can manage settings.
- **An assistant** that accepts remote MCP connectors: Claude (web, desktop or Claude Code), ChatGPT, Cursor.
- **The server address**: `https://www.getbeel.com/api/mcp`. You also find it in **Settings → API keys & MCP**.
- **No API key needed**: you sign in with your account.
- **Cost**: the MCP server has no separate charge. Invoices sent live to SDI follow the price list ([Pricing](/en/api/pricing)).

## Steps [#steps]

<Steps>
<Step>

### Add Getbeel to the assistant [#add-getbeel-to-the-assistant]

<Tabs items={['Claude', 'ChatGPT', 'Cursor', 'Claude Code']}>
<Tab value="Claude">

On claude.ai or in Claude Desktop, open **Settings → Connectors** and choose **Add custom connector**. Name `Getbeel`, URL `https://www.getbeel.com/api/mcp`. Then choose **Connect**.

</Tab>
<Tab value="ChatGPT">

In ChatGPT, open **Settings → Apps & Connectors** and turn on developer mode. Create a connector with URL `https://www.getbeel.com/api/mcp` and **OAuth** authentication. Then choose **Connect**.

</Tab>
<Tab value="Cursor">

In **Settings → MCP**, add a server, or create the file `.cursor/mcp.json`:

```json title=".cursor/mcp.json"
{
  "mcpServers": {
    "getbeel": {
      "url": "https://www.getbeel.com/api/mcp"
    }
  }
}
```

Then click **Needs login** next to the server.

</Tab>
<Tab value="Claude Code">

In the terminal:

```bash
claude mcp add --transport http getbeel https://www.getbeel.com/api/mcp
```

Then run `/mcp` in Claude Code and choose **Authenticate**.

</Tab>
</Tabs>

</Step>
<Step>

### Sign in to Getbeel [#sign-in-to-getbeel]

A Getbeel page opens: **Connect … to Getbeel**, with the app's name. Sign in, or create an account.

</Step>
<Step>

### Check where you go back to [#check-where-you-go-back-to]

The page shows where **Allow** takes you: the full host, such as `claude.ai`, or an app on your device.

Only Claude (`claude.ai`) and ChatGPT (`chatgpt.com`) are verified. For any other app, Cursor and Claude Code included, you see **Getbeel has not verified this app**. Allow it only if you started the connection yourself and you recognise the destination.

</Step>
<Step>

### Choose team, mode and permissions [#choose-team-mode-and-permissions]

- **Team**: the company the assistant works on.
- **Mode**: **Test** to try it out, nothing reaches SDI; **Live** for real invoices.
- **Permissions**: what it can read and do. The defaults are fine to start.

</Step>
<Step>

### Allow access [#allow-access]

Choose **Allow**. You go back to the assistant, already connected.

</Step>
<Step>

### Test the connection [#test-the-connection]

Ask: **"With Getbeel, who am I?"**. The assistant uses the `whoami` tool and answers with your company's name and the mode.

</Step>
</Steps>

## What just happened [#what-just-happened]

- **The assistant acts as you** on that team, with the permissions you chose.
- **In Test mode** it works in the sandbox: no invoice reaches SDI.
- **The connection shows up** in **Settings → API keys & MCP → Connected apps**, with when it was last used.

## Security [#security]

- **Start with Test.** Reconnect in **Live** only when you trust the flow.
- **Ask for confirmation before sending.** Keep tool approval on in the assistant, at least for `send_invoice`.
- **Revoke in a moment.** In **Connected apps**, choose **Revoke**: the assistant loses access at once.

<Callout type="warn">
  In **Live**, `send_invoice` issues a real invoice with fiscal value, and it
  cannot be undone. Check customer, amounts and VAT before you confirm.
</Callout>

## If it fails [#if-it-fails]

| Message                                                            | Cause                                                 | Fix                                                                       |
| ------------------------------------------------------------------ | ----------------------------------------------------- | ------------------------------------------------------------------------- |
| "This link is not valid"                                           | The connection request has expired or is not valid    | Go back to the assistant and connect it again                             |
| "To connect an app you need a team where you can manage settings." | You have no team, or your role cannot manage settings | Create a team or ask an owner for access                                  |
| "Getbeel has not verified this app"                                | The app is not Claude or ChatGPT                      | Continue only if you started the connection and recognise the destination |
| "Could not connect the app"                                        | The connection did not go through                     | Try again from the assistant                                              |
| The assistant does not find Getbeel                                | The connector is not on in the conversation           | Turn it on and start the request with "With Getbeel…"                     |

<Callout title="Assistant without sign-in?">
  Clients that only accept a header can use an API key: see the [MCP server
  reference](/en/api/mcp#with-an-api-key).
</Callout>

## Next steps [#next-steps]

<Cards>
  <Card title="Example prompts" href="/en/guide/example-prompts">
    What to ask the assistant, with the tools it uses.
  </Card>
  <Card title="MCP server" href="/en/api/mcp">
    All 128 tools, with scopes and arguments.
  </Card>
  <Card title="Sandbox" href="/en/api/sandbox">
    How to get every SDI outcome without sending anything.
  </Card>
</Cards>
