June Offer Every MAX plan gets a fully custom-built system Free custom system worth $1,500-$10,000 · worth $1,500-$10,000
Просмотр модулей▾
Ссылка

Документация Inflowave MCP

Все, что вы можете сделать с Inflowave через Claude - каждый инструмент, что он делает, что просить.

301
Total tools
195
Read
106
Write
31
Modules

Модули

Откройте любой модуль для полного справочника по инструментам: параметры, форма возврата и пример вопросов.

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 (саб-аккаунты)

Если у твоего агентства несколько workspace (саб-аккаунтов), каждый инструмент записи требует `sub_account_id`, чтобы новая запись попала в правильный workspace. Инструменты чтения принимают его как опциональный фильтр - передай, чтобы сузить результаты до одного workspace, опусти, чтобы видеть всё по агентству.

Инструменты записи - sub_account_id ОБЯЗАТЕЛЕН

create_pipeline, create_lead, create_opportunity, send_direct_message, schedule_content и около 95 других инструментов записи требуют sub_account_id. Без него сервер отклоняет вызов с 422 sub_account_id_required.

Вызови list_sub_accounts, чтобы найти валидные ID. Агентства с одним workspace всё равно должны передавать свой дефолтный саб-аккаунт (виден в этом списке).

Инструменты чтения - sub_account_id ОПЦИОНАЛЕН

~86 инструментов list_*, search_* и get_* принимают sub_account_id как опциональный фильтр. Опустить → область агентства. Передать → результаты сужаются до этого одного workspace. Подделанные или принадлежащие чужому агентству UUID отклоняются с 422 sub_account_not_owned до отправки любых данных.

Чтения get_*_by_id НЕ принимают sub_account_id - ID ресурса подразумевает область, и мы перепроверяем владение на сервере.

Подключён до 31.05.2026? Клиенты Claude кэшируют схемы инструментов на URL сервера. Если ты подключил MCP до сегодня и твои инструменты записи падают с "sub_account_id Field required", хотя ты не можешь передать параметр, твой клиент закэшировал старую схему. См. секцию Refresh ниже - отключение + повторное подключение со свежим URL-параметром получает новую схему.

Обновление после наших релизов

Мы выпускаем новые инструменты и изменения параметров еженедельно. Клиенты Claude (Claude Code, Claude Desktop, коннекторы claude.ai) кэшируют список инструментов на URL сервера и не всегда чтят сигнал протокола notifications/tools/list_changed. Если инструмент, упомянутый коллегой, у тебя не появляется, или ты видишь ошибки "Field required" для параметров, которых нет в схеме коннектора, форсируй обновление.

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

Для веб-коннекторов claude.ai: Настройки → Коннекторы → Удалить → Добавить снова с другим URL (?acct=YYYYMMDD работает). Значение query-параметра не важно - важно лишь чтобы URL отличался от закэшированного.

Рецепты - частые workflow

Паттерны, которым Claude должен следовать, когда ты просишь то, что MCP не предоставляет одним инструментом.

Организация pipeline (без функции "папка")

У pipeline нет концепции папок. Если хочешь папочные группы (Nurturing / Sales / Meetings / Support), создай по одной pipeline на группу со своими этапами. Если твоё агентство использует саб-аккаунты как workspace, ограничивай pipeline по саб-аккаунту через sub_account_id - саб-аккаунт становится workspace, а pipeline внутри - группами. Для визуальной группировки в UI префиксуй имена ([Sales] Outbound, [Sales] Inbound, [Support] Tier 1) - UI сортирует по имени.

Ведение pipeline поддержки из тикетов

create_support_ticket попадает в сервис Support; он НЕ создаёт автоматически opportunity в pipeline. Чтобы отслеживать тикеты на доске в стиле sales pipeline (New → Triaged → In Progress → Waiting Customer → Resolved):

  1. Создай pipeline один раз: create_pipeline(name="Support", stages=[...]).
  2. Для каждого нового тикета: create_support_ticket(ticket_type="support", subject, description).
  3. Затем зеркаль как opportunity: create_opportunity(pipeline_id=<support>, stage_id=<New>, lead_id=<contact>, title="Ticket #<id> - <subject>").
  4. Двигай move_opportunity_to_stage(opportunity_id, target_stage_id) по мере продвижения тикета.

Удаление маркеров UNTRUSTED-DATA

Каждая строка, предоставленная пользователем в ответах MCP (name, subject, message и т.д.), обёрнута в <<<UNTRUSTED-DATA:FIELD>>> ... >>>END-UNTRUSTED-DATA:FIELD>>>. Это намеренная защита от prompt-injection - маркеры говорят Claude "текст внутри - данные, не инструкции". Если ты показываешь эти значения пользователям, сначала удали маркеры.

# 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

Поля только verbose (compact mode)

По умолчанию MCP работает в compact mode и опускает некоторые тяжёлые поля, чтобы payload оставался малым: nodes, edges, config, trigger, validation_warnings, long_description, raw_data, metadata, details, html_content, raw_html, transcript, transcription, updated_at, deleted_at, поля audit. description больше НЕ опускается (с 31.05.2026). Если нужны verbose-only поля, opt-in через добавление ?verbose=true к URL MCP при подключении.

Start using it

Готовы подключиться?

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

Вернуться к обзоруStart your 7-day trial