ДОКУМЕНТАЦИЯ / НАЧАЛО / ВВЕДЕНИЕ

Введение в Staqflow

Staqflow — облачная платформа для автоматизации процессов: от синхронизации CRM до AI-агентов и data pipelines. Флоу можно собрать руками в редакторе или поручить ИИ-ассистенту — узлы, код, 480+ интеграций, один рантайм.

TL;DR

Ставить и разворачивать ничего не нужно: Staqflow работает в облаке. Регистрация на staqflow.ru — и первый флоу собран ассистентом за пару минут.

Начало работы #

Staqflow — облачный сервис. Отдельной установки нет: вы создаёте пространство и сразу работаете в редакторе. Развёртывание в собственном контуре обсуждается отдельно в рамках тарифа Корпоративный.

ШагЧто сделатьСколько занимает
1Регистрация на staqflow.ru и создание пространства1 мин
2Подключение систем: базы, CRM, мессенджеры — из каталога коннекторов2–5 мин
3Описать задачу ассистенту обычными словами1 мин
4Проверить собранные узлы и запустить тестовый прогон1 мин

Сборка флоу ассистентом #

Самый быстрый способ получить работающий процесс — описать его словами. Ассистент разберёт задачу, уточнит недостающее и соберёт флоу из доступных узлов. Результат — обычный workflow: его видно в редакторе и можно править вручную.

диалог с ассистентом
1# Вы
2Когда приходит заказ — проверь оплату и пришли сводку в Telegram
3
4# Ассистент
5Нужен доступ к базе заказов  PostgreSQL · orders_db
6Собран флоу из 6 узлов:
7  webhook  проверка схемы  postgres  merge  llm  telegram

MCP-сервер: работа из своего ИИ-клиента #

Staqflow отдаёт собственный MCP-сервер. Подключите его к любому клиенту с поддержкой Model Context Protocol и стройте флоу прямо в переписке с ним: он создаёт, меняет и запускает процессы в вашем пространстве через тот же API, что и веб-интерфейс.

Подходит любой MCP-клиент, в том числе:

  • Чат-ассистенты — Claude, ChatGPT, GigaChat и другие
  • Среды разработки — Cursor, VS Code, JetBrains, Zed
  • CLI и агенты — Claude Code, Codex, GigaCode, собственные агенты на MCP SDK
подключение MCP-сервера
1{
2  "mcpServers": {
3    "staqflow": {
4      "url": "https://mcp.staqflow.ru/v1",
5      "headers": { "Authorization": "Bearer $STAQFLOW_TOKEN" }
6    }
7  }
8}
ГРАНИЦЫ

MCP-клиент работает от имени выданного вами токена: права те же, что у роли в пространстве. Что именно разрешено менять и публиковать без ревью — настраивается политиками, все действия попадают в аудит.

Первый флоу за 3 минуты #

Разберём на примере: каждый час забрать новые заказы из PostgreSQL, обогатить данными о клиенте, отправить уведомление в Telegram.

CRON
0 * * * *
pgPOSTGRES
orders.new
ƒFUNCTION
enrich
tgTELEGRAM
send

В визуальном редакторе это четыре узла, соединённых линиями. Каждый узел — декларация: триггер, источник, трансформация, действие. Данные из предыдущего узла доступны через $input или через drag-and-drop из панели переменных.

function.js
1// Узел: Function · "enrich"
2// Входит массив заказов из узла postgres
3
4const orders = $input.all();
5
6return orders.map(o => ({
7  id: o.id,
8  total: o.total,
9  text: `Новый заказ № ${o.id} · ${o.total} ₽`,
10  chat: '@sales_team'
11}));

Ключевые концепции #

В Staqflow шесть базовых сущностей. Зная их, вы сможете построить любой процесс — сами или вместе с ассистентом.

СущностьЧто этоПример
FlowОдин процесс: от триггера до действияorder-sync
NodeОдин шаг: триггер, код, интеграция, логикаpostgres.query
TriggerТочка входа: webhook, cron, очередьcron(0 * * * *)
ExecutionОдин запуск флоу со всеми даннымиexec_4a7b2e
CredentialЗашифрованные секреты для интеграцийpg-prod
MCP-подключениеВнешний ИИ-клиент, работающий с вашими флоу по выданному токенуcursor · claude
ПРИНЦИП

Один Flow = один Trigger + N Node. Каждый запуск — Execution с полной историей входов/выходов каждого узла.

REST API #

Всё, что можно сделать в UI, можно сделать через API. Ключ — в настройках профиля.

Запустить флоу

POST /v1/flows/{flow_id}/execute
cURL TypeScript Python
1$ curl -X POST https://api.staqflow.ru/v1/flows/order-sync/execute \
2    -H "Authorization: Bearer $STAQFLOW_TOKEN" \
3    -H "Content-Type: application/json" \
4    -d '{"order_id": 4721, "source": "checkout"}'
5
6# Ответ
7{ "execution_id": "exec_4a7b2e", "status": "running" }

Получить статус выполнения

GET /v1/executions/{execution_id}

Эндпоинты

МетодПутьОписание
GET/v1/flowsСписок всех флоу
POST/v1/flowsСоздать новый флоу
POST/v1/flows/{id}/executeЗапустить флоу
GET/v1/executions/{id}Статус и результат
DEL/v1/executions/{id}Отменить выполнение
GET/v1/connectorsСписок коннекторов