August Offer 3 months of Business for $223.50, half price, paid once 3 months of Business, $223.50 · save $223.50
Przeglądaj moduły
Odniesienie

Dokumentacja MCP Inflowave

Wszystko, co możesz zrobić z Inflowave za pośrednictwem Claude - każde narzędzie, co robi, o co prosić.

301
Total tools
195
Read
106
Write
31
Modules

Moduły

Otwórz dowolny moduł, aby uzyskać pełną dokumentację narzędzi: parametry, kształt zwrotu i przykładowe pytania.

Quick start

$ claude mcp add --transport http inflowave -s user \
https://mcp.inflowave.io/mcp \
--header "Authorization: Bearer YOUR_API_KEY"

The -s user flag makes the connection available in every project. Without it the server is saved only for the folder you ran the command in, and the Inflowave tools will silently not appear anywhere else.

Generate your key at https://app.inflowave.io/master/profile?tab=api — or, in the app, click Dev at the very bottom of the left sidebar. You need to be signed in as the agency owner. The key is shown once, at creation, and cannot be retrieved afterwards, so copy it before closing the dialog. Keys are agency-scoped, so no other workspace can see your data.

Verify the connection

Restart Claude Code first (or run /mcp). Tools from a newly added server are not available in a session that was already open — it will look like the setup failed when it has actually worked.

Then type: "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.

Before your first write, ask Claude to run list_sub_accounts, then tell it which workspace to use by name — it will pass the right id for you. Most tools that change data refuse with sub_account_id_required until they know which workspace you mean.

Careful with claude mcp get: it prints your key in full. Do not paste its output into a support ticket, a screenshot or a shared terminal. If a key is exposed, revoke it on the same screen you created it and issue a new one.

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

Jeśli Twoja agencja ma wiele workspace'ów (sub-kont), każde narzędzie zapisu wymaga `sub_account_id`, aby nowy rekord trafił do właściwego workspace. Narzędzia odczytu akceptują go jako filtr opcjonalny - przekaż, żeby zawęzić wyniki do jednego workspace, pomiń, żeby zobaczyć wszystko w całej agencji.

Narzędzia zapisu - sub_account_id WYMAGANY

create_pipeline, create_lead, create_opportunity, send_direct_message, schedule_content i około 95 innych narzędzi zapisu wszystkie wymagają sub_account_id. Bez niego serwer odrzuca wywołanie z 422 sub_account_id_required.

Wywołaj list_sub_accounts, żeby znaleźć poprawne ID. Agencje z jednym workspace muszą i tak przekazać swoje domyślne sub-konto (widoczne na tej liście).

Narzędzia odczytu - sub_account_id OPCJONALNY

~86 narzędzi list_*, search_* i get_* akceptuje sub_account_id jako filtr opcjonalny. Pomiń → zakres agencji. Przekaż → wyniki ograniczone do tego workspace. Sfałszowane lub należące do innej agencji UUID-y są odrzucane z 422 sub_account_not_owned zanim jakiekolwiek dane wyjdą.

Odczyty get_*_by_id NIE przyjmują sub_account_id - ID zasobu implikuje zakres i ponownie walidujemy własność po stronie serwera.

Podłączony przed 31.05.2026? Klienci Claude cache'ują schematy narzędzi per URL serwera. Jeśli podłączyłeś MCP przed dzisiaj i Twoje narzędzia zapisu padają z "sub_account_id Field required" mimo że nie możesz dostarczyć parametru, Twój klient zacachował stary schemat. Zobacz sekcję Refresh poniżej - odłączenie + ponowne podłączenie ze świeżym parametrem URL pobiera nowy schemat.

Odświeżanie po naszych wdrożeniach

Wdrażamy nowe narzędzia i zmiany parametrów co tydzień. Klienci Claude (Claude Code, Claude Desktop, konektory claude.ai) cache'ują listę narzędzi per URL serwera i nie zawsze honorują sygnał protokołu notifications/tools/list_changed. Jeśli narzędzie wspomniane przez członka zespołu nie pojawia się u Ciebie albo dostajesz błędy "Field required" dla parametrów nieobecnych w schemacie konektora, wymuś odświeżenie.

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

Dla konektorów web claude.ai: Ustawienia → Konektory → Usuń → Dodaj ponownie z innym URL-em (?acct=YYYYMMDD działa). Wartość parametru zapytania nie ma znaczenia - liczy się tylko to, że URL różni się od tego z cache.

Przepisy - częste workflow

Wzorce, których Claude powinien przestrzegać, gdy poprosisz o coś, czego MCP nie udostępnia jako pojedyncze narzędzie.

Organizowanie pipeline'ów (brak funkcji "folder")

Nie ma koncepcji folderów dla pipeline'ów. Jeśli chcesz folderowych grup (Nurturing / Sales / Meetings / Support), utwórz jedną pipeline na grupę z własnymi etapami. Jeśli Twoja agencja używa sub-kont jako workspace'ów, zakresuj pipeline'y per sub-konto przez sub_account_id - sub-konto staje się workspace, a pipeline'y w nim to grupy. Dla wizualnego grupowania w UI prefiksuj nazwy ([Sales] Outbound, [Sales] Inbound, [Support] Tier 1) - UI sortuje po nazwie.

Sterowanie pipeline'em wsparcia z ticketów

create_support_ticket trafia do serwisu Support; NIE tworzy automatycznie opportunity w pipeline. Aby śledzić tickety na tablicy w stylu sales pipeline (New → Triaged → In Progress → Waiting Customer → Resolved):

  1. Utwórz pipeline raz: create_pipeline(name="Support", stages=[...]).
  2. Dla każdego nowego ticketu: create_support_ticket(ticket_type="support", subject, description).
  3. Następnie odbij jako opportunity: create_opportunity(pipeline_id=<support>, stage_id=<New>, lead_id=<contact>, title="Ticket #<id> - <subject>").
  4. Przesuwaj move_opportunity_to_stage(opportunity_id, target_stage_id) w miarę postępów ticketu.

Usuwanie znaczników UNTRUSTED-DATA

Każdy łańcuch dostarczony przez użytkownika w odpowiedziach MCP (name, subject, message itd.) jest opakowany w <<<UNTRUSTED-DATA:FIELD>>> ... >>>END-UNTRUSTED-DATA:FIELD>>>. To celowa obrona przed prompt-injection - znaczniki mówią Claude'owi "tekst w środku to dane, nie instrukcje". Jeśli wyświetlasz te wartości użytkownikom, najpierw usuń znaczniki.

# 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

Pola tylko-verbose (compact mode)

Domyślnie MCP działa w compact mode i pomija niektóre ciężkie pola, żeby utrzymać małe payloady: nodes, edges, config, trigger, validation_warnings, long_description, raw_data, metadata, details, html_content, raw_html, transcript, transcription, updated_at, deleted_at, pola audytu. description NIE jest już pomijane (od 31.05.2026). Jeśli potrzebujesz pól verbose-only, opt-in przez dodanie ?verbose=true do URL-a MCP przy łączeniu.

Start using it

Gotowy do połączenia?

Generate your MCP key at app.inflowave.io/master/profile?tab=api, paste the command, done.

Talk with Founder