Flownix
Начать
Разделы
На этой странице

Подключение MCP

От токена доступа до работающего агента: одна команда для Claude Code и конфиг для остальных клиентов.

MCP-сервер — это HTTP-эндпоинт с аутентификацией по Bearer-токену. Через него агент читает и меняет ноды напрямую, не выходя из своего рабочего процесса: инструменты create_node, get_node, rag_query и остальные появляются у него в списке доступных.

Адрес сервера один и тот же для всех: https://mcp.flow.shipoora.ru/mcp.

Шаг 1. Получите токен

  1. Войдите в веб-приложение.
  2. Откройте Настройки → MCP и нажмите Создать токен доступа, дав ему имя — например, мой-ноутбук. Имя нужно, чтобы потом отозвать именно этот токен, а не все.
  3. Скопируйте токен сразу. Он выглядит как aiflow_pat_... и показывается один раз — на сервере хранится только его хэш, показать повторно нечего.

На той же странице лежат готовые конфиги с уже подставленным токеном: кнопка «копировать» рядом с каждым.

Шаг 2. Подключите клиент

Всё сразу — пакетом npm

визард
npx @flownix/cli mcp --token aiflow_pat_...

Пакет проверяет токен на сервере и только потом пишет конфиг: настроенный клиент с неверным токеном — это полчаса поисков на ровном месте. Без аргументов (npx @flownix/cli) он ставит ещё и скиллы, и хук репортера ниже на этой странице.

Конфиг он пишет только тем клиентам, чей формат описан здесь же — Claude Code и Cursor; остальным печатает готовый фрагмент для ручной вставки.

Claude Code — одной командой

подключение
claude mcp add --transport http flownix https://mcp.flow.shipoora.ru/mcp \
  --header "Authorization: Bearer aiflow_pat_..." \
  --scope user

--scope user — сервер доступен во всех ваших проектах. Альтернативы: local (по умолчанию, только текущий каталог) и project — не используйте его с токеном: project пишет конфиг в .mcp.json, который принято коммитить, и токен уедет в репозиторий.

Проверка — сервер должен отвечать:

проверка
claude mcp list

В рабочей сессии инструменты видны как mcp__flownix__create_node, mcp__flownix__rag_query и так далее. Префикс — это имя, под которым вы записали сервер (flownix в команде выше). Сервер своё имя не проверяет, поэтому подключённый под старым именем ai-flow продолжает работать: переименовывать его не обязательно.

Claude Code — конфигом

Если правите конфиг руками, нужный фрагмент выглядит так:

mcpServers
{
  "mcpServers": {
    "flownix": {
      "url": "https://mcp.flow.shipoora.ru/mcp",
      "headers": { "Authorization": "Bearer aiflow_pat_..." }
    }
  }
}

Cursor

Форма записи та же, файл — ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json внутри одного:

~/.cursor/mcp.json
{
  "mcpServers": {
    "flownix": {
      "url": "https://mcp.flow.shipoora.ru/mcp",
      "headers": { "Authorization": "Bearer aiflow_pat_..." }
    }
  }
}

Другой клиент

Транспорт — Streamable HTTP, аутентификация — заголовок Authorization: Bearer <токен>. Ничего специфичного для конкретного клиента в протоколе нет.

Шаг 3. Убедитесь, что сервер отвечает

Если клиент молчит и непонятно, чья это проблема, спросите сервер напрямую:

проверка через curl
curl -X POST https://mcp.flow.shipoora.ru/mcp \
  -H "Authorization: Bearer aiflow_pat_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-11-25",
       "capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'

Ответ с result.serverInfo означает, что токен принят и сервер работает — дальше разбираться нужно с конфигом клиента. 401 означает, что токен неверен или отозван.

Что дальше

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

Репортер токенов

Панель присутствия агентов показывает, кто и над чем работает. Сколько токенов потрачено, знает только клиент — MCP-сервер этого не видит принципиально, поэтому за отчёт отвечает отдельный скрипт. Он необязателен: без него присутствие работает целиком, пустует одно поле, и панель прямо пишет, почему оно пустое, вместо того чтобы рисовать ноль.

установка
npx @flownix/cli hook install --token <ваш-токен>
то же самое скриптом, без Node
curl -fsSL https://flow.shipoora.ru/flownix-reporter.sh | bash -s -- install <ваш-токен>

Установщик кладёт скрипт в ~/.claude (или в каталог из CLAUDE_CONFIG_DIR), прописывает его хуками Stop и SessionEnd в settings.json и сохраняет копию прежних настроек рядом. Строку статуса он не трогает: если её настроил другой плагин, она продолжит работать.

проверка
npx @flownix/cli hook check