01AI i integracje · moduł
MCP dla zewnętrznych agentów AI
Podłącz Claude Code, Codex i inne agenty do swojego ERP w ramach uprawnień konkretnego użytkownika
- Klucz API
- Osobisty token dostępu
- Token MCP
- Konwersacja AI
- 13
- funkcjonalności
- 4
- typy rekordów
- 3
- automatyzacje
- 12
- integracji i narzędzi AI
02Co potrafi moduł
Mniej rutyny. Więcej wartości.
MCP (Model Context Protocol) pozwala zewnętrznym agentom AI, takim jak Claude Code czy Codex, pracować z danymi w Draivix. Agent otrzymuje ten sam katalog narzędzi co wbudowany asystent, a każde wywołanie działa w ramach uprawnień i klucza API konkretnego użytkownika. Twoja firma może podłączać własne agenty bez obchodzenia kontroli dostępu i dzienników audytu.
- Agent dokładnie wie, co może wywołaćZewnętrzny agent AI pobiera katalog narzędzi wraz z opisami danych wejściowych i wyjściowych. Twoje agenty pracują z danymi przez udokumentowany interfejs, a nie metodą prób i błędów.
- 85 narzędzi pod jednym punktem końcowymPrzez pojedynczy punkt końcowy agent uzyskuje dostęp do wszystkich 85 dozwolonych narzędzi wbudowanego asystenta, co upraszcza integrację własnych agentów.
- Wbudowane zabezpieczenie dla propozycji zmianOperacje zapisu przez most możliwości domyślnie zwracają propozycję zmiany. Agent lub użytkownik zatwierdza ją wywołaniem mutation_confirm albo anuluje za pomocą mutation_cancel.
- Klucze ograniczone do wybranych narzędziKlucz API, którego agent używa do logowania, można ograniczyć do wskazanej listy narzędzi. Agent otrzymuje dostęp wyłącznie do tego, na co pozwala Twoja firma — i do niczego więcej.
- Klucz na stałe przypięty do trybu clean roomKlucz API można na stałe przypiąć do trybu clean room dla danych wrażliwych. Taki klucz widzi w katalogu wyłącznie narzędzia przeznaczone dla trybu clean room.
- Agenty nigdy nie przekraczają uprawnień użytkownikaRzeczywisty dostęp agenta to część wspólna uprawnień użytkownika oraz górnego limitu klucza API. Agent może zrobić tylko to, na co pozwalają oba te poziomy, a sam klucz nigdy nie odblokowuje żadnego rekordu.
- Dedykowany serwer dla Twoich agentówSamodzielny serwer MCP (Model Context Protocol) newerp-agents-mcp oferuje 53 narzędzia zbudowane na bazie REST API. Jego zapisy wykonują się natychmiast w ramach uprawnień użytkownika, bez etapu zatwierdzania propozycji.
- Uwierzytelnianie dopasowane do agentaAgent loguje się przekazanym tokenem, osobistym tokenem dostępu lub poprzez podpisanie wyzwania kluczem SSH — to ostatnie rozwiązanie doskonale sprawdza się dla agentów wiersza poleceń.
- Praca agenta widoczna bezpośrednio w zadaniu12 narzędzi łączy pracę agenta z zadaniami i commitami kodu w GitLab, dzięki czemu bezpośrednio na karcie zadania widzisz dokładnie, co wykonał agent.
- Narzędzia czatu i dokumentów na żądanieSerwer można rozszerzyć o opcjonalne narzędzia dla Mattermost oraz analizę dokumentów opartą na Gemini (wymagającą klucza API Gemini). Włączasz tylko to, z czego faktycznie korzystasz.
- Każde wywołanie zapisane w dzienniku audytuKażde wywołanie agenta trafia do dziennika audytu ze źródłem mcp, dzięki czemu zawsze odróżnisz działania zewnętrznego agenta od operacji wykonanych przez człowieka w aplikacji.
- Limit 600 wywołań na minutęMost możliwości — interfejs dla agentów wbudowany bezpośrednio w Draivix — jest ograniczony do 600 wywołań na minutę, co utrzymuje obciążenie generowane przez agenty w bezpiecznych granicach.
- Przekazanie konwersacji do usługi HermesKonwersację z asystenta można przekazać do usługi agentowej Hermes z krótkotrwałym poświadczeniem ważnym przez 300 sekund. Działa ona z uprawnieniami użytkownika, który rozpoczął rozmowę, i jest rejestrowana w ścieżce audytu.
03Jak to działa
Jak to działa krok po kroku.
Dwie ścieżki podłączenia agentów
Pierwsza ścieżka to most możliwości (capability bridge) wbudowany bezpośrednio w Draivix. Agent pobiera katalog narzędzi i wywołuje je przez jeden punkt końcowy. Katalog obejmuje dozwolone narzędzia wbudowanego asystenta (85 z około 100 zarejestrowanych narzędzi) oraz dziewięć akcji: zatwierdzanie lub anulowanie propozycji zmiany, edycję pozycji w propozycji zbiorczej, wysyłanie wiadomości e-mail oraz zamykanie wyświetlonego obszaru roboczego. Katalog jest wersjonowany; jeśli nic się nie zmieniło, serwer informuje, że wersja jest aktualna, dzięki czemu agent nie musi pobierać go ponownie.
Zobacz szczegóły
Druga ścieżka to samodzielny serwer MCP newerp-agents-mcp, który opakowuje ogólne REST API na potrzeby agentów programistycznych i operacyjnych. Udostępnia 53 narzędzia: pracę z rekordami i metadanymi, relacjami, załącznikami, pocztą e-mail, zadaniami, aktywnościami i raportami, wyszukiwanie globalne, kalendarz, 12 narzędzi do łączenia pracy agenta z zadaniami i commitami w GitLab oraz opcjonalnie 7 narzędzi dla Mattermost. Narzędzie do analizy dokumentów wymaga klucza API Gemini. Serwer działa przez stdio lub HTTP i przycina odpowiedzi tak, aby mieściły się w oknie kontekstowym modelu.
Uprawnienia i klucze API
Agent zawsze działa jako konkretny użytkownik. Uprawnienie mostu możliwości pozwala kluczowi jedynie na dostęp do samego interfejsu — samo w sobie nie daje dostępu do żadnego rekordu. Rzeczywisty dostęp stanowi część wspólną uprawnień użytkownika oraz maksymalnego zakresu klucza API. Klucz można ograniczyć do wybranej listy narzędzi i na stałe przypiąć do trybu clean room; taki klucz widzi w katalogu wyłącznie narzędzia dozwolone w trybie clean room.
Zobacz szczegóły
Serwer newerp-agents-mcp nie posiada własnych uprawnień: każde wywołanie przekazuje token użytkownika i przechodzi przez standardowe REST API. Agenty mogą uwierzytelniać się przekazanym tokenem bearer, osobistym tokenem dostępu (PAT) lub poprzez podpisanie wyzwania (challenge) kluczem SSH — co sprawdza się idealnie w przypadku agentów działających z wiersza poleceń.
Most możliwości ma limit 600 wywołań na minutę. Każde wywołanie odbywa się w kontekście audytowym oznaczonym źródłem mcp oraz identyfikatorem śladu (trace ID). Informacja o tym, czy narzędzie modyfikuje dane, jest przekazywana agentowi jako standardowa wskazówka MCP (tylko do odczytu lub modyfikujące).
Kontrola zmian
Most możliwości stosuje tę samą zasadę co wbudowany asystent: narzędzia tworzenia, aktualizacji i usuwania domyślnie zwracają propozycję zmiany. Agent lub użytkownik zatwierdza ją za pomocą mutation_confirm albo anuluje przy użyciu mutation_cancel. Zatwierdzenie ponownie wykonuje właściwą operację w ramach uprawnień użytkownika.
Zobacz szczegóły
Serwer newerp-agents-mcp nie korzysta z propozycji zmian ani z trybu clean room. Wykonywane przez niego zapisy są realizowane natychmiast, zawsze w granicach uprawnień użytkownika, którego tokenem posługuje się agent. W przypadku agentów, dla których chcesz zatwierdzać każdą zmianę, użyj mostu możliwości.
Delegowanie do usługi agentowej Hermes
Konwersację z wbudowanego asystenta można przekazać do usługi agentowej Hermes. Hermes otrzymuje krótkotrwałe poświadczenie ważne przez 300 sekund, powiązane z firmą, i komunikuje się zwrotnie przez most możliwości. Wywołania działają z uprawnieniami użytkownika, który rozpoczął konwersację, a trybu clean room nie można rozszerzyć. Każde oddelegowane wywołanie jest rejestrowane w dzienniku audytu jako istotne dla bezpieczeństwa.
04Co dzieje się automatycznie
Automatyzacje, które oszczędzają czas.
Brak zbędnego pobierania katalogu
Katalog narzędzi jest buforowany przez 15 minut dla danej firmy i wersji. Gdy agent zgłasza się do serwera, a katalog nie uległ zmianie, serwer nie wysyła go ponownie i agent nie musi go jeszcze raz pobierać.
Ślad audytowy dla każdego wywołania
Każde wywołanie agenta automatycznie tworzy wpis w dzienniku audytu oznaczony źródłem mcp oraz identyfikatorem śladu (trace ID), co ułatwia późniejsze wyszukanie dowolnej konkretnej operacji.
Poświadczenia wygasają automatycznie
W momencie przekazania konwersacji usługa Hermes otrzymuje powiązane z firmą poświadczenie, które wygasa po 300 sekundach, dzięki czemu dostęp pozostaje ściśle krótkotrwały.
Integracje zewnętrzne
- Claude Code jako agentPodłącz Claude Code do Draivix przez MCP (Model Context Protocol). Agent pracuje z danymi w ramach uprawnień i klucza API konkretnego użytkownika, bez omijania kontroli uprawnień ani logowania audytowego.
- Codex na tych samych zasadachCodex łączy się z Draivix przez MCP i otrzymuje ten sam katalog narzędzi co wbudowany asystent. Każde wywołanie jest uruchamiane w ramach uprawnień konkretnego użytkownika.
- Hermes przejmuje konwersacjęUsługa agentowa Hermes przejmuje przekazaną konwersację od asystenta i wywołuje narzędzia zwrotnie przez most możliwości. Trybu clean room nie można rozszerzyć, a każde wywołanie jest zapisywane w dzienniku audytu.
- Analiza dokumentów przez GeminiSerwer newerp-agents-mcp zawiera narzędzie do analizy dokumentów oparte na modelu Gemini (wymaga klucza API Gemini), co pozwala agentowi pracować również z treścią dokumentów.
- Praca agenta powiązana z commitamiNarzędzia w newerp-agents-mcp łączą pracę agenta z zadaniami i commitami w GitLab, dzięki czemu możesz prześledzić działania agenta bezpośrednio w odpowiednim zadaniu.
- Mattermost zawsze wtedy, gdy go potrzebujeszSerwer newerp-agents-mcp można rozszerzyć o 7 opcjonalnych narzędzi Mattermost, pozwalając agentowi współpracować z czatem zespołowym zawsze wtedy, gdy Twoja firma tego potrzebuje.
Czym zajmuje się agent AI
Dostęp do danych dla Twoich agentów
Zewnętrzny agent może odczytywać, wyszukiwać i zliczać rekordy dowolnej encji (typu rekordu), widząc wyłącznie to, na co pozwalają uprawnienia użytkownika oraz jego klucz API.
Zmiany zaczynają się od propozycji
Przez most możliwości agent domyślnie jedynie proponuje zmianę rekordu. Dopiero gdy agent lub człowiek ją zatwierdzi, operacja jest ponownie uruchamiana w ramach uprawnień użytkownika.
Dopracowanie propozycji zbiorczych przed zatwierdzeniem
Poszczególne pozycje w propozycji zbiorczej można edytować przed zatwierdzeniem, dzięki czemu nie musisz odrzucać całej paczki z powodu jednego błędnego elementu.
Agenty mogą też wysyłać wiadomości e-mail
Agent może wysłać wiadomość e-mail jako jedną z akcji dostępnych w katalogu narzędzi. Operacja jest wykonywana w kontekście konkretnego użytkownika i rejestrowana w dzienniku audytu, więc zawsze wiadomo, kto za nią stoi.
Załączniki i poczta e-mail przez serwer
Za pośrednictwem serwera newerp-agents-mcp agent może pracować z załącznikami i pocztą e-mail. Zapisy są wykonywane natychmiast w ramach uprawnień użytkownika; jeśli chcesz zatwierdzać każdą zmianę, skorzystaj z mostu możliwości.
Praca agenta przypisana do właściwego zadania
Agent łączy swoją pracę z zadaniami i commitami kodu w GitLab, dzięki czemu podczas weryfikacji od razu widzisz, do którego zadania należą wprowadzone zmiany.
Człowiek zatwierdza zawsze, gdy w grę wchodzą pieniądze, klient lub wyjątek.
05Często zadawane pytania
Czy mogę podłączyć Claude Code lub innego agenta AI do Draivix?
Tak. Agent łączy się przez MCP — albo za pośrednictwem mostu możliwości w Draivix, albo przez samodzielny serwer newerp-agents-mcp — i działa z uprawnieniami użytkownika, którego klucza lub tokenu używa.
Czy agent może ominąć uprawnienia przez MCP?
Nie. Każde wywołanie działa w kontekście konkretnego użytkownika, a rzeczywisty dostęp jest częścią wspólną uprawnień tego użytkownika oraz maksymalnego zakresu klucza API. Klucz można dodatkowo ograniczyć do wybranych narzędzi.
Czy agent zapisuje zmiany natychmiast?
Przez most możliwości operacje tworzenia, aktualizacji i usuwania domyślnie zwracają propozycję, którą trzeba osobno zatwierdzić. Serwer newerp-agents-mcp zapisuje zmiany natychmiast w ramach uprawnień użytkownika.
Czy mogę prześledzić, co agent zrobił w systemie?
Tak. Każde wywołanie przez most możliwości jest rejestrowane w ścieżce audytu ze źródłem mcp oraz identyfikatorem śladu (trace ID), a oddelegowane wywołania z usługi Hermes są oznaczane jako istotne dla bezpieczeństwa.
06Powiązane moduły
Moduły, które świetnie ze sobą współpracują.
Wszystkie moduły w obszarze AI i integracje- Asystent AI w DraivixAsystent wbudowany w aplikację, który wyszukuje dane, przygotowuje projekty zmian i zapisuje je dopiero po Twoim zatwierdzeniu
- Automatyczne REST API i webhookiSterowane metadanymi REST API dla każdej encji wraz z dokumentacją OpenAPI i webhookami
- GitLab i zadania programistyczneŁączy commity i merge requesty z GitLab z zadaniami oraz przenosi zadania do weryfikacji (review)
- Czat zespołowy i połączenia (Mattermost)Firmowy czat, kanały projektów i klientów oraz rozmowy wideo bezpośrednio w systemie ERP
- Sejf hasełSzyfrowany zespołowy sejf haseł z udostępnianiem folderów, datami ważności i dziennikiem dostępu
- Asystent głosowy i transkrypcja mowy na tekstDyktuj zapytania, transkrybuj nagrania i obsługuj system ERP głosem dzięki asystentowi AI
- Import sklepu internetowego z WooCommerceWczytuje katalog, klientów i zamówienia z WooCommerce oraz wysyła opisy produktów z powrotem do sklepu internetowego
- Migracja z EspoCRM i praca równoległaPorównuje i synchronizuje rekordy z EspoCRM podczas migracji lub pracy równoległej
- OAuth2 i OIDC dla dodatkówBezpieczne logowanie dodatków do Draivix przez OAuth2 i OpenID Connect z PKCE
Zacznijmy razem
Opowiedz nam, jak działa Twoja firma.
Pokażemy Ci, jak może wyglądać system, który przejmie część tej pracy.
Umów konsultację