**MCP** ([Model Context Protocol](https://modelcontextprotocol.io)) è uno standard aperto perché un
assistente IA (Claude Desktop, Claude Code, Cursor, o un tuo agente) usi strumenti esterni in modo
strutturato, invece che tramite testo libero. **Nuntius** ha un **proprio server MCP**: espone il
tuo account — leads, contatti, conversazioni, appuntamenti e ticket — come un insieme di *tool* che il tuo
assistente può leggere e, con la tua conferma, scrivere.

## Cos'è

- Un **adattatore deterministico**, senza un proprio modello linguistico: l'LLM che decide quale tool
  chiamare vive sempre nel tuo client (Claude Desktop, Claude Code, Cursor…), mai in questo server.
- **Esattamente ciò che permette la API pubblica** (`/public/v1`), non un endpoint in più — i suoi tool
  sono generati leggendo la stessa definizione OpenAPI che documenta il
  [riferimento REST](/it/api/getting-started/), quindi qualsiasi cosa tu possa fare via MCP potresti farla
  anche con una chiamata `curl` diretta alla API. Vedi il [catalogo completo dei tool](/it/mcp/tools/).
- **Senza accesso al tuo database, né a nessun dato che la API non esponga già**: ogni chiamata di un tool
  inoltra la tua stessa chiave API a `/public/v1`, così com'è — il server MCP non salva la tua chiave e non
  ha nessun'altra via di accesso al tuo account. Tutto il controllo (permessi, piano, limiti, isolamento
  per account) lo applica la API, non questo adattatore.

## Cosa non è

**Non confonderlo con i "server MCP esterni"** che puoi collegare al tuo agente IA da
**Impostazioni → Server MCP** (BYO-MCP) — vanno nella direzione opposta:

| | Server MCP di Nuntius (questa sezione) | Server MCP esterni (BYO-MCP) |
| --- | --- | --- |
| Direzione | Espone **il tuo account Nuntius** al tuo assistente IA esterno | Inserisce strumenti **di terzi** dentro l'agente IA del tuo account |
| Chi lo collega | Tu, dal tuo client MCP (Claude Desktop, Claude Code, Cursor…) | Tu, dalla Piattaforma, perché li usi l'agente che serve i tuoi clienti |
| Dove si configura | Nella configurazione del tuo client MCP (vedi [Collega il tuo assistente](/it/mcp/connect/)) | In **Impostazioni → Server MCP** della Piattaforma |

Se quello che cerchi è dare al tuo agente IA accesso a strumenti esterni (il tuo CRM, il tuo catalogo, il
tuo calendario…), è l'altro componente — consulta la guida
**[Impostazioni e integrazioni](/it/guides/ajustes-integraciones/)**, sezione 8. Questa sezione
riguarda l'opposto: dare al **tuo assistente IA** accesso a **Nuntius**.

## Requisiti

- **Piano Pro o Enterprise** — con il piano Starter, ogni tool risponde con lo stesso
  `403 PLAN_NOT_ELIGIBLE` della API pubblica (vedi [Piani e limiti](/it/api/plans-and-limits/)). Il server
  continua sempre a elencare il tool `nuntius_status` perché il tuo client possa mostrare un messaggio chiaro
  sul perché non c'è altro.
- **Una chiave API** con gli scope delle risorse che vuoi usare — lo stesso meccanismo, e la stessa
  schermata, della chiave che useresti per chiamare `/public/v1` direttamente (guida
  **[Chiavi API](/it/guides/claves-api/)**, catalogo completo degli scope in
  **[Autenticazione](/it/api/authentication/)**). I tool che vede il tuo client MCP sono esattamente
  quelli che la tua chiave può usare — niente di più.

## Come funziona, in tre passi

```
Il tuo client MCP (Claude Desktop / Claude Code / Cursor / un tuo agente)
      │  Streamable HTTP, header X-API-Key: <la tua chiave>
      ▼
Server MCP di Nuntius  (senza database, senza stato, senza LLM proprio)
      │  inoltra la stessa chiave, chiamata dopo chiamata
      ▼
API pubblica di Nuntius  (/public/v1 — qui si decide tutto: permessi, piano, limiti)
```

Continua con **[Collega il tuo assistente](/it/mcp/connect/)** per i blocchi di configurazione concreti.
Se vuoi anche che il tuo backend parli direttamente con l'API pubblica, con la stessa chiave, vedi **[La
mia IA e il mio backend, che parlano con i miei dati](/it/api/mi-ia-y-mi-backend/)**.