Server MCP: collegare un assistente IA

Il server MCP di WbizTool permette a un assistente IA di lavorare con il tuo spazio di lavoro. Puoi chiedergli cose come "quali messaggi non sono riusciti oggi, e perché?", "metti in pausa il promemoria dell'affitto" o "invia i nuovi orari di apertura a questi cinque clienti", e lui usa il tuo account WbizTool per farle.

Parla il Model Context Protocol (MCP), che Claude Code, Cursor, VS Code e altri strumenti di IA capiscono. Dietro le quinte ogni azione è una chiamata all'API v2 fatta con la tua chiave API v2, quindi è la chiave a decidere cosa l'assistente può vedere e fare.

Cosa può fare un assistente#

L'assistente vede solo gli strumenti che la chiave consente (vedi gli scope):

Offre anche tre prompt pronti: daily summary (riepilogo del giorno), failed messages (messaggi non riusciti) e draft an announcement (bozza di un annuncio).

Non può collegare un nuovo numero (si fa sempre dalla dashboard), caricare file, gestire i webhook né leggere la tua casella Unibox.

1. Crea una chiave per l'assistente#

1. Apri la scheda Chiavi API v2

   In WbizTool, vai su Impostazioni → Chiavi API e trova la scheda Chiavi API v2.

2. Usa la preimpostazione per l'assistente IA

   Fai clic su Crea chiave v2, poi su Per un assistente IA. Crea una chiave in Sola lettura che può leggere messaggi e numeri e scade tra 90 giorni – un modo sicuro per iniziare: l'assistente può guardare, ma non può inviare né modificare nulla.

3. Consenti l'invio solo se lo vuoi

   Se l'assistente deve inviare messaggi o gestire promemoria, togli la spunta da Sola lettura e seleziona Inviare messaggi (e Promemoria se serve). Puoi anche limitare la chiave ad alcuni dei tuoi numeri.

4. Copia la chiave

   La chiave (wbz_live_…) viene mostrata una sola volta. Conservala in una variabile d'ambiente sul tuo computer, come WBIZTOOL_API_KEY – non incollarla mai in un file che condividi o di cui fai commit.

export WBIZTOOL_API_KEY=wbz_live_…

2. Aggiungi il server al tuo strumento di IA#

claude mcp add --transport http wbiztool https://mcp.wbiztool.com/mcp \
  --header "Authorization: Bearer ${WBIZTOOL_API_KEY}"

{
  "mcpServers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "wbiztool": {
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${env:WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "wbiztool-key", "description": "WbizTool API v2 key (wbz_live_…)", "password": true }
  ],
  "servers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wbiztool-key}" }
    }
  }
}

• Claude Code: esegui il comando una volta (aggiungi --scope project per condividerlo con un progetto tramite .mcp.json; il file contiene ${WBIZTOOL_API_KEY}, non la chiave).
• Cursor: mettilo in ~/.cursor/mcp.json, oppure in .cursor/mcp.json in un progetto.
• VS Code: mettilo in .vscode/mcp.json. VS Code chiede la chiave una volta e la conserva nel suo archivio dei secret.

Poi chiedi all'assistente qualcosa come "Qual è il mio account WbizTool?" – dovrebbe rispondere con il nome e il piano del tuo spazio di lavoro.

3. Come gli invii restano sicuri#

• Ogni invio passa prima da un'anteprima. Quando chiedi un messaggio, l'assistente riceve prima un'anteprima da WbizTool – da quale numero parte, a chi, il testo esatto, l'eventuale file, quando – e non è ancora stato inviato nulla. Ha l'istruzione di mostrarti l'anteprima e attendere il tuo sì. Solo allora invia, esattamente ciò che hai visto.
• Un nuovo tentativo non invia mai due volte. Se l'assistente ripete un invio confermato (per esempio dopo un timeout), WbizTool risponde con il messaggio già inviato.
• La chiave è il limite invalicabile. Una chiave in sola lettura non può inviare affatto. Una chiave senza Inviare messaggi non vede nemmeno gli strumenti di invio, e una chiave limitata ad alcuni numeri non può usare gli altri. Valgono anche i limiti di WbizTool: 60 richieste al minuto per chiave e al massimo 1.000 messaggi al giorno per numero.
• Il testo di altre persone è contrassegnato come dati. Messaggi, nomi e file arrivati dall'esterno raggiungono l'assistente contrassegnati come non attendibili, e lui ha l'istruzione di non seguire mai le istruzioni che contengono.
• Nessun segreto nelle risposte. I codici QR e i codici di abbinamento non vengono mai mostrati, e gli elenchi non includono link ai file.
• Revoca in qualsiasi momento. Revocare la chiave in Impostazioni → Chiavi API ferma subito l'assistente.

Privacy#

Quando colleghi un assistente, ciò che legge da WbizTool (messaggi, nomi e numeri che lasci vedere alla chiave) viene inviato al fornitore di quell'assistente – per esempio Anthropic per Claude, o OpenAI per ChatGPT – e trattato secondo i suoi termini. Il server MCP di WbizTool in sé non conserva nulla: passa ogni richiesta all'API v2 e registra quale strumento è stato usato, mai il testo dei messaggi né la tua chiave. Dai alla chiave solo l'accesso di cui l'assistente ha bisogno.

Risoluzione dei problemi#

Pagine correlate#

• Panoramica dell'API v2
• Chiavi API
• API v2: messaggi
• App e integrazioni