June Offer Every MAX plan gets a fully custom-built system Free custom system worth $1,500-$10,000 · worth $1,500-$10,000
Explorar módulos▾
Referencia

Documentación de MCP de flujo de entrada

Todo lo que puedes hacer con Inflowave a través de Claude: cada herramienta, qué hace, qué pedir.

301
Total tools
195
Read
106
Write
31
Modules

Módulos

Abre cualquier módulo para su referencia completa de herramientas: parámetros, forma de retorno y preguntas de ejemplo.

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 (sub-cuentas)

Si tu agencia tiene varios workspaces (sub-cuentas), cada herramienta de escritura requiere un `sub_account_id` para que el nuevo registro aterrice en el workspace correcto. Las herramientas de lectura lo aceptan como filtro opcional - pásalo para acotar los resultados a un workspace, omítelo para ver todo a lo largo de tu agencia.

Herramientas de escritura - sub_account_id REQUERIDO

create_pipeline, create_lead, create_opportunity, send_direct_message, schedule_content y unas 95 herramientas de escritura más requieren sub_account_id. Sin él, el servidor rechaza la llamada con 422 sub_account_id_required.

Llama a list_sub_accounts para descubrir IDs válidos. Las agencias con un único workspace siguen necesitando pasar su sub-cuenta por defecto (visible en esa lista).

Herramientas de lectura - sub_account_id OPCIONAL

~86 herramientas list_*, search_* y get_* aceptan sub_account_id como filtro opcional. Omitir → ámbito de agencia. Pasar → resultados limitados a ese workspace. Los UUIDs falsificados o pertenecientes a otra agencia se rechazan con 422 sub_account_not_owned antes de devolver datos.

Las lecturas get_*_by_id NO aceptan sub_account_id - el ID del recurso implica el ámbito y revalidamos la propiedad en el servidor.

¿Conectado antes del 31/05/2026? Los clientes Claude cachean los esquemas de herramientas por URL de servidor. Si conectaste el MCP antes de hoy y tus herramientas de escritura fallan con "sub_account_id Field required" aunque no puedas suministrar el parámetro, tu cliente ha cacheado el esquema antiguo. Mira la sección Refresh más abajo - desconectar + reconectar con un parámetro de consulta URL nuevo coge el esquema nuevo.

Refrescar después de nuestras entregas

Entregamos nuevas herramientas y cambios de parámetros semanalmente. Los clientes Claude (Claude Code, Claude Desktop, conectores claude.ai) cachean la lista de herramientas por URL de servidor y no siempre honran la señal de protocolo notifications/tools/list_changed. Si una herramienta que menciona un compañero no aparece para ti, o estás recibiendo errores "Field required" para parámetros que no están en el esquema del conector, fuerza un refresco.

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

Para conectores web de claude.ai: Ajustes → Conectores → Eliminar → Volver a añadir con una URL distinta (?acct=YYYYMMDD funciona). El valor del parámetro no importa - solo importa que la URL difiera de la cacheada.

Recetas - workflows comunes

Patrones que Claude debe seguir cuando pides algo que el MCP no expone como herramienta única.

Organizar pipelines (sin función de "carpeta")

No hay concepto de carpeta en pipelines. Si quieres compartimentos tipo carpeta (Nurturing / Sales / Meetings / Support), crea una pipeline por compartimento con sus propios stages. Si tu agencia usa sub-cuentas como workspaces, acota las pipelines por sub-cuenta vía sub_account_id - la sub-cuenta se convierte en el workspace y las pipelines dentro son los compartimentos. Para agrupación visual en la UI, antepón prefijos a los nombres ([Sales] Outbound, [Sales] Inbound, [Support] Tier 1) - la UI ordena por nombre.

Dirigir una pipeline de soporte desde tickets

create_support_ticket aterriza en el servicio de Support; NO crea automáticamente una opportunity de pipeline. Para seguir tickets en un tablero estilo pipeline comercial (New → Triaged → In Progress → Waiting Customer → Resolved):

  1. Crea la pipeline una vez: create_pipeline(name="Support", stages=[...]).
  2. Para cada nuevo ticket: create_support_ticket(ticket_type="support", subject, description).
  3. Luego espéjalo como opportunity: create_opportunity(pipeline_id=<support>, stage_id=<New>, lead_id=<contact>, title="Ticket #<id> - <subject>").
  4. Avanza con move_opportunity_to_stage(opportunity_id, target_stage_id) según progresa el ticket.

Eliminar los marcadores UNTRUSTED-DATA

Cada cadena suministrada por el usuario en respuestas MCP (name, subject, message, etc.) está envuelta en <<<UNTRUSTED-DATA:FIELD>>> ... >>>END-UNTRUSTED-DATA:FIELD>>>. Es una defensa intencionada contra inyección de prompts - los marcadores le dicen a Claude "el texto interior es datos, no instrucciones". Si muestras estos valores a usuarios, elimina primero los marcadores.

# 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

Campos solo verbose (modo compact)

Por defecto el MCP funciona en modo compact y omite algunos campos pesados para mantener payloads pequeños: nodes, edges, config, trigger, validation_warnings, long_description, raw_data, metadata, details, html_content, raw_html, transcript, transcription, updated_at, deleted_at, campos de audit. description ya NO se omite (desde 31/05/2026). Si necesitas campos verbose-only, opt-in añadiendo ?verbose=true a la URL del MCP al conectar.

Start using it

¿Listo para conectarse?

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

Volver a la descripción generalStart your 7-day trial