Jak połączyć Langflow z protokołem Model Context Protocol (MCP)

Ostatnia aktualizacja: 25/08/2026

  • Langflow działa jako wszechstronny most, pełniąc jednocześnie funkcję klienta i serwera MCP.
  • Dzięki integracji zewnętrzne aplikacje, takie jak Claude Desktop czy Cursor, mogą uruchamiać złożone przepływy Langflow tak, jakby były prostymi narzędziami.
  • System ułatwia dostęp do tysięcy publicznych serwerów MCP, radykalnie zwiększając możliwości agentów AI.
Jak połączyć Langflow z MCP jako klient i serwer

Protokół Model Context Protocol, lepiej znany jako MCP, stał się jednym z najważniejszych komponentów łączących aplikacje sztucznej inteligencji z narzędziami zewnętrznymi, interfejsami API i źródłami danych. Zamiast tworzyć osobną integrację dla każdej usługi, MCP ustanawia wspólny sposób wyszukiwania narzędzi i uruchamiania ich z poziomu kompatybilnych klientów.

Langflow obsługuje korzystanie z tego protokołu w obu kierunkach. Może działać jako Klient MCPłączenie się z serwerami zewnętrznymi w celu importowania narzędzi, a także Serwer MCP, udostępniając przepływy projektu, aby można było z nich korzystać z poziomu klientów Cursor, Claude, Windsurf i innych kompatybilnych.

W tym przewodniku pokażemy, jak połączyć Langflow z MCP, jakie transporty obsługuje, jak konwertować przepływy na narzędzia i jakie środki ostrożności należy podjąć, aby uniknąć publikowania instancji bez uwierzytelnienia.

Co oznacza używanie Langflow jako klienta i serwera MCP?

Użyj Langflow jako klienta i serwera MCP

MCP to otwarty standard łączenia aplikacji sztucznej inteligencji z systemami zewnętrznymi. Często porównuje się go do portu USB-C, ponieważ tworzy wspólny interfejs między narzędziami, które w przeciwnym razie wymagałyby osobnej integracji.

W ramach Langflow istnieją dwa wyraźnie rozróżnione zastosowania:

  • Langflow jako klient MCP: Agent utworzony na płótnie korzysta z narzędzi udostępnianych przez serwery zewnętrzne.
  • Langflow jako serwer MCP: Przepływy pracy projektu są publikowane jako narzędzia, które mogą wywoływać inne aplikacje.

Langflow ma również funkcję zwaną Klient Langflow MCP dla agentów programistycznych. Choć nazwa może być myląca, jest to inna integracja, zaprojektowana tak, aby narzędzia takie jak Claude Code czy Bob mogły budować i uruchamiać przepływy w ramach instancji Langflow.

Langflow jako klient MCP: jak importować narzędzia zewnętrzne

Aby korzystać z Langflow jako klienta, musisz najpierw zarejestrować serwer zewnętrzny. Możesz to zrobić z Ustawienia > Serwery MCP lub poprzez sekcję MCP dostępną na pasku bocznym edytora przepływu.

Platforma umożliwia dodawanie serwerów za pomocą trzech metod:

  • JSON: wklejanie obiektu konfiguracyjnego dostarczonego przez twórcę serwera.
  • STDIO: określając nazwę, polecenie wykonania, jego argumenty i niezbędne zmienne środowiskowe.
  • HTTP/SSE: wprowadzając adres URL serwera, jego nagłówki i wymagane zmienne.

Na przykład serwer obsługujący Python może używać uvx jako polecenie. Serwery oparte na Node.js zazwyczaj używają npxW tym ostatnim przypadku musisz mieć zainstalowaną wersję LTS Node.js.

Jeśli Langflow działa w Dockerze i chcesz użyć serwera opartego na npxNode.js musi być zainstalowany w obrazie kontenera. Nie wystarczy zainstalować go na komputerze hosta.

