Skip to main content

EZD przez AI: serwer MCP dla systemu dokumentów urzędu

Otwarty serwer MCP, który daje Claude dostęp do API systemu EZD PUW: sprawy, dokumenty, korespondencja, ePUAP i e-Doręczenia. Urzędnik opisuje zadanie zdaniem, a AI wykonuje je w systemie dokumentów.

Branża: Administracja publiczna, urzędy

W skrócie

  • Otwarty serwer MCP dla EZD PUW, licencja MIT
  • 91 narzędzi MCP pogrupowanych według modułów systemu
  • Działa w Claude Desktop i Claude Code
  • Uwierzytelnianie tokenem SHA256 przy każdym żądaniu

O projekcie

EZD PUW to system elektronicznego zarządzania dokumentacją używany w administracji publicznej. Ma rozbudowane API, ale żeby z niego skorzystać, trzeba znać jego moduły, identyfikatory i sposób uwierzytelniania. ezd-puw-mcp opakowuje to API w narzędzia MCP, z których korzysta model językowy.

Wyzwanie

Urzędnik nie powinien uczyć się API, żeby założyć sprawę, zarejestrować pismo wychodzące albo sprawdzić wpływy z ePUAP. Trzeba było przełożyć interfejs programistyczny systemu na narzędzia, które AI wywołuje na prośbę wyrażoną zwykłym zdaniem.

Cele

  • Objąć moduły API EZD PUW: sprawy, dokumenty, korespondencję, pracowników
  • Obsłużyć ePUAP i e-Doręczenia
  • Ukryć uwierzytelnianie przed użytkownikiem
  • Działać lokalnie w Claude Desktop i Claude Code

Wyzwania techniczne

Token liczony przy każdym żądaniu

EZD PUW wymaga dla każdego wywołania nowego identyfikatora GUID i skrótu SHA256 z GUID, tokenu aplikacji i bieżącej godziny. Serwer liczy to sam i dodaje właściwe nagłówki.

Kilka zestawów endpointów

System ma osobne moduły API, między innymi Api1 i Api3 oraz moduły dokumentów, koszulek i pracowników. Narzędzia są pogrupowane tak jak moduły systemu, żeby AI wybierało właściwe wywołanie.

Rozwiązanie i wdrożenie

Sprawy i koszulki

Tworzenie, edycja, przekazywanie, udostępnianie, zamykanie i wznawianie spraw oraz wyszukiwanie w nich.

Korespondencja, ePUAP i e-Doręczenia

Rejestracja korespondencji wychodzącej i zmiana jej statusu, rejestracja i wyszukiwanie wpływów z ePUAP oraz rejestracja e-Doręczeń.

Pracownicy, RWA i archiwum

Zarządzanie pracownikami i szablonami obiegu, numery teczek RWA, utrwalanie dokumentów w module blockchain i import paczek migracyjnych.

Rezultaty

System dokumentów obsługiwany zdaniem

Zamiast klikać po modułach, opisujesz zadanie, a AI wywołuje odpowiednie narzędzie EZD.

Jeden punkt wejścia do API

Wszystkie moduły systemu są dostępne z jednego serwera MCP, skonfigurowanego raz.

Wnioski

MCP dla administracji

Systemy urzędowe mają API, ale korzysta z nich niewielu integratorów. Serwer MCP udostępnia je każdemu, kto potrafi opisać zadanie.

Zakres

  • Sprawy i koszulki
  • Dokumenty i korespondencja
  • ePUAP i e-Doręczenia
  • Pracownicy i obieg

Technologie

  • MCP
  • TypeScript
  • Node.js 20
  • EZD PUW API

Projekt open source

Język: TypeScript, Node.js 20+. Licencja: MIT.

Instalacja

git clone https://github.com/gacabartosz/ezd-puw-mcp.git
cd ezd-puw-mcp
npm install
npm run build

Konfiguracja klienta MCP

{
  "mcpServers": {
    "ezd-puw": {
      "command": "node",
      "args": ["/absolute/path/to/ezd-puw-mcp/dist/index.js"],
      "env": {
        "EZD_HOST": "ezd.twoj-urzad.gov.pl",
        "EZD_APP_TOKEN": "twoj-token-aplikacji"
      }
    }
  }
}

Przykład użycia

W Claude poproś o wpływy z ePUAP. Serwer użyje narzędzia wyszukiwania wpływów z modułu Api3.

> Pokaż dzisiejsze wpływy z ePUAP
# ezd_api3_search_epuap_inflow

Najczęstsze pytania

Do czego służy ezd-puw-mcp?

Podłącza AI do systemu EZD PUW. Prosisz Claude na przykład o zarejestrowanie pisma albo wyszukanie wpływów z ePUAP, a serwer wywołuje odpowiednie narzędzie API.

Skąd wziąć token aplikacji?

Token aplikacji uzyskujesz w panelu administracyjnym EZD i wpisujesz w zmienną EZD_APP_TOKEN w konfiguracji serwera.

Gdzie działa serwer?

Lokalnie, przez stdio, i łączy się bezpośrednio z serwerem EZD wskazanym w konfiguracji. Treść poleceń trafia do modelu AI, z którego korzystasz.

Ile narzędzi ma serwer?

91, pogrupowanych według modułów systemu: sprawy, dokumenty, korespondencja, pracownicy, ePUAP i inne.

Wszystkie case studies