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

Documentação do Inflowave MCP

Tudo o que você pode fazer com o Inflowave através do Claude - cada ferramenta, o que ela faz, o que pedir.

301
Total tools
195
Read
106
Write
31
Modules

Módulos

Abre qualquer módulo para a sua referência completa de ferramentas: parâmetros, formato de retorno e perguntas de exemplo.

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-contas)

Se a tua agência tem vários workspaces (sub-contas), cada ferramenta de escrita requer um `sub_account_id` para que o novo registo aterre no workspace certo. As ferramentas de leitura aceitam-no como filtro opcional - passa-o para estreitar os resultados a um workspace, omite para ver tudo na tua agência.

Ferramentas de escrita - sub_account_id OBRIGATÓRIO

create_pipeline, create_lead, create_opportunity, send_direct_message, schedule_content e cerca de 95 outras ferramentas de escrita exigem sub_account_id. Sem ele, o servidor rejeita a chamada com 422 sub_account_id_required.

Chama list_sub_accounts para descobrir IDs válidos. Agências com um único workspace ainda assim precisam de passar a sua sub-conta por defeito (visível nessa lista).

Ferramentas de leitura - sub_account_id OPCIONAL

~86 ferramentas list_*, search_* e get_* aceitam sub_account_id como filtro opcional. Omitir → âmbito da agência. Passar → resultados restritos a esse workspace. UUIDs forjados ou pertencentes a outra agência são rejeitados com 422 sub_account_not_owned antes de qualquer dado sair.

As leituras get_*_by_id NÃO aceitam sub_account_id - o ID do recurso implica o âmbito e revalidamos a propriedade no servidor.

Ligado antes de 31/05/2026? Os clientes Claude colocam em cache os esquemas das ferramentas por URL do servidor. Se ligaste o MCP antes de hoje e as tuas ferramentas de escrita falham com "sub_account_id Field required" mesmo que não consigas fornecer o parâmetro, o teu cliente colocou o esquema antigo em cache. Vê a secção Refresh abaixo - desligar + ligar novamente com um parâmetro de query URL novo recolhe o esquema novo.

Atualizar após os nossos lançamentos

Lançamos novas ferramentas e alterações de parâmetros semanalmente. Os clientes Claude (Claude Code, Claude Desktop, conectores claude.ai) colocam a lista de ferramentas em cache por URL do servidor e nem sempre honram o sinal de protocolo notifications/tools/list_changed. Se uma ferramenta mencionada por um colega não aparecer para ti, ou estiveres a receber erros "Field required" para parâmetros ausentes do esquema do conector, força uma atualização.

# 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 claude.ai: Definições → Conectores → Remover → Voltar a adicionar com um URL diferente (?acct=YYYYMMDD funciona). O valor do parâmetro de query não importa - só importa que o URL seja diferente do que está em cache.

Receitas - workflows comuns

Padrões que o Claude deve seguir quando pedes algo que o MCP não expõe como ferramenta única.

Organizar pipelines (sem funcionalidade de "pasta")

Não existe conceito de pasta em pipelines. Se quiseres compartimentos tipo pasta (Nurturing / Sales / Meetings / Support), cria uma pipeline por compartimento com os seus próprios stages. Se a tua agência usa sub-contas como workspaces, restringe as pipelines por sub-conta via sub_account_id - a sub-conta torna-se o workspace e as pipelines dentro são os compartimentos. Para agrupamento visual na UI, antepõe prefixos aos nomes ([Sales] Outbound, [Sales] Inbound, [Support] Tier 1) - a UI ordena por nome.

Conduzir uma pipeline de suporte a partir de tickets

create_support_ticket aterra no serviço Support; NÃO cria automaticamente uma opportunity de pipeline. Para acompanhar tickets num quadro estilo pipeline comercial (New → Triaged → In Progress → Waiting Customer → Resolved):

  1. Cria a pipeline uma vez: create_pipeline(name="Support", stages=[...]).
  2. Para cada novo ticket: create_support_ticket(ticket_type="support", subject, description).
  3. Depois espelha-o como opportunity: create_opportunity(pipeline_id=<support>, stage_id=<New>, lead_id=<contact>, title="Ticket #<id> - <subject>").
  4. Avança com move_opportunity_to_stage(opportunity_id, target_stage_id) à medida que o ticket progride.

Remover marcadores UNTRUSTED-DATA

Cada string fornecida pelo utilizador nas respostas MCP (name, subject, message, etc.) está envolvida em <<<UNTRUSTED-DATA:FIELD>>> ... >>>END-UNTRUSTED-DATA:FIELD>>>. Esta é uma defesa intencional contra injeção de prompt - os marcadores dizem ao Claude "o texto dentro é dados, não instruções". Se mostras estes valores aos utilizadores, remove primeiro os 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 apenas verbose (compact mode)

Por defeito o MCP corre em compact mode e omite alguns campos pesados para manter payloads pequenos: 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 já NÃO é omitido (desde 31/05/2026). Se precisas de campos verbose-only, opt-in adicionando ?verbose=true ao URL do MCP ao ligar.

Start using it

Pronto para se conectar?

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

Voltar à visão geralStart your 7-day trial