Ogni tool esposto dal server MCP corrisponde a esattamente una operazione della API
pubblica (/public/v1) — il server le genera all’avvio leggendo la propria definizione OpenAPI,
non ci sono tool scritti a mano né un elenco che qualcuno potrebbe dimenticare di aggiornare
(SPEC_MCP_PROPIO.md §2). Questa tabella è generata allo stesso modo, dallo stesso documento —
se un endpoint compare o scompare dalla API, la tabella cambia da sola alla build successiva.
I tool che il tuo client MCP vede in un dato momento sono solo quelli che la tua chiave può usare:
il server interroga GET /public/v1/me e filtra per gli scope effettivi della tua chiave, lo
stesso elenco della guida Autenticazione. nuntius_status non compare
nella tabella perché non deriva da nessun endpoint del catalogo — è un tool proprio del server MCP
per consultare il tuo tenant, piano e scope effettivi, sempre visibile.
| Risorsa | Tool | Operazione | Permesso necessario | Tipo |
|---|---|---|---|---|
| Leads | nuntius_leads_create | POST /public/v1/leads | tenant:leads.manage | Scrittura |
| Leads | nuntius_leads_get | GET /public/v1/leads/{lead_id} | tenant:leads.read | Lettura |
| Leads | nuntius_leads_list | GET /public/v1/leads | tenant:leads.read | Lettura |
| Leads | nuntius_leads_update | PATCH /public/v1/leads/{lead_id} | tenant:leads.manage | Scrittura |
| Contatti | nuntius_contacts_create | POST /public/v1/contacts | tenant:contacts.manage | Scrittura |
| Contatti | nuntius_contacts_get | GET /public/v1/contacts/{contact_id} | tenant:contacts.read | Lettura |
| Contatti | nuntius_contacts_list | GET /public/v1/contacts | tenant:contacts.read | Lettura |
| Contatti | nuntius_contacts_update | PATCH /public/v1/contacts/{contact_id} | tenant:contacts.manage | Scrittura |
| Conversazioni | nuntius_conversations_get | GET /public/v1/conversations/{conversation_id} | tenant:conversations.read | Lettura |
| Conversazioni | nuntius_conversations_list | GET /public/v1/conversations | tenant:conversations.read | Lettura |
| Conversazioni | nuntius_conversations_list_messages | GET /public/v1/conversations/{conversation_id}/messages | tenant:conversations.read | Lettura |
| Conversazioni | nuntius_conversations_send_message | POST /public/v1/conversations/{conversation_id}/messages | tenant:conversations.manage | Scrittura |
| Conversazioni | nuntius_conversations_start | POST /public/v1/conversations/start | tenant:conversations.manage | Scrittura |
| Appuntamenti | nuntius_appointments_create | POST /public/v1/appointments | tenant:appointments.manage | Scrittura |
| Appuntamenti | nuntius_appointments_get | GET /public/v1/appointments/{appointment_id} | tenant:appointments.read | Lettura |
| Appuntamenti | nuntius_appointments_list | GET /public/v1/appointments | tenant:appointments.read | Lettura |
| Appuntamenti | nuntius_appointments_update | PATCH /public/v1/appointments/{appointment_id} | tenant:appointments.manage | Scrittura |
| Appuntamenti | nuntius_availability_list | GET /public/v1/availability | tenant:appointments.read | Lettura |
| Ticket | nuntius_tickets_add_comment | POST /public/v1/tickets/{ticket_id}/comments | tenant:tickets.manage | Scrittura |
| Ticket | nuntius_tickets_create | POST /public/v1/tickets | tenant:tickets.manage | Scrittura |
| Ticket | nuntius_tickets_get | GET /public/v1/tickets/{ticket_id} | tenant:tickets.read | Lettura |
| Ticket | nuntius_tickets_list | GET /public/v1/tickets | tenant:tickets.read | Lettura |
| Ticket | nuntius_tickets_update | PATCH /public/v1/tickets/{ticket_id} | tenant:tickets.manage | Scrittura |
Continua da qui
Sezione intitolata “Continua da qui”- La conferma sulle scritture — cosa richiede ogni tool “Tipo: Scrittura” prima di chiamare la API.
- Collega il tuo assistente — blocchi di configurazione per client.
- Riferimento REST, nella sezione API — il dettaglio completo di ogni operazione (parametri, corpo, risposta).