Fainflow у вашому AI (MCP)

Fainflow має власний MCP-сервер, тож будь-який AI-клієнт із підтримкою MCP — Claude, ChatGPT, Cursor, VS Code, n8n та інші — може працювати з вашими flow, з'єднаннями та bridge. Ви входите звичайним акаунтом Fainflow (OAuth); жодних API-ключів копіювати не потрібно.

Є два ендпоінти:

https://mcp.fainflow.com/mcp               # увесь ваш робочий простір
https://mcp.fainflow.com/mcp/<bridgeId>    # лише один bridge (його тули + контекст)

Ендпоінт робочого простору дає AI інструменти, щоб переглядати й будувати flow та bridge, плюс усі тули з ваших MCP-з'єднань. Per-bridge ендпоінт — вузький безпечний зріз, див. Bridge.

Claude (веб / десктоп)

  1. Settings → Connectors → Add custom connector.
  2. URL: https://mcp.fainflow.com/mcp.
  3. Натисніть Connect — відкриється вікно входу Fainflow; увійдіть і підтвердьте.

Після цього Claude бачить ваші інструменти Fainflow в усіх чатах, де ввімкнено конектор.

Claude Code (CLI)

Додайте сервер і автентифікуйтеся — Claude Code відкриє браузер і сам обробить OAuth через loopback. Він щоразу бере вільний локальний порт, а Fainflow приймає callback на будь-якому loopback-порту, тож налаштовувати нічого не потрібно:

claude mcp add --transport http fainflow https://mcp.fainflow.com/mcp

Далі всередині Claude Code виконайте /mcp і виберіть fainflow, щоб увійти. Також можна додати вручну до .mcp.json:

{ "mcpServers": { "fainflow": { "type": "http", "url": "https://mcp.fainflow.com/mcp" } } }

Cursor

Settings → MCP → Add new MCP server, транспорт HTTP, URL https://mcp.fainflow.com/mcp. Cursor відкриє браузер для входу й повернеться автоматично.

ChatGPT

Settings → Connectors → Advanced → Developer mode, далі додайте конектор з URL MCP-сервера https://mcp.fainflow.com/mcp і автентифікацією OAuth. Підтвердьте вхід Fainflow.

VS Code (GitHub Copilot)

Додайте у ваш mcp.json (Command Palette → MCP: Add Server → HTTP):

{
  "servers": {
    "fainflow": { "type": "http", "url": "https://mcp.fainflow.com/mcp" }
  }
}

Під час першого використання VS Code проведе вас через OAuth-вхід.

n8n

Використовуйте ноду MCP Client Tool. Ендпоінт Fainflow працює через Streamable HTTP, який нода підтримує з n8n 1.104+ (раніші версії мають лише застарілий SSE-транспорт):

  1. Додайте MCP Client Tool у workflow (як інструмент AI Agent).
  2. Endpoint: https://mcp.fainflow.com/mcp (або per-bridge URL).
  3. Server Transport: HTTP Streamable. Authentication: OAuth2.
  4. Завершіть вхід Fainflow, коли n8n його відкриє.

Self-hosted n8n: OAuth-callback має бути попередньо зареєстрований. n8n Cloud працює одразу; для self-hosted інстансу напишіть нам з URL вашого інстансу або підключіть per-bridge ендпоінт через bearer-проксі.

Інші MCP-клієнти (mcp-remote)

Клієнти, що підтримують лише stdio, можуть використати mcp-remote:

{
  "mcpServers": {
    "fainflow": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.fainflow.com/mcp"]
    }
  }
}

Що вміє AI

Після підключення ендпоінта робочого простору список тулів клієнта містить:

  • whoami, list_flows, get_flow, create_flow, set_flow_data, list_flow_templates — переглядати й створювати flow
  • create_api_trigger_route, bind_flow_route, enable_flow — вивести API-trigger flow повністю в онлайн (ті самі ліміти плану й валідація графа, що й у дашборді)
  • list_flow_history, get_flow_execution — перевірити, чи справді запускався ваш flow (значення виконання приховані задля приватності); delete_flow_history, delete_flow — для очищення
  • create_api_key, list_api_keys, delete_api_key — керувати ключами, що викликають API-trigger flow (ключ показується один раз)
  • set_flow_secret, list_flow_secrets, delete_flow_secret — керувати сховищем на кожен flow, до якого flow звертається як {{vault.KEY}}
  • list_connections, describe_connection_tools — бачити, що підключено
  • list_bridges, get_bridge, create_bridge, set_bridge_graph, set_bridge_sources, delete_bridge — будувати bridge
  • усі тули з ваших підключених MCP-серверів (GitHub, Atlassian, …), з префіксом з'єднання

Усе виконується від вашого імені: AI бачить лише ваші власні flow, з'єднання та bridge, а кожна дія покривається тим самим журналом аудиту, що й дашборд.

Усунення несправностей

  • 401 після підключення — токен протух, а клієнт його не оновив; від'єднайте та під'єднайте сервер у клієнті заново.
  • Вікно входу не повертається (CLI-клієнти) — вкладка браузера клієнта не повернула callback; закрийте її, повторно виконайте /mcp (Claude Code) і завершіть вхід у новій вкладці. Fainflow приймає loopback-callback на будь-якому порту, тож порт задавати не треба.
  • Порожній список тулів, крім базових — у вас ще немає MCP-з'єднань; спершу додайте їх у дашборді (як саме).