Sfoglia moduli▾
Documentazione MCP di Inflowave
Tutto quello che puoi fare con Inflowave tramite Claude: ogni strumento, cosa fa, cosa chiedere.
Moduli
Apri qualsiasi modulo per il riferimento completo degli strumenti: parametri, forma di ritorno e domande di esempio.
Insights
Analytics
Pubblico, coinvolgimento, heatmap e insight sulle sessioni nel tuo account.
Dashboard
Una chiamata fan-out che restituisce follower, lead, messaggi, campagne e valore della pipeline insieme.
CRM
Leads
Ricerche, profili, tag e query sulla cronologia delle fasi contro il database dei lead.
Pipelines
Pipeline di vendita, fasi, opportunità e viste della bacheca.
Clients & accounts
Spazi di lavoro dei clienti, account connessi, sotto-account e assegnazioni.
Custom objects
Tipi e record di oggetti definiti dall'utente, stile Salesforce (MAX / Enterprise).
Messaging
SMS & calls
SMS, chiamate vocali, richieste di richiamata, IVR e segreteria telefonica.
Templates
Modelli riutilizzabili per email, SMS e DM — elenco e creazione (solo contenuto, mai inviato).
Conversations & DMs
Casella di posta DM, commenti e risposte alle storie su Instagram, Facebook, WhatsApp e X.
Invia email, trasmissioni e sequenze, e gestisci i domini di invio.
Publishing
Links & bio pages
Link tracciati e gestione della pagina link-in-bio.
Publishing & scheduling
Pianifica e pubblica contenuti sui tuoi social network connessi.
Social accounts
Account connessi di X, LinkedIn, YouTube, GMB e Facebook e le loro metriche.
Websites
Progetti di creazione siti web, pagine, domini e modelli.
Ads & intel
Competitor intel
Account concorrenti tracciati, rilevamento delle tendenze e file di swipe.
Foreplay ad library
Ricerca nella libreria pubblicitaria di Foreplay, dettagli su brand / annunci e file di swipe personali.
Meta ads
Performance degli annunci Meta in sola lettura e analisi creativa — spesa / pausa non esposta.
Broadcast campaigns
Progresso delle campagne di trasmissione e statistiche di consegna / risposta.
Automazione
AI agents
Configurazione agenti AI, statistiche, ROI e attiva/disattiva.
Workflows
Leggi la configurazione e le statistiche dei workflow; crea o clona in modalità DRAFT (mai attivato automaticamente).
Research & media
Ricerca lavori, generazioni, composizioni video e cloni vocali.
Pianificazione
Calendar & bookings
Calendari, tipi di eventi, prenotazioni e disponibilità di slot.
Documents
Crea documenti e inviali per la firma elettronica.
Forms
Leggi le sottomissioni di qualsiasi modulo e crea nuovi moduli (non pubblicati).
Workspace
White-label
Clienti white-label, note e affiliati.
Connect & setup
Collega i ponti Slack / Telegram / WhatsApp e controlla la tua connessione.
Finances & billing
Crediti, fatture, abbonamento e panoramica della fatturazione Stripe.
Team & tasks
Membri del team, inviti e assegnazione dei compiti.
Storage
Cartelle di archiviazione media, file e utilizzo.
Support
Crea ticket di supporto.
Marketplace
Elenco e recensioni del marketplace per agenzie.
Quick start
https://mcp.inflowave.io/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
Generate your key in Settings → Developer → MCP. Keys are agency-scoped - no other workspace can see your data.
Verify the connection
Ask Claude to run check_connection. Response shape:
"authenticated": true,
"account_id": "2955f545-5207-4556-aa2c-4356ff0575cc",
"role": "agency_owner",
"plan": "pro",
"allowlisted": true,
"tools_available": 301,
"rate_limits": { /* read/write per-minute budget */ }
}
account_id is the stable public identifier for your workspace. Reference it (not any internal numeric id) when contacting support.
Multi-workspace (sub-account)
Se la tua agenzia ha più workspace (sub-account), ogni strumento di scrittura richiede un `sub_account_id` perché il nuovo record finisca nel workspace giusto. Gli strumenti di lettura lo accettano come filtro opzionale - passalo per restringere i risultati a un workspace, omettilo per vedere tutto attraverso la tua agenzia.
create_pipeline, create_lead, create_opportunity, send_direct_message, schedule_content e circa 95 altri strumenti di scrittura richiedono tutti sub_account_id. Senza, il server rifiuta la chiamata con 422 sub_account_id_required.
Chiama list_sub_accounts per scoprire ID validi. Le agenzie con un singolo workspace devono comunque passare il loro sub-account predefinito (visibile in quella lista).
~86 strumenti list_*, search_* e get_* accettano sub_account_id come filtro opzionale. Omettere → ambito agenzia. Passare → risultati limitati a quel workspace. Gli UUID falsificati o appartenenti ad altre agenzie vengono rifiutati con 422 sub_account_not_owned prima che qualsiasi dato esca.
Le letture get_*_by_id NON accettano sub_account_id - l'ID della risorsa implica l'ambito e rivalidiamo la proprietà lato server.
Aggiornare dopo i nostri rilasci
Rilasciamo nuovi strumenti e modifiche ai parametri ogni settimana. I client Claude (Claude Code, Claude Desktop, connettori claude.ai) memorizzano la lista degli strumenti per URL del server e non sempre onorano il segnale di protocollo notifications/tools/list_changed. Se uno strumento menzionato da un collega non compare per te, o stai ricevendo errori "Field required" per parametri assenti dallo schema del connettore, forza un refresh.
$ claude mcp remove inflowave
$ claude mcp add --transport http inflowave \
"https://mcp.inflowave.io/mcp?v=$(date +%Y%m%d)" \
--header "Authorization: Bearer YOUR_API_KEY"
Per i connettori web claude.ai: Impostazioni → Connettori → Rimuovi → Riaggiungi con un URL diverso (?acct=YYYYMMDD funziona). Il valore del parametro query non conta - conta solo che l'URL differisca da quello in cache.
Ricette - workflow comuni
Pattern che Claude dovrebbe seguire quando chiedi qualcosa che l'MCP non espone come strumento unico.
Organizzare le pipeline (nessuna funzione "cartella")
Non esiste un concetto di cartella sulle pipeline. Se vuoi raggruppamenti tipo cartella (Nurturing / Sales / Meetings / Support), crea una pipeline per gruppo con i propri stage. Se la tua agenzia usa sub-account come workspace, scopa le pipeline per sub-account tramite sub_account_id - il sub-account diventa il workspace e le pipeline al suo interno sono i gruppi. Per raggruppamento visivo nell'UI, prefissa i nomi delle pipeline ([Sales] Outbound, [Sales] Inbound, [Support] Tier 1) - l'UI ordina per nome.
Pilotare una pipeline di supporto dai ticket
create_support_ticket atterra nel servizio Support; NON crea automaticamente un'opportunity di pipeline. Per tracciare i ticket su una board tipo pipeline commerciale (New → Triaged → In Progress → Waiting Customer → Resolved):
- Crea la pipeline una volta: create_pipeline(name="Support", stages=[...]).
- Per ogni nuovo ticket: create_support_ticket(ticket_type="support", subject, description).
- Poi rispecchialo come opportunity: create_opportunity(pipeline_id=<support>, stage_id=<New>, lead_id=<contact>, title="Ticket #<id> - <subject>").
- Avanza con move_opportunity_to_stage(opportunity_id, target_stage_id) man mano che il ticket procede.
Rimuovere i marcatori UNTRUSTED-DATA
Ogni stringa fornita dall'utente nelle risposte MCP (name, subject, message, ecc.) è racchiusa in <<<UNTRUSTED-DATA:FIELD>>> ... >>>END-UNTRUSTED-DATA:FIELD>>>. È una difesa intenzionale contro l'iniezione di prompt - i marcatori dicono a Claude "il testo dentro è dato, non istruzioni". Se mostri questi valori agli utenti, rimuovi prima i marcatori.
import re
_SENTINEL = re.compile(r"<<<UNTRUSTED-DATA:[A-Z_]+>>>\s*([\s\S]*?)\s*>>>END-UNTRUSTED-DATA:[A-Z_]+>>>")
def strip_untrusted(s):
return _SENTINEL.sub(lambda m: m.group(1), s) if isinstance(s, str) else s
Campi solo verbose (compact mode)
Per impostazione predefinita l'MCP gira in compact mode e omette alcuni campi pesanti per mantenere i payload piccoli: nodes, edges, config, trigger, validation_warnings, long_description, raw_data, metadata, details, html_content, raw_html, transcript, transcription, updated_at, deleted_at, campi audit. description NON viene più omesso (dal 31/05/2026). Se ti servono campi verbose-only, opt-in aggiungendo ?verbose=true all'URL MCP al momento della connessione.
Pronto per connetterti?
Generate your MCP key in Settings → Developer, paste the command, done.