June Offer Every MAX plan gets a fully custom-built system Free custom system worth $1,500-$10,000 · worth $1,500-$10,000
Parcourir les modules▾
Référence

Documentation Inflowave MCP

Tout ce que vous pouvez faire avec Inflowave via Claude : chaque outil, ce qu'il fait, que demander.

301
Total tools
195
Read
106
Write
31
Modules

Modules

Ouvrez n'importe quel module pour sa référence complète : paramètres, forme de retour et questions d'exemple.

Quick start

$ claude mcp add --transport http inflowave \
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.

Same key, direct REST API

The key you generated works two ways with no extra setup. Point Claude (or any MCP client) at the MCP server above for plain-English, AI-driven access — or call the REST API directly from your own code with the exact same key. Same key, same permissions, same agency scope.

Use MCP when

You want Claude (or another AI agent) to read and act on your data in plain English — "how many leads did we get this week", "move this deal to Won". No code. Connect once with the command above.

Use the REST API when

You are writing your own integration, script or backend and want to call endpoints directly. Base URL: https://api.inflowave.io. You do NOT need the MCP server for this — it is the same key hitting the API straight.

Authenticate every REST request with your key. All three of these header shapes are accepted — use whichever your HTTP client makes easiest:

# 1 — standard bearer (recommended)
$ curl https://api.inflowave.io/api/v2/leads \
--header "Authorization: Bearer ifw_your_key"

# 2 — X-API-Key header (same key)
$ curl https://api.inflowave.io/api/v2/leads \
--header "X-API-Key: ifw_your_key"

The key must start with ifw_. A 401 means the key was not sent in one of the shapes above (a bare token with no header, or a different header name, is ignored). The key carries your agency scope and the scopes you granted it at creation — nothing else is required.

Multi-workspace (sous-comptes)

Si ton agence a plusieurs workspaces (sous-comptes), chaque outil d'écriture nécessite un `sub_account_id` pour que le nouvel enregistrement arrive dans le bon workspace. Les outils de lecture l'acceptent comme filtre optionnel - passe-le pour restreindre les résultats à un workspace, omets-le pour voir tout au sein de ton agence.

Outils d'écriture - sub_account_id REQUIS

create_pipeline, create_lead, create_opportunity, send_direct_message, schedule_content et environ 95 autres outils d'écriture exigent tous sub_account_id. Sans lui, le serveur rejette l'appel avec 422 sub_account_id_required.

Appelle list_sub_accounts pour découvrir des IDs valides. Les agences à workspace unique doivent toujours passer leur sous-compte par défaut (visible dans cette liste).

Outils de lecture - sub_account_id OPTIONNEL

~86 outils list_*, search_* et get_* acceptent sub_account_id comme filtre optionnel. Omis → portée agence. Passé → résultats limités à ce workspace. Les UUIDs falsifiés ou appartenant à une mauvaise agence sont rejetés avec 422 sub_account_not_owned avant qu'aucune donnée ne soit renvoyée.

Les lectures get_*_by_id n'acceptent PAS sub_account_id - l'ID de la ressource implique la portée et nous revérifions l'appartenance côté serveur.

Connecté avant le 31/05/2026 ? Les clients Claude mettent en cache les schémas d'outils par URL de serveur. Si tu as connecté le MCP avant aujourd'hui et que tes outils d'écriture échouent avec "sub_account_id Field required" alors que tu ne peux pas fournir le paramètre, ton client a mis en cache l'ancien schéma. Voir la section Refresh ci-dessous - déconnecter + reconnecter avec un nouveau paramètre de requête URL récupère le nouveau schéma.

Rafraîchir après nos livraisons

Nous livrons de nouveaux outils et changements de paramètres chaque semaine. Les clients Claude (Claude Code, Claude Desktop, connecteurs claude.ai) mettent en cache la liste d'outils par URL de serveur et n'honorent pas toujours le signal protocolaire notifications/tools/list_changed. Si un outil mentionné par un coéquipier n'apparaît pas chez toi ou que tu vois des erreurs "Field required" pour des paramètres absents du schéma du connecteur, force un rafraîchissement.

# Claude Code (rename the version param to anything new)
$ 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"

Pour les connecteurs web claude.ai : Paramètres → Connecteurs → Supprimer → Réajouter avec une URL différente (?acct=YYYYMMDD fonctionne). La valeur du paramètre de requête importe peu - seul compte que l'URL diffère de celle en cache.

Recettes - workflows courants

Modèles que Claude devrait suivre quand tu demandes quelque chose que le MCP n'expose pas comme outil unique.

Organiser les pipelines (pas de fonction "dossier")

Il n'y a pas de concept de dossier sur les pipelines. Si tu veux des compartiments façon dossiers (Nurturing / Sales / Meetings / Support), crée une pipeline par compartiment avec ses propres stages. Si ton agence utilise des sous-comptes comme workspaces, scope les pipelines par sous-compte via sub_account_id - le sous-compte devient le workspace et les pipelines à l'intérieur sont les compartiments. Pour un regroupement visuel dans l'UI, préfixe les noms ([Sales] Outbound, [Sales] Inbound, [Support] Tier 1) - l'UI trie par nom.

Piloter une pipeline de support depuis les tickets

create_support_ticket atterrit dans le service Support ; il NE crée PAS automatiquement d'opportunité dans la pipeline. Pour suivre les tickets sur un tableau type pipeline commerciale (New → Triaged → In Progress → Waiting Customer → Resolved) :

  1. Crée la pipeline une fois : create_pipeline(name="Support", stages=[...]).
  2. Pour chaque nouveau ticket : create_support_ticket(ticket_type="support", subject, description).
  3. Puis miroite-le en opportunité : create_opportunity(pipeline_id=<support>, stage_id=<New>, lead_id=<contact>, title="Ticket #<id> - <subject>").
  4. Avance avec move_opportunity_to_stage(opportunity_id, target_stage_id) au fur et à mesure que le ticket progresse.

Retirer les marqueurs UNTRUSTED-DATA

Chaque chaîne fournie par l'utilisateur dans les réponses MCP (name, subject, message, etc.) est encapsulée dans <<<UNTRUSTED-DATA:FIELD>>> ... >>>END-UNTRUSTED-DATA:FIELD>>>. C'est une défense volontaire contre l'injection de prompt - les marqueurs disent à Claude "le texte intérieur est de la donnée, pas des instructions". Si tu affiches ces valeurs aux utilisateurs, retire d'abord les marqueurs.

# Python
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

Champs en mode verbose uniquement (compact mode)

Par défaut le MCP fonctionne en mode compact et omet certains champs lourds pour garder les payloads légères : nodes, edges, config, trigger, validation_warnings, long_description, raw_data, metadata, details, html_content, raw_html, transcript, transcription, updated_at, deleted_at, champs d'audit. description n'est PLUS omis (depuis le 31/05/2026). Si tu as besoin de champs verbose-only, opt-in en ajoutant ?verbose=true à l'URL du MCP lors de la connexion.

Start using it

Prêt à vous connecter ?

Generate your MCP key in Settings → Developer, paste the command, done.

Retour à l'aperçuStart your 7-day trial