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](/api/authentication/)**. `aymar_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 | `aymar_leads_create` | `POST /public/v1/leads` | `tenant:leads.manage` | Scrittura | | Leads | `aymar_leads_get` | `GET /public/v1/leads/{lead_id}` | `tenant:leads.read` | Lettura | | Leads | `aymar_leads_list` | `GET /public/v1/leads` | `tenant:leads.read` | Lettura | | Leads | `aymar_leads_update` | `PATCH /public/v1/leads/{lead_id}` | `tenant:leads.manage` | Scrittura | | Contatti | `aymar_contacts_create` | `POST /public/v1/contacts` | `tenant:contacts.manage` | Scrittura | | Contatti | `aymar_contacts_get` | `GET /public/v1/contacts/{contact_id}` | `tenant:contacts.read` | Lettura | | Contatti | `aymar_contacts_list` | `GET /public/v1/contacts` | `tenant:contacts.read` | Lettura | | Contatti | `aymar_contacts_update` | `PATCH /public/v1/contacts/{contact_id}` | `tenant:contacts.manage` | Scrittura | | Conversazioni | `aymar_conversations_get` | `GET /public/v1/conversations/{conversation_id}` | `tenant:conversations.read` | Lettura | | Conversazioni | `aymar_conversations_list` | `GET /public/v1/conversations` | `tenant:conversations.read` | Lettura | | Conversazioni | `aymar_conversations_list_messages` | `GET /public/v1/conversations/{conversation_id}/messages` | `tenant:conversations.read` | Lettura | | Conversazioni | `aymar_conversations_send_message` | `POST /public/v1/conversations/{conversation_id}/messages` | `tenant:conversations.manage` | Scrittura | | Conversazioni | `aymar_conversations_start` | `POST /public/v1/conversations/start` | `tenant:conversations.manage` | Scrittura | | Appuntamenti | `aymar_appointments_create` | `POST /public/v1/appointments` | `tenant:appointments.manage` | Scrittura | | Appuntamenti | `aymar_appointments_get` | `GET /public/v1/appointments/{appointment_id}` | `tenant:appointments.read` | Lettura | | Appuntamenti | `aymar_appointments_list` | `GET /public/v1/appointments` | `tenant:appointments.read` | Lettura | | Appuntamenti | `aymar_appointments_update` | `PATCH /public/v1/appointments/{appointment_id}` | `tenant:appointments.manage` | Scrittura | | Appuntamenti | `aymar_availability_list` | `GET /public/v1/availability` | `tenant:appointments.read` | Lettura | | Ticket | `aymar_tickets_add_comment` | `POST /public/v1/tickets/{ticket_id}/comments` | `tenant:tickets.manage` | Scrittura | | Ticket | `aymar_tickets_create` | `POST /public/v1/tickets` | `tenant:tickets.manage` | Scrittura | | Ticket | `aymar_tickets_get` | `GET /public/v1/tickets/{ticket_id}` | `tenant:tickets.read` | Lettura | | Ticket | `aymar_tickets_list` | `GET /public/v1/tickets` | `tenant:tickets.read` | Lettura | | Ticket | `aymar_tickets_update` | `PATCH /public/v1/tickets/{ticket_id}` | `tenant:tickets.manage` | Scrittura | ## Continua da qui - **[La conferma sulle scritture](/mcp/confirm/)** — cosa richiede ogni tool "Tipo: Scrittura" prima di chiamare la API. - **[Collega il tuo assistente](/mcp/connect/)** — blocchi di configurazione per client. - **Riferimento REST**, nella sezione **API** — il dettaglio completo di ogni operazione (parametri, corpo, risposta).