Dodaj narzędzia MCP do płótna

Po zapisaniu serwera pojawi się on w sekcji MCP na pasku bocznym. Przeciągnij go na obszar roboczy, aby dodać komponent. Narzędzia MCP związane z tym połączeniem.

Wybierz zarejestrowany serwer w odpowiednim polu. W sekcji Narzędzie Możesz wybrać konkretną funkcję lub pozostawić pole puste, aby agent miał dostęp do wszystkich narzędzi publikowanych przez dany serwer.

Udzielenie dostępu do wszystkich narzędzi jest wygodne podczas testów, ale nie zawsze jest to najbezpieczniejsze ani najdokładniejsze podejście. Jeśli serwer oferuje wiele funkcji, najlepiej wybrać tylko te, które są niezbędne w danym procesie.

Aby agent mógł z nich korzystać:

  1. Otwórz górne menu komponentu Narzędzia MCP.
  2. Aktywny Tryb narzędzia.
  3. Podłącz swoje wyjście Zestaw narzędzi z wejściem Narzędzia komponentu Agenta.
  4. Łączy również komponenty wejścia i wyjścia czatu z agentem.
  5. Otwórz plac zabaw i przetestuj żądanie, którego potrzebuje narzędzie.
Ekskluzywna zawartość — kliknij tutaj  Jak przekształcić JPG w ICO

Agent podejmie decyzję o wykonaniu połączenia na podstawie zapytania, otrzymanych instrukcji i opisu każdego narzędzia.

Jak skonfigurować dane uwierzytelniające i zmienne dla serwerów MCP

Rejestrując serwer przez HTTP, możesz dodać własne nagłówki. Pozwala to na korzystanie z metod uwierzytelniania, takich jak klucz API lub token nośnika.

Typowym przykładem może być:

Authorization: Bearer TU_TOKEN

Nie zaleca się zapisywania danych uwierzytelniających bezpośrednio w konfiguracjach, które można eksportować lub udostępniać. Langflow umożliwia korzystanie z zmienne globalne w wartościach nagłówka. Platforma rozwiązuje zmienną przed wysłaniem żądania.

Konfiguracje STDIO umożliwiają również wprowadzenie zmiennych środowiskowych. Są one przekazywane do procesu uruchamiającego serwer, więc muszą być zgodne z nazwami oczekiwanymi przez odpowiednią implementację MCP.

Jeśli przepływ opublikowany jako serwer MCP zawiera komponent narzędzi MCP, Langflow może propagować nagłówek x-api-key o Authorization Otrzymane od klienta do serwera zagnieżdżonego. Należy korzystać z tej funkcji ostrożnie, aby uniknąć wysyłania danych uwierzytelniających do niezaufanych usług.

Jak przekonwertować projekt Langflow na serwer MCP

Użyj Langflow jako serwera MCP

Każdy projekt Langflow może funkcjonować jako samodzielny serwer MCP. Przepływy uruchomione w ramach tego projektu są widoczne dla podłączonych klientów jako narzędzia.

Aby przepływ mógł być używany jako narzędzie, musi zawierać co najmniej jeden komponent Wyjście czatuJeśli to wyjście nie istnieje, przepływ nie będzie gotowy do zwrócenia wyniku do klienta MCP.

Aby sprawdzić, które przepływy są publikowane:

  1. Przejdź do strony projektów Langflow.
  2. Otwórz kartę Serwer MCP.
  3. Wybierać Narzędzia do edycji.
  4. Wybierz tylko te przepływy, które chcesz udostępnić.
  5. Sprawdź nazwę i opis każdego narzędzia.

Możesz również otworzyć przepływ, nacisnąć Udział i wejdź do sekcji Serwer MCP.

Langflow zazwyczaj automatycznie dodaje nowe projekty do konfiguracji serwera MCP. Administrator może jednak wyłączyć to zachowanie za pomocą zmiennych środowiskowych, a każdy przepływ można włączać lub wyłączać indywidualnie.

