# Collega Claude, ChatGPT o Cursor (https://docs.getbeel.com/it/guide/connect-ai)

Come collegare il tuo assistente AI a Getbeel, passo per passo.

*Video tutorial in arrivo.*

Getbeel si collega agli assistenti AI con MCP, lo standard che permette a un assistente di usare strumenti esterni. Aggiungi un indirizzo e accedi con il tuo account Getbeel: nessuna chiave da copiare.

![La pagina Chiavi API e MCP: chiavi di test e live, permessi e indirizzo del server MCP.](/screenshots/api-keys-mcp.it.webp)

## Prima di iniziare [#prima-di-iniziare]

- **Un account Getbeel** con un team in cui puoi gestire le impostazioni.
- **Un assistente** che accetta connettori MCP remoti: Claude (web, desktop o Claude Code), ChatGPT, Cursor.
- **L'indirizzo del server**: `https://www.getbeel.com/api/mcp`. Lo trovi anche in **Impostazioni → Chiavi API e MCP**.
- **Non serve** una chiave API: accedi con il tuo account.
- **Costo**: il server MCP non si paga a parte. Le fatture inviate in live allo SDI seguono il listino ([Prezzi](/it/api/pricing)).

## Passi [#passi]

<Steps>
<Step>

### Aggiungi Getbeel all'assistente [#aggiungi-getbeel-allassistente]

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

Su claude.ai o in Claude Desktop apri **Impostazioni → Connettori** e scegli **Aggiungi connettore personalizzato**. Nome `Getbeel`, URL `https://www.getbeel.com/api/mcp`. Poi scegli **Connetti**.

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

In ChatGPT apri **Impostazioni → App e connettori** e attiva la modalità sviluppatore. Crea un connettore con URL `https://www.getbeel.com/api/mcp` e autenticazione **OAuth**. Poi scegli **Connetti**.

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

In **Settings → MCP** aggiungi un server, oppure crea il file `.cursor/mcp.json`:

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

Poi clicca **Needs login** accanto al server.

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

Nel terminale:

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

Poi esegui `/mcp` in Claude Code e scegli **Authenticate**.

</Tab>
</Tabs>

</Step>
<Step>

### Accedi a Getbeel [#accedi-a-getbeel]

Si apre una pagina di Getbeel: **Collega … a Getbeel**, con il nome dell'app. Accedi, o crea un account.

</Step>
<Step>

### Controlla dove torni [#controlla-dove-torni]

La pagina mostra dove ti porta **Consenti**: l'host completo, come `claude.ai`, o un'app sul tuo dispositivo.

Solo Claude (`claude.ai`) e ChatGPT (`chatgpt.com`) risultano verificate. Per ogni altra app, Cursor e Claude Code compresi, vedi **Getbeel non ha verificato questa app**. Autorizzala solo se hai avviato tu il collegamento e riconosci la destinazione.

</Step>
<Step>

### Scegli team, modalità e permessi [#scegli-team-modalità-e-permessi]

- **Team**: l'azienda su cui lavora l'assistente.
- **Modalità**: **Test** per provare, nulla arriva allo SDI; **Live** per le fatture vere.
- **Permessi**: cosa può leggere e fare. Per iniziare vanno bene quelli predefiniti.

</Step>
<Step>

### Consenti l'accesso [#consenti-laccesso]

Scegli **Consenti**. Torni all'assistente, già collegato.

</Step>
<Step>

### Prova il collegamento [#prova-il-collegamento]

Chiedi: **"Con Getbeel, chi sono?"**. L'assistente usa lo strumento `whoami` e risponde con il nome della tua azienda e la modalità.

</Step>
</Steps>

## Cosa è successo [#cosa-è-successo]

- **L'assistente agisce come te** su quel team, con i permessi che hai scelto.
- **In modalità Test** lavora nella sandbox: nessuna fattura arriva allo SDI.
- **Il collegamento compare** in **Impostazioni → Chiavi API e MCP → App collegate**, con l'ultimo utilizzo.

## Sicurezza [#sicurezza]

- **Parti da Test.** Ricollega in **Live** solo quando ti fidi del flusso.
- **Chiedi conferma prima di inviare.** Lascia attiva l'approvazione degli strumenti nell'assistente, almeno per `send_invoice`.
- **Revoca in un attimo.** In **App collegate** scegli **Revoca**: l'assistente perde subito l'accesso.

<Callout type="warn">
  In **Live** `send_invoice` emette una fattura vera, con valore fiscale, e non
  si annulla. Controlla cliente, importi e IVA prima di confermare.
</Callout>

## Se qualcosa non va [#se-qualcosa-non-va]

| Messaggio                                                                    | Causa                                                        | Cosa fare                                                                   |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------- |
| "Questo link non è valido"                                                   | La richiesta di collegamento è scaduta o non è valida        | Torna all'assistente e collegalo di nuovo                                   |
| "Per collegare un'app ti serve un team in cui puoi gestire le impostazioni." | Non hai un team, o il tuo ruolo non gestisce le impostazioni | Crea un team o chiedi l'accesso a un proprietario                           |
| "Getbeel non ha verificato questa app"                                       | L'app non è Claude o ChatGPT                                 | Continua solo se hai avviato tu il collegamento e riconosci la destinazione |
| "Impossibile collegare l'app"                                                | Il collegamento non è riuscito                               | Riprova dall'assistente                                                     |
| L'assistente non trova Getbeel                                               | Il connettore non è attivo nella conversazione               | Attivalo e inizia la richiesta con "Con Getbeel…"                           |

<Callout title="Assistente senza accesso?">
  I client che accettano solo un header possono usare una chiave API: vedi il
  [riferimento del server MCP](/it/api/mcp#con-una-chiave-api).
</Callout>

## Prossimi passi [#prossimi-passi]

<Cards>
  <Card title="Esempi di richieste" href="/it/guide/example-prompts">
    Cosa chiedere all'assistente, con gli strumenti che usa.
  </Card>
  <Card title="Server MCP" href="/it/api/mcp">
    Tutti i 128 strumenti, con scope e argomenti.
  </Card>
  <Card title="Sandbox" href="/it/api/sandbox">
    Come ottenere ogni esito SDI senza inviare nulla.
  </Card>
</Cards>
