Zdalny agent

Narzędzia deweloperskie

Przekaźnik do serwerów MCP w Twojej sieci

Zdalny agent to mały przekaźnik. Instalujesz go na serwerze w swojej sieci, nad którym masz kontrolę. Przekaźnik sprawdza klucz API w każdym żądaniu. Gdy żądanie wskazuje dozwolony wewnętrzny serwer MCP, przekaźnik przesyła je dalej. Zapisuje też, co zrobił. Jeden publiczny adres może wtedy obsłużyć kilka prywatnych serwerów MCP.

Konrado łączy się z prywatnym serwerem przez przekaźnik za pomocą połączenia Własny serwer MCP. To połączenie zawiera nazwę i token serwera docelowego. Samo połączenie Zdalny agent sięga dziś tylko do własnych narzędzi przekaźnika, a z nich Konrado nie ma żadnego pożytku.

Jak to działa

Przekaźnik odpowiada pod /mcp i /sse. Każde żądanie musi zawierać jego klucz API:

Authorization: Bearer <API_KEY>

Żądanie bez nagłówków celu zostaje w samym przekaźniku. Żądanie z oboma nagłówkami celu trafia dalej, do wskazanego serwera MCP:

Target-Host: <target-host>
Target-Token: <target-token>

Przekaźnik porównuje Target-Host z listą dozwolonych HOSTS. Potem łączy się z http://<host>/mcp albo z internalHost danego hosta i wysyła tam Target-Token jako token typu bearer. Odpowiedź serwera docelowego przekazuje bez zmian. Przekaźnik odrzuca żądanie, które ma tylko jeden z dwóch nagłówków.

Co potrafi przekaźnik

Czego Konrado nie potrafi

Zanim zaczniesz

• Dostęp SSH jako root do maszyny, na której działa przekaźnik. Maszyna potrzebuje Pythona 3.10 lub nowszego, curl, unzip i systemd.
• Dostęp wychodzący z tej maszyny do docelowych serwerów MCP.
• Wolny port TCP. Przekaźnik i jego pulpit używają portu 8001, chyba że go zmienisz.
• Port 8001 otwarty dla adresów IP Konrado (zobacz listę).

Podłączanie

bash <(curl -s https://repo.konrado.ai/remote-agent/init.sh) --api-key=YOUR_KEY --callback-url=https://app.konrado.ai/api/integrations/servers/install

Dostęp do prywatnego serwera MCP

Dla każdego prywatnego serwera MCP dodaj w Konrado połączenie Własny serwer MCP, które wskazuje na przekaźnik.

Konrado wysyła te trzy nagłówki z każdym żądaniem, a przekaźnik przesyła każde żądanie do celu. Narzędzia celu działają wtedy jak narzędzia każdego własnego serwera MCP. Konrado korzysta tylko z tych oznaczonych readOnlyHint: true i nie są one przypisane do usługi konkretnego klienta. Przeczytaj stronę o własnym serwerze MCP, aby poznać szczegóły.

Przekaźnik działa na zwykłym HTTP, więc nagłówki są przesyłane bez szyfrowania. Aby je zaszyfrować, umieść przekaźnik za własnym serwerem proxy HTTPS i wpisz jego adres https:// w polu Adres serwera.

Pulpit

Zakładka Logs pokazuje ostatnie żądania, kody statusu, czas trwania, informację, czy żądanie przeszło, czy zostało zablokowane, host celu i powód zablokowania.

W zakładce Configuration edytujesz HOSTS. Zmiany trafiają do pliku .env przekaźnika.

Jeśli później zmienisz SERVER_PORT, uruchom usługę ponownie i otwórz nowy port w zaporze. Konrado nadal łączy się ze starym adresem. Otwórz więc wiersz integracji Zdalny agent w Konrado i zmień w polu Adres serwera port na nowy.

Ustawienia

Przekaźnik odczytuje te ustawienia z pliku .env:

Każdy wpis w HOSTS może zawierać:

HOSTS='[
  {"host":"203.0.113.20:8000","label":"Direct target"},
  {"host":"konrado-test:8000","internalHost":"203.0.113.20:8000","label":"Alias through internalHost"}
]'

Sprawdź, czy działa

Przekaźnik widnieje na stronie Integracje ze statusem Połączono, typem Zdalny agent i numerem wersji. Konrado ponownie sprawdza połączenie co godzinę. Możesz też sprawdzić sam przekaźnik:

curl http://<SERVER_IP>:8001/health

Przekaźnik odpowiada {"status": "healthy", "service": "Konrado AI Remote Agent"}. Aby sprawdzić trasę do celu, wyślij żądanie MCP z oboma nagłówkami celu:

curl -i -X POST http://<SERVER_IP>:8001/mcp \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Target-Host: <target-host>" \
  -H "Target-Token: <target-token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Jeśli coś nie działa

systemctl status   konrado-mcp-remote-agent.service
journalctl         -u konrado-mcp-remote-agent.service --since "15 minutes ago" --no-pager
systemctl restart  konrado-mcp-remote-agent.service
ss -ltnp | grep ':8001'

Aktualizacja przekaźnika

Gdy pojawi się nowa wersja, wiersz na stronie Integracje pokazuje Aktualizuj do v…. Konrado nie zaktualizuje przekaźnika za Ciebie. Kliknij ten przycisk, a potem uruchom pokazane polecenie na maszynie przekaźnika:

bash /opt/KonradoAiRemoteAgent/scripts/update.sh

Usuń integrację

Otwórz Ustawienia obszaru roboczegoIntegracje, otwórz menu wiersza (trzy kropki) i wybierz Usuń. Jeśli nic innego nie korzysta z przekaźnika, usuń go z maszyny jako root:

systemctl disable --now konrado-mcp-remote-agent.service
rm /etc/systemd/system/konrado-mcp-remote-agent.service
systemctl daemon-reload
rm -rf /opt/KonradoAiRemoteAgent
userdel konrado-mcp-remote-agent
groupdel konrado-mcp-remote-agent