Jaki jest adres URL serwera Langflow MCP?

Zalecany punkt końcowy dla serwera projektu używa następującego formatu:

http://localhost:7860/api/v1/mcp/project/PROJECT_ID/streamable

Musisz wymienić PROJECT_ID według faktycznego identyfikatora. Langflow wyświetla przygotowany adres w zakładce Serwer MCP, więc zazwyczaj nie trzeba go tworzyć ręcznie.

Istnieje również globalny punkt końcowy:

http://localhost:7860/api/v1/mcp/streamable

Wersja specyficzna dla projektu jest lepsza, gdy chcesz wyraźnie ograniczyć zestaw przepływów prezentowanych klientowi.

Langflow używa HTTP z możliwością przesyłania strumieniowego jako domyślny transport dla serwerów MCP. SSE pozostaje dostępny jako alternatywny mechanizm zapewniający kompatybilność ze starszymi klientami.

W Langflow Desktop domyślny adres może używać portu 7868 zamiast 7860Dlatego najpewniejszą opcją jest zawsze skopiowanie konfiguracji wygenerowanej przez samą aplikację.

Jak skonfigurować nazwy i opisy narzędzi

Klienci MCP korzystają z nazwy i opisu, aby zdecydować, kiedy wywołać każdy przepływ. Ogólna nazwa, taka jak „dane procesu”, dostarcza bardzo mało informacji i może spowodować, że agent wybierze niewłaściwe narzędzie.

Użyj nazw opisujących działanie i wyjaśnień wskazujących na:

  • Jakie zadanie wykonuje narzędzie?
  • Kiedy należy go stosować?
  • Jakich informacji potrzebujesz?
  • Jakie ma ograniczenia?
  • Jakiego typu wynik zwraca?

Na przykład „sprawdź dokumentację techniczną Langflow” jest bardziej pomocne niż „wyszukaj informacje”. Jeśli narzędzie działa tylko z określoną kolekcją lub firmą, to ograniczenie również powinno zostać uwzględnione w opisie.

Jak połączyć Cursor, Claude lub Windsurf z Langflow

Langflow oferuje dwa sposoby dodania serwera do klienta MCP: skopiowanie konfiguracji JSON lub skorzystanie z automatycznej instalacji dostępnej dla niektórych aplikacji lokalnych.

Z zakładki Serwer MCP projektu możesz skopiować konfigurację podobną do tej:

{
  "mcpServers": {
    "langflow-project": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "--transport",
        "streamablehttp",
        "http://localhost:7860/api/v1/mcp/project/PROJECT_ID/streamable"
      ]
    }
  }
}

Ta konfiguracja wykorzystuje mcp-proxy Aby połączyć klienta z punktem końcowym HTTP Streamable, Langflow automatycznie generuje odpowiednie wartości serwera i projektu.

Ekskluzywna zawartość — kliknij tutaj  Jak wyłączyć wyskakujące okienka

Automatyczna instalacja jest dostępna dla kompatybilnych klientów zainstalowanych na tym samym komputerze, takich jak Cursor, Claude lub Windsurf. Na odpowiedniej karcie wybierz klienta i kliknij przycisk, aby go dodać.

Następnie sprawdź, czy serwer pojawia się w konfiguracji MCP klienta. Jeśli nie, uruchom ponownie aplikację lub użyj metody JSON.

Jak chronić serwer Langflow MCP

Nie publikuj serwera dostępnego z Internetu z ustawionym uwierzytelnianiem NicW takim przypadku każda osoba znająca adres może podjąć próbę odkrycia i uruchomienia narzędzi.

Każdy projekt może wykorzystać jedną z poniższych metod:

  • Klucz API: Klient wysyła klucz Langflow przez nagłówek x-api-key.
  • OAuth: Użytkownicy są identyfikowani za pośrednictwem dostawcy zgodnego z OAuth 2.0.
  • Nic: Dostęp bez uwierzytelniania, odpowiedni wyłącznie dla środowisk kontrolowanych.

