🔌 Agent AI w emoms: serwer MCP

Co to daje

emoms ma wbudowany serwer MCP (Model Context Protocol). Agent AI, którego już używasz, łączy się z emoms, czyta wbudowane opisy „jak to działa”, sprawdza zamówienie, logi i konfigurację, a potem tłumaczy Ci krok po kroku, co zrobić. Domyślnie dostęp jest tylko do odczytu. Zapisy do ERP (opisy produktów, zdjęcia, ceny) włączasz osobno w zakładce „Konfiguracja” i domyślnie trafiają do poczekalni do Twojej akceptacji.

Do zrobienia w emoms

1. Włącz serwer w konfiguracji. W appsettings.json emoms ustaw "Mcp": { "Enabled": true } i zrestartuj emoms. Port domyślny to 4999 (klucz Mcp:Port), nasłuch tylko na komputerze z emoms. Zostaw "BindLan" na false i uruchamiaj agenta na tym samym komputerze: przy true port jest widoczny w sieci lokalnej, token wędruje po niej bez szyfrowania, a o sesję może poprosić każdy w LAN. Zmiana portu lub nasłuchu też wymaga restartu.
2. Ustawienia → Serwer MCP → zakładka „Status”: sprawdź „Włączony: True” i przełącz „Serwer uruchomiony”.
3. Zakładka „Konfiguracja”: ustaw ważność tokenu (1–72 godziny, domyślnie 8) i kliknij „Zapisz”.
4. Zatwierdź sesję. Gdy agent poprosi o dostęp, w zakładce „Sesje” → „Oczekujące sesje” pojawi się wiersz z nazwą klienta, celem i adresem IP (lista nie odświeża się sama, użyj „Odśwież”). Zatwierdzaj tylko sesję, którą sam przed chwilą wywołałeś, i sprawdź adres IP; nieznane odrzucaj (nazwę i cel podaje sam klient). Kliknij „Zatwierdź”. Agent odbiera token jeden raz; po wygaśnięciu prosi o nową sesję.

Jak agent prosi o sesję

• POST http://localhost:4999/mcp/session/request z treścią {"name":"Claude","purpose":"diagnoza zamówień"} zwraca sessionId.
• GET http://localhost:4999/mcp/session/<sessionId>/status po zatwierdzeniu zwraca token (tylko raz) i expiresUtc.
• Każde wywołanie http://localhost:4999/mcp niesie nagłówek Authorization: Bearer <token>.

Podłączenie klienta (przykłady)

• Claude Code: claude mcp add --transport http emoms http://localhost:4999/mcp --header "Authorization: Bearer <token>"
• Claude Desktop (Windows, mostek mcp-remote, nagłówek przez zmienną środowiskową, bo Claude Desktop na Windows psuje argumenty ze spacją): w claude_desktop_config.json: {"mcpServers":{"emoms":{"command":"npx","args":["-y","mcp-remote","http://localhost:4999/mcp","--header","Authorization:${AUTH_HEADER}"],"env":{"AUTH_HEADER":"Bearer <token>"}}}}
• Gemini CLI: w ~/.gemini/settings.json: {"mcpServers":{"emoms":{"httpUrl":"http://localhost:4999/mcp","headers":{"Authorization":"Bearer <token>"}}}}
• Codex CLI: w ~/.codex/config.toml sekcja [mcp_servers.emoms] z url = "http://localhost:4999/mcp" i tokenem przez bearer_token_env_var = "EMOMS_MCP_TOKEN" (składnia wg aktualnej dokumentacji Codex).
• ChatGPT: konektory wymagają publicznego adresu HTTPS z logowaniem OAuth i nie połączą się z lokalnym emoms. Nie wystawiaj emoms ani portu MCP do internetu; użyj Codex CLI na komputerze z emoms.

O co pytać agenta

„Przeczytaj emoms://system-map i wyjaśnij, jak skonfigurować spedytora.” „Dlaczego zamówienie 12345 nie ma faktury?” „Jak włączyć automat odpowiedzi Allegro?” Agent czyta zasoby emoms://shop-messaging, emoms://shipping-setup, emoms://shop-account-setup, emoms://known-pitfalls-* i odpowiada na podstawie prawdziwej konfiguracji Twojej instalacji.