n8n

Konfiguracja serwera MCP Hypris w kliencie n8n (n8n), krok po kroku.

  • n8n
  • Agenci i automatyzacje
  • Klucz API
Na tej stronie

Hypris działa w kliencie n8n jako zdalny serwer MCP. n8n łączy się kluczem API, który wysyłasz w nagłówku Authorization jako HTTP Basic: base64(keyId:secret). Klucz utworzysz w ustawieniach konta, w sekcji Klucze API. Do konfiguracji współdzielonych i automatyzacji lepszy jest klucz aplikacji, bo działa tylko w jej uprawnieniach. Szczegóły znajdziesz w przewodniku Klucze API.

Konfiguracja

  1. Do węzła AI Agent dodaj narzędzie MCP Client.

  2. Wklej adres serwera i wybierz transport HTTP Streamable.

  3. Uwierzytelnij się nagłówkiem z kluczem API Hypris.

MCP Client Tool
Endpoint:        https://mcp.staging.hypris.com
Transport:       HTTP Streamable
Authentication:  Header Auth
  Name:          Authorization
  Value:         Basic <base64(keyId:secret)>

Sprawdź połączenie

Napisz w n8n: „Jakie bazy mam w Hypris?”. Klient powinien wywołać narzędzie search_tools, znaleźć narzędzie do listowania baz i uruchomić je przez execute_tool. Jeśli widzisz listę swoich baz, połączenie działa.

Gdy coś nie działa

  • 401 Unauthorized. Sprawdź, czy klucz jest włączony i nie wygasł, oraz czy nagłówek ma postać Basic, a nie Bearer. Zakoduj w base64 cały ciąg keyId:secret, razem z dwukropkiem.

  • Asystent nie widzi bazy albo dokumentu. Serwer pokazuje tylko to, do czego masz dostęp w wybranym workspace. Asystent może poprosić administratora o brakujące uprawnienie narzędziem create_permission_request.

  • Narzędzia się nie pojawiają. Upewnij się, że klient obsługuje transport Streamable HTTP i że adres to dokładnie https://mcp.staging.hypris.com.

Co dalej