Konfiguracja znajduje się w Projekty > Serwer MCP > Edytuj autoryzacjęJeżeli instancja korzysta z uwierzytelniania i AUTO_LOGIN=falseLangflow może automatycznie wygenerować określony klucz podczas tworzenia projektu.

Podczas korzystania z klucza API z mcp-proxyKlucz powinien znaleźć się wśród Twoich argumentów:

{
  "mcpServers": {
    "langflow-project": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "--transport",
        "streamablehttp",
        "--headers",
        "x-api-key",
        "TU_CLAVE",
        "http://localhost:7860/api/v1/mcp/project/PROJECT_ID/streamable"
      ]
    }
  }
}

Nie umieszczaj klucza wewnątrz obiektu env tego przykładu, ponieważ te zmienne należą do procesu mcp-proxyNie należy również przesyłać konfiguracji z danymi uwierzytelniającymi do publicznych repozytoriów.

Czym jest Langflow MCP Client do planowania pracy agentów?

Sekcja Ustawienia > Klient Langflow MCP Nie należy tego mylić z publikowaniem projektu jako serwera. Ta integracja ma na celu połączenie agentów harmonogramowania, takich jak Bob lub Claude Code firmy IBM, z instancją Langflow.

Wygenerowane konfiguracje są wykonywane lfx-mcp Poprzez uvx i ustalić dwie główne wartości:

  • LANGFLOW_SERVER_URL, z adresem instancji.
  • LANGFLOW_API_KEY, z prawidłowym kluczem Langflow.

Dzięki temu połączeniu agent programistyczny może pomóc w budowaniu i uruchamianiu przepływów. Postępuj zgodnie z instrukcjami wyświetlanymi przez Langflow dla wybranego klienta, ponieważ pliki i polecenia mogą się różnić w zależności od narzędzia Claude Code, Bob i innych.

Nie należy mylić tej funkcji administracyjnej z projektem publikowanym za pośrednictwem MCP. W pierwszym przypadku agent wchodzi w interakcję z instancją Langflow; w drugim wykorzystuje wybrane przepływy jako narzędzia.

Jak działa tryb narzędzi w Langflow

Tryb narzędzia Umożliwia to połączenie określonych komponentów z wejściem narzędzi agenta. Niektóre komponenty generują dane wyjściowe narzędzia bezpośrednio, podczas gdy inne wymagają aktywacji tej opcji w górnym menu.

Po włączeniu trybu narzędziowego agent może decydować o tym, kiedy wykonać akcję i dynamicznie udostępniać udostępnione parametry. Pozostałe opcje konfigurowane ręcznie pozostają niezmienione.

Nie wszystkie pola są automatycznie obsługiwane. W niestandardowych komponentach Langflow obsługuje tryb narzędziowy dla danych wejściowych, takich jak: DataInput, DataFrameInput, PromptInput, MessageTextInput, MultilineInput y DropdownInput.

Można również ponownie wykorzystać jeden przepływ w innym, korzystając z komponentu Uruchom przepływPo wybraniu przepływu należy aktywować tryb narzędzia i połączyć jego wyjście z agentem.

Typowe błędy występujące podczas łączenia Langflow z MCP

Typowe błędy występujące podczas łączenia Langflow z MCP

Komponent Narzędzia MCP nie pojawia się w kategorii Agenci

W obecnych wersjach należy zarejestrować serwer w Ustawieniach lub sekcji MCP na pasku bocznym. Następnie przeciągnij kartę serwera na kanwę, aby utworzyć komponent Narzędzia MCP.

Serwer oparty na npx nie uruchamia się

Sprawdź, czy masz zainstalowaną wersję LTS Node.js. Jeśli Langflow działa z Dockerem, Node.js i npx Muszą być dostępne wewnątrz kontenera.

Klient nie może znaleźć przepływów projektu

Sprawdź, czy przepływ zawiera dane wyjściowe czatu, które są wybrane w Narzędziach do edycji, i czy klient używa prawidłowego identyfikatora projektu. Sprawdź również, czy klucz API lub konfiguracja OAuth są prawidłowe.

Ekskluzywna zawartość — kliknij tutaj  Jak łączyć notatki w Obsidianie: kompletny przewodnik organizacyjny

localhost nie działa między systemami Windows i WSL

System Windows i WSL mogą być izolowane w różnych sieciach. Klient działający w WSL nie zawsze może uzyskać dostęp do Langflow dla systemu Windows za pomocą tej metody. localhost:7860Uruchom obie usługi w tym samym środowisku lub użyj adresu sieciowego dostępnego z WSL.

Narzędzia MCP tracą tryb narzędzi po aktualizacji

Niektóre przepływy utworzone w starszych wersjach mogą utracić tę konfigurację po aktualizacji. Wybierz komponent ponownie, włącz tryb narzędzi i sprawdź, czy wyjście zestawu narzędzi pozostaje połączone z agentem.

Narzędzie działa zbyt długo i wyłącza się po przekroczeniu limitu czasu.

Langflow umożliwia dostosowanie czasu wykonywania w zaawansowanych opcjach komponentu MCP Tools oraz za pomocą globalnych zmiennych serwerowych. Przed zwiększeniem czasu należy sprawdzić, czy opóźnienie nie jest spowodowane przez model, zewnętrzne API lub którykolwiek węzeł w przepływie.

Automatyzacja przeglądarki nie otwiera żadnych okien w systemie Windows.

Istnieje znane ograniczenie w przypadku niektórych narzędzi przeglądania uruchamianych z procesów Pythona w systemie Windows lub WSL. Agent może wykonać wywołanie bez wizualnego otwierania przeglądarki. W takich przypadkach Langflow zaleca użycie implementacji niezależnej od serwera, niezależnej od serwera MCP i łączenie się z nim za pomocą protokołu HTTP/SSE.

Połączenie Langflow z MCP pozwala na integrację zewnętrznych narzędzi i wizualnych przepływów pracy w ramach jednego ekosystemu. Jako klient, Langflow może integrować funkcje z serwerów STDIO, HTTP lub SSE. Jako serwer, przekształca włączone przepływy pracy każdego projektu w narzędzia wielokrotnego użytku, dostępne za pośrednictwem kreatorów i środowisk programistycznych.

Aby zapewnić niezawodną integrację, należy poprawnie skonfigurować transport, używać opisowych nazw, ograniczyć dostępne narzędzia i zabezpieczyć każdy projekt kluczem API lub OAuth. W ten sposób możesz wykorzystać elastyczność MCP bez niepotrzebnego ujawniania swojej instancji ani jej danych uwierzytelniających.

Alberto Navarro

Alberto Navarro

Jestem entuzjastą technologii, który przekształcił swoje geekowskie zainteresowania w zawód. Spędziłem ponad 10 lat, korzystając z najnowocześniejszych technologii i majsterkując przy przeróżnych programach z czystej ciekawości. Teraz specjalizuję się w technologii komputerowej i grach wideo. Od ponad 5 lat piszę dla różnych stron internetowych o technologii i grach wideo, tworząc artykuły, których celem jest dostarczenie Ci potrzebnych informacji w języku zrozumiałym dla każdego.

Jeśli masz jakieś pytania, moja wiedza obejmuje wszystko, co jest związane z systemem operacyjnym Windows, a także Androidem dla telefonów komórkowych. Moje zaangażowanie jest wobec Ciebie. Zawsze jestem gotowy poświęcić kilka minut i pomóc Ci rozwiązać wszelkie pytania, jakie możesz mieć w tym internetowym świecie.