June Offer Every MAX plan gets a fully custom-built system Free custom system worth $1,500-$10,000 · worth $1,500-$10,000
Procházet moduly▾
Odkaz

Dokumentace Inflowave MCP

Vše, co můžete dělat s Inflowave prostřednictvím Clauda - každý nástroj, co dělá, o co žádat.

301
Total tools
195
Read
106
Write
31
Modules

Moduly

Otevřete jakýkoli modul pro jeho úplnou referenci nástrojů: parametry, návratový tvar a příkladové otázky.

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-účty)

Pokud má tvá agentura více workspaců (sub-účtů), každý zapisovací nástroj vyžaduje `sub_account_id`, aby nový záznam přistál ve správném workspace. Čtecí nástroje ho přijímají jako volitelný filtr - předej ho pro zúžení výsledků na jeden workspace, vynechej pro zobrazení všeho napříč agenturou.

Zapisovací nástroje - sub_account_id POVINNÉ

create_pipeline, create_lead, create_opportunity, send_direct_message, schedule_content a asi 95 dalších zapisovacích nástrojů všechny vyžadují sub_account_id. Bez něj server odmítne volání s 422 sub_account_id_required.

Zavolej list_sub_accounts, abys našel platná ID. Agentury s jedním workspace musí stejně předat svůj výchozí sub-účet (viditelný v tom seznamu).

Čtecí nástroje - sub_account_id VOLITELNÉ

~86 nástrojů list_*, search_* a get_* přijímá sub_account_id jako volitelný filtr. Vynechat → rozsah agentury. Předat → výsledky omezené na ten jeden workspace. Padělané nebo cizí UUID jsou odmítnuty s 422 sub_account_not_owned dřív, než jakákoli data odejdou.

Čtení get_*_by_id NEPŘIJÍMÁ sub_account_id - ID zdroje implikuje rozsah a my znovu validujeme vlastnictví na serveru.

Připojeno před 31.05.2026? Klienti Claude cachují schémata nástrojů podle URL serveru. Pokud jsi připojil MCP před dneškem a tvé zapisovací nástroje selhávají s "sub_account_id Field required", i když nemůžeš parametr poskytnout, tvůj klient zacachoval staré schéma. Viz sekci Refresh níže - odpojení + opětovné připojení s čerstvým URL query parametrem získá nové schéma.

Obnova po našich vydáních

Vydáváme nové nástroje a změny parametrů týdně. Klienti Claude (Claude Code, Claude Desktop, konektory claude.ai) cachují seznam nástrojů podle URL serveru a ne vždy respektují protokolový signál notifications/tools/list_changed. Pokud nástroj zmíněný kolegou se u tebe neobjeví, nebo dostáváš chyby "Field required" pro parametry nepřítomné ve schématu konektoru, vynuť obnovu.

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

Pro webové konektory claude.ai: Nastavení → Konektory → Odebrat → Znovu přidat s jinou URL (?acct=YYYYMMDD funguje). Hodnota query parametru nezáleží - záleží jen, že se URL liší od cachované.

Recepty - běžné workflow

Vzory, kterými by se měl Claude řídit, když požádáš o něco, co MCP nenabízí jako jediný nástroj.

Organizace pipeline (žádná funkce "složka")

Žádný koncept složek u pipeline neexistuje. Pokud chceš složkové skupiny (Nurturing / Sales / Meetings / Support), vytvoř jednu pipeline na skupinu s vlastními fázemi. Pokud tvá agentura používá sub-účty jako workspaces, omez pipeline po sub-účtu přes sub_account_id - sub-účet se stane workspace a pipeline uvnitř jsou skupiny. Pro vizuální seskupení v UI prefixuj jména ([Sales] Outbound, [Sales] Inbound, [Support] Tier 1) - UI řadí podle jména.

Řízení podpůrné pipeline z ticketů

create_support_ticket přistane v Support službě; NEVYTVÁŘÍ automaticky opportunity v pipeline. Pro sledování ticketů na boardu ve stylu sales pipeline (New → Triaged → In Progress → Waiting Customer → Resolved):

  1. Vytvoř pipeline jednou: create_pipeline(name="Support", stages=[...]).
  2. Pro každý nový ticket: create_support_ticket(ticket_type="support", subject, description).
  3. Pak ho zrcadli jako opportunity: create_opportunity(pipeline_id=<support>, stage_id=<New>, lead_id=<contact>, title="Ticket #<id> - <subject>").
  4. Postupuj move_opportunity_to_stage(opportunity_id, target_stage_id) jak ticket postupuje.

Odstranění značek UNTRUSTED-DATA

Každý řetězec dodaný uživatelem v odpovědích MCP (name, subject, message atd.) je zabalen v <<<UNTRUSTED-DATA:FIELD>>> ... >>>END-UNTRUSTED-DATA:FIELD>>>. To je záměrná obrana proti prompt-injection - značky říkají Claudovi "text uvnitř jsou data, ne instrukce". Pokud zobrazuješ tyto hodnoty uživatelům, nejprve značky odstraň.

# 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

Pouze verbose pole (compact mode)

Standardně MCP běží v compact mode a vynechává některá těžká pole, aby payload zůstal malý: nodes, edges, config, trigger, validation_warnings, long_description, raw_data, metadata, details, html_content, raw_html, transcript, transcription, updated_at, deleted_at, audit pole. description už NENÍ vynecháváno (od 31.05.2026). Pokud potřebuješ verbose-only pole, opt-in přidáním ?verbose=true k MCP URL při připojení.

Start using it

Jste připraveni se připojit?

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

Zpět na přehledStart your 7-day trial