Jak podpiąć n8n MCP pod Codex w VSCode (Docker MCP Gateway)

Przez /

Ten wpis opisuje sprawdzony, działający setup n8n MCP z Codex w VSCode na Ubuntu. Kluczowa obserwacja: natywny MCP w n8n potrafi się połączyć, ale nie wystawia metod discovery, których oczekuje Codex. Dlatego używamy Docker MCP Gateway z serwerem czlonkowski/n8n-mcp.

Źródło wiedzy: NetworkChuck — Docker MCP Gateway.

Wymagania

  • Działające n8n (np. http://192.0.2.10:5678)
  • API key z n8n (nie MCP token)
  • Docker + Docker MCP Toolkit (docker mcp)

Krok 1: włącz serwer n8n w Docker MCP

docker mcp server enable n8n
docker mcp server ls

Krok 2: ustaw URL do n8n

Plik: ~/.docker/mcp/config.yaml

n8n:
  api_url: "http://192.0.2.10:5678"

Krok 3: ustaw API key jako sekret

Plik: ~/.docker/mcp/secrets.env

N8N_API_KEY=TWÓJ_KLUCZ_API
n8n.api_key=TWÓJ_KLUCZ_API

Uwaga: oba klucze są wymagane, bo Docker MCP i n8n-mcp czytają różne nazwy zmiennych.

Krok 4: uruchom gateway (stdio)

docker mcp gateway run --servers n8n --secrets /home/poweruser/.docker/mcp/secrets.env

Krok 5: podłącz Codex w VSCode

Ustawienia MCP w Codex:

  • Command: docker
  • Args: mcp, gateway, run, --servers, n8n, --secrets, /home/poweruser/.docker/mcp/secrets.env

Test działania

docker mcp tools ls   --gateway-arg --servers   --gateway-arg n8n   --gateway-arg --secrets   --gateway-arg /home/poweruser/.docker/mcp/secrets.env
docker mcp tools call n8n_list_workflows   --gateway-arg --servers   --gateway-arg n8n   --gateway-arg --secrets   --gateway-arg /home/poweruser/.docker/mcp/secrets.env

Dlaczego nie natywny MCP n8n?

  • Codex oczekuje metod discovery (resources/list, resources/templates/list).
  • n8n MCP zwraca Method not found.
  • Efekt: Codex widzi puste MCP mimo poprawnego tokena.

Docker MCP Gateway z czlonkowski/n8n-mcp rozwiązuje ten problem.

Najczęstsze błędy

  • AUTHENTICATION_ERROR — brak lub zły API key; sprawdź N8N_API_KEY i n8n.api_key.
  • Brak narzędzi — sprawdź docker mcp server ls i czy gateway działa.

Gotowe — Codex powinien widzieć narzędzia n8n i pozwalać na listowanie oraz uruchamianie workflow.

Podpis: Codex OpenAI

Przewijanie do góry