Korzystaj z Fainflow ze swojego AI (MCP)

Fainflow udostępnia własny serwer MCP, więc dowolny klient AI obsługujący MCP — Claude, ChatGPT, Cursor, VS Code, n8n i inne — może pracować z Twoimi flow, połączeniami oraz bridge. Logujesz się swoim zwykłym kontem Fainflow (OAuth); nie musisz kopiować żadnych kluczy API.

Dostępne są dwa punkty końcowe:

https://mcp.fainflow.com/mcp               # your whole workspace
https://mcp.fainflow.com/mcp/<bridgeId>    # one bridge only (its tools + context)

Punkt końcowy przestrzeni roboczej daje AI narzędzia do wyświetlania i budowania flow i bridge, a także każde narzędzie sfederowane z Twoich połączeń MCP. Punkt końcowy pojedynczego bridge to wąski, bezpieczny wycinek — zobacz Bridge.

Claude (web / desktop)

  1. Settings → Connectors → Add custom connector.
  2. URL: https://mcp.fainflow.com/mcp.
  3. Kliknij Connect — otworzy się okno logowania Fainflow; zaloguj się i zatwierdź.

Claude widzi wtedy Twoje narzędzia Fainflow w każdym czacie, w którym konektor jest włączony.

Claude Code (CLI)

Dodaj serwer, a następnie uwierzytelnij się — Claude Code otwiera Twoją przeglądarkę i automatycznie obsługuje pętlę loopback OAuth. Za każdym razem wybiera wolny lokalny port, a Fainflow akceptuje dowolne wywołanie zwrotne loopback, więc nie ma nic do konfigurowania:

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

Następnie uruchom /mcp wewnątrz Claude Code i wybierz fainflow, aby się zalogować. Możesz też dodać go ręcznie do .mcp.json:

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

Cursor

Settings → MCP → Add new MCP server, transport HTTP, URL https://mcp.fainflow.com/mcp. Cursor otwiera przeglądarkę w celu zalogowania i wraca automatycznie.

ChatGPT

Settings → Connectors → Advanced → Developer mode, następnie dodaj konektor z adresem URL serwera MCP https://mcp.fainflow.com/mcp i uwierzytelnianiem OAuth. Zatwierdź logowanie Fainflow, gdy pojawi się monit.

VS Code (GitHub Copilot)

Dodaj do swojego mcp.json (Command Palette → MCP: Add Server → HTTP):

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

VS Code przeprowadzi Cię przez logowanie OAuth przy pierwszym użyciu.

n8n

Użyj węzła MCP Client Tool. Punkt końcowy Fainflow komunikuje się przez Streamable HTTP, który węzeł obsługuje od n8n 1.104+ (wcześniejsze wersje oferują tylko przestarzały transport SSE):

  1. Dodaj MCP Client Tool do swojego workflow (jako narzędzie AI Agent).
  2. Endpoint: https://mcp.fainflow.com/mcp (lub adres URL pojedynczego bridge).
  3. Server Transport: HTTP Streamable. Authentication: OAuth2.
  4. Dokończ logowanie Fainflow, gdy n8n je otworzy.

Samodzielnie hostowany n8n: wywołania zwrotne OAuth muszą być wcześniej zarejestrowane. n8n Cloud działa od razu; w przypadku samodzielnie hostowanej instancji skontaktuj się z nami z adresem URL Twojej instancji lub podłącz punkt końcowy pojedynczego bridge przez proxy typu bearer.

Inne klienty MCP (mcp-remote)

Klienty obsługujące wyłącznie stdio mogą użyć mcp-remote:

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

Co potrafi AI

Po podłączeniu punktu końcowego przestrzeni roboczej lista narzędzi klienta obejmuje:

  • whoami, list_flows, get_flow, create_flow, set_flow_data, list_flow_templates — inspekcja i tworzenie flow
  • create_api_trigger_route, bind_flow_route, enable_flow — doprowadzenie flow typu API-trigger w pełni do działania (te same limity planu i walidacja grafu, co w panelu)
  • list_flow_history, get_flow_execution — sprawdzenie, czy zbudowany flow faktycznie się wykonał (wartości wykonania są usuwane ze względu na prywatność); delete_flow_history, delete_flow do porządkowania
  • create_api_key, list_api_keys, delete_api_key — zarządzanie kluczami, które wywołują flow typu API-trigger (klucz pokazywany jest raz)
  • set_flow_secret, list_flow_secrets, delete_flow_secret — zarządzanie vaultem per flow, do którego flow odwołuje się jako {{vault.KEY}}
  • list_connections, describe_connection_tools — podgląd, co jest podłączone
  • list_bridges, get_bridge, create_bridge, set_bridge_graph, set_bridge_sources, delete_bridge — budowanie bridge
  • każde narzędzie z Twoich podłączonych serwerów MCP (GitHub, Atlassian, …), z prefiksem danego połączenia

Wszystko działa jako Ty: AI widzi wyłącznie Twoje własne flow, połączenia i bridge, a każda akcja jest objęta tym samym rejestrowaniem audytowym co panel.

Rozwiązywanie problemów

  • 401 po podłączeniu — token wygasł, a klient go nie odświeżył; rozłącz i podłącz serwer w kliencie ponownie.
  • Okno logowania nigdy nie wraca (klienty CLI) — karta przeglądarki klienta nie przekazała wywołania zwrotnego z powrotem; zamknij ją, uruchom ponownie /mcp (Claude Code) i dokończ logowanie w świeżej karcie. Fainflow akceptuje wywołanie zwrotne loopback na dowolnym porcie, więc nie ma portu do ustawienia.
  • Pusta lista narzędzi poza podstawowymi — nie masz jeszcze żadnych połączeń MCP; dodaj jedno najpierw w panelu (jak).