SendApp MCP

Cos'è

Il server SendApp MCP collega a SendApp gli assistenti AI compatibili con il Model Context Protocol: Claude, ChatGPT, Cursor, VS Code, Claude Code, n8n e gli altri client MCP. L'assistente usa i tuoi dati reali — contatti, chat, campagne, automazioni, agenda, ordini — con i permessi che scegli tu.

Come si collega (consigliato)

1. Nella tua applicazione AI aggiungi un connettore MCP personalizzato con l'indirizzo https://app.sendapp.ai/api/mcp.
2. Premi Connetti: si apre SendApp. Accedi con l'account del titolare (gli operatori non possono collegare applicazioni).
3. Scegli Leggere e agire per me oppure Solo lettura e premi Consenti. Fatto: nessuna chiave da copiare.

• Claude (web e desktop): Impostazioni (Settings) → Connettori (Connectors) → Aggiungi connettore personalizzato (Add custom connector).
• ChatGPT: nelle impostazioni delle app e dei connettori (Apps & Connectors), con la modalità sviluppatore attiva, crea un connettore con l'indirizzo sopra.
• Claude Code: claude mcp add --transport http sendapp https://app.sendapp.ai/api/mcp
• Cursor e VS Code: aggiungi un server MCP di tipo HTTP con l'indirizzo sopra (mcp.json); al primo uso si apre l'accesso a SendApp.

Con la chiave API (avanzato)

Per n8n, Make, script e client che non gestiscono l'accesso: invia la tua API key nell'header X-API-Key (oppure Authorization: Bearer LA_TUA_API_KEY). Solo se il client non permette header: https://app.sendapp.ai/api/mcp?apikey=LA_TUA_API_KEY (sconsigliato: la chiave finisce nei log). La chiave API ha accesso completo, come l'API REST: creane una per ogni integrazione in Impostazioni → Chiavi API (la vedi una volta sola, alla creazione).

Cosa può fare

• Account (2): get_account, get_tokens
• Contatti (10): get_contacts, search_contacts_advanced, get_contact, create_contact, update_contact, delete_contact, import_contacts, set_contact_opt_out, add_contact_note, get_contact_timeline
• Tag (7): get_tags, add_tags_to_contact, remove_tags_from_contact, tag_contacts, update_tag, merge_tags, delete_tag
• Campi personalizzati (5): get_custom_fields, create_custom_field, update_custom_field, delete_custom_field, set_contact_field_value
• Liste e segmenti (6): get_lists, create_list, add_contacts_to_list, remove_contacts_from_list, get_segments, create_segment
• Chat (8): get_conversations, get_conversation_messages, send_conversation_reply, assign_conversation, set_conversation_ai, archive_conversation, mark_conversation_read, update_support_request
• Messaggi (4): send_whatsapp_meta, send_whatsapp_template, get_message_status, send_sms
• Template WhatsApp (5): get_whatsapp_templates, get_whatsapp_template, create_whatsapp_template, update_whatsapp_template, delete_whatsapp_template
• Campagne (11): get_campaigns, get_campaign, get_campaign_recipients, create_campaign_draft, launch_campaign, pause_campaign, resume_campaign, retry_failed_campaign, reschedule_campaign, get_upcoming_events, get_campaign_performance
• Automazioni (7): get_automations, get_automation, activate_automation, deactivate_automation, trigger_automation, get_automation_stats, get_auto_replies
• Agenda e prenotazioni (9): get_bookings, create_booking, reschedule_booking, cancel_booking, get_booking_pages, get_available_slots, book_appointment, get_reminders, cancel_reminder
• WhatsApp Commerce (9): get_products, get_product, get_product_categories, upsert_product, delete_product, get_orders, get_order, update_order_status, create_payment_link
• Team e lead (4): get_operators, get_leads, create_lead, update_lead_stage
• Report (2): get_contact_stats, get_conversation_stats
• Assistente AI (4): get_ai_status, test_ai_answer, add_knowledge, set_account_ai

Esempi di richieste

• «Quanti contatti nuovi abbiamo avuto questo mese e da quale canale?»
• «Mostrami le chat non lette di oggi e rispondi a Marco che la consegna è domani»
• «Crea il template promo_autunno con uno sconto del 20% e mandalo in approvazione»
• «Prepara una campagna in bozza per i contatti con il tag fiera-2026»
• «Che orari liberi ho giovedì? Prenota le 15:00 per Anna Rossi»
• «Quali ordini sono stati pagati ieri?»

Sicurezza e limiti

• Solo il titolare può collegare un'applicazione e sceglie se può solo leggere o anche agire.
• Le azioni che inviano messaggi, lanciano campagne o cambiano prenotazioni avvengono subito, su clienti reali: le app AI chiedono conferma prima di eseguirle.
• Puoi scollegare un'applicazione quando vuoi da Impostazioni → Assistenti AI collegati.
• Serve un piano con accesso API. Limite: 120 chiamate al minuto per spazio di lavoro (60 per le azioni).
• WhatsApp: i messaggi liberi arrivano solo a chi ti ha scritto nelle ultime 24 ore; per gli altri servono template approvati.

Dettagli tecnici

• Trasporto Streamable HTTP, JSON-RPC 2.0, senza sessioni; protocollo MCP dalla 2024-11-05 alla 2026-07-28 (server/discover).
• Autorizzazione OAuth 2.1 con PKCE (S256), registrazione dinamica dei client e Client ID Metadata Documents; metadati in /.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server.
• Meno strumenti: aggiungi ?toolsets=contacts,inbox all'indirizzo per esporre solo alcune aree (account, contacts, tags, fields, lists, inbox, messaging, templates, campaigns, automations, agenda, commerce, team, reports, ai).