Podłącz serwer MCP
Fainflow pozwala podłączyć dowolny zdalny serwer MCP (Model Context Protocol) — własny lub popularny, jak Atlassian (Jira/Confluence) czy GitHub. Po podłączeniu jego narzędzia stają się dostępne wewnątrz flow (akcja Call MCP Tool) oraz w bridge. Każdy użytkownik podłącza własne serwery — Twoje dane uwierzytelniające są szyfrowane i przypisane wyłącznie do Ciebie.
Serwer podłączasz jedną z pięciu metod uwierzytelniania. Wybierz tę, którą opisuje dokumentacja serwera.
Metody uwierzytelniania
| Metoda | Użyj, gdy serwer… | Ty podajesz |
|---|---|---|
| None (public) | nie wymaga uwierzytelniania | nic |
| Bearer token | oczekuje Authorization: Bearer <token> | token |
| API key header | oczekuje niestandardowego nagłówka (np. X-API-Key) | nazwę nagłówka + wartość |
| Basic | oczekuje nazwy użytkownika + hasła/tokenu | nazwę użytkownika + sekret |
| OAuth (sign in) | używa OAuth 2.0 (logujesz się u dostawcy) | nic — autoryzujesz w wyskakującym oknie |
Zasada ogólna: token (Bearer / API key / Basic) jest najszybszy — wklejasz dane uwierzytelniające, które już masz. OAuth jest najwygodniejszy dla obsługiwanych dostawców — logujesz się, a Fainflow przechowuje i automatycznie odświeża tokeny za Ciebie.
Jak podłączyć
- Dashboard → Connections → Add connection → wyszukaj MCP Server.
- Wprowadź URL serwera (np.
https://mcp.atlassian.com/v1/mcp). - Wybierz metodę Authentication.
- Metody tokenowe → wypełnij dane uwierzytelniające → Create. OAuth → Connect with OAuth i zatwierdź w wyskakującym oknie.
Połączenie staje się active, gdy Fainflow może dotrzeć do serwera i pobrać listę jego narzędzi.
Metody tokenowe (Bearer / API key / Basic)
Per-user i najprostsze — dostarczasz dane uwierzytelniające, którymi zarządzasz; są przechowywane zaszyfrowane w vault. Po stronie Fainflow nie jest potrzebne nic dodatkowego.
- Bearer — wklej token; wysyłany jako
Authorization: Bearer <token>. - API key header — podaj nazwę nagłówka (np.
X-API-Key) i klucz. - Basic — nazwa użytkownika + hasło (lub nazwa użytkownika + token API).
To, co token może zrobić, decyduje serwer (własne zakresy/uprawnienia tokenu).
OAuth (logowanie)
Kliknij Connect with OAuth → zostaniesz przekierowany do dostawcy, aby zalogować się i autoryzować Fainflow → wracasz do Connections, a połączenie jest active. Fainflow przechowuje tokeny access i refresh oraz odświeża je automatycznie.
Istnieją dwa rodzaje serwerów MCP z OAuth, różniące się jedynie jednorazową konfiguracją:
- Samorejestrujące (DCR) — np. Atlassian. Działają od razu: Fainflow automatycznie rejestruje klienta OAuth dla każdego połączenia. Bez konfiguracji operatora.
- Wymagana wstępnie zarejestrowana aplikacja — np. GitHub (jego OAuth
nie ma rejestracji dynamicznej). Operator Fainflow rejestruje jedną
aplikację OAuth dla tego dostawcy, współdzieloną przez wszystkich użytkowników
(klucze konfiguracyjne jak
GITHUB_OAUTH_CLIENT_ID/SECRET). To jednorazowy krok operatora, nie per-user — i jest potrzebny wyłącznie dla ścieżki OAuth. Ścieżka tokenowa nigdy go nie potrzebuje.
Atlassian — oba sposoby
- OAuth → pełny zestaw narzędzi Atlassian Rovo (Jira + Confluence — ~31
narzędzi: wyszukiwanie/pobieranie/tworzenie/edycja/przejścia zgłoszeń, strony,
przestrzenie, …).
- Allowlist organizacji: administrator Twojej organizacji Atlassian musi
dodać do allowlisty adres przekierowania
https://<your-fainflow-domain>/dashboard/api/auth/mcp/callbackdla Twojej witryny — zobacz przewodnik Atlassian Control Atlassian Rovo MCP server settings. Do tego czasu ekran zgody informuje „organization admin must authorize”.
- Allowlist organizacji: administrator Twojej organizacji Atlassian musi
dodać do allowlisty adres przekierowania
- Token → użyj Basic z Twoim e-mailem Atlassian + tokenem API. Standardowe narzędzia Jira/Confluence działają; niektóre narzędzia Rovo / Teamwork-Graph są dostępne tylko przez OAuth/dla administratora, dlatego dla pełnego dostępu zalecany jest OAuth.
GitHub — oba sposoby
- OAuth → Connect with OAuth i zaloguj się do GitHub (używa współdzielonej aplikacji operatora).
- Token → wklej Personal Access Token (PAT) GitHub jako Bearer. Ograniczony do zakresu PAT; aplikacja operatora nie jest potrzebna.
Rozwiązywanie problemów
- Zgoda informuje „organization admin must authorize” → dodaj adres przekierowania do allowlisty po stronie dostawcy (Atlassian: przewodnik ustawień Rovo MCP).
- Brakujące narzędzia / 401 przy wywołaniach → zakresy/uprawnienia tokenu są zbyt wąskie lub token wygasł — wystaw go ponownie albo połącz ponownie przez OAuth (który odświeża się automatycznie).
- Połączenie wydaje się zawieszone → rozwiązane; serwery, które nie implementują metadanych RFC 9728, są obsługiwane. Jeśli problem się utrzymuje, ponów świeże połączenie (nie używaj starego linku autoryzacyjnego).