Jak Ponk CRM mluví s AI přes MCP
MCP — Model Context Protocol — je standard od Anthropic, který umožňuje LLM klientům (Claude Desktop, Cursor, vlastní agent) volat tools a pracovat s daty ve vašich systémech.
Co to znamená pro vás
Místo aby vám vývojář nasadil „chat s firemními daty“ jako vlastní projekt, stačí připojit Ponk MCP server. Claude Desktop se zeptá:
„Kolik mám tento týden zakázek a kolik jich čeká na vyzvednutí?“
A dostane odpověď s vašimi daty, podle oprávnění vašeho uživatelského účtu.
Transport: stdio
Ponk MCP server je stdio, ne HTTP. Klient (např. Claude Desktop) ho spustí jako lokální proces a komunikuje s ním přes stdin/stdout. HTTP/SSE varianta je na roadmapě.
Kategorie nástrojů
Všechny tools mají prefix crm_:
- Read tools (~70): seznam a detail zakázek, sklad, faktury, zákazníci, kalendář, statistiky
- Draft tools: změna stavu zakázky, návrh SMS — návrhy se ukládají, vy je schvalujete v CRM UI
- Write tools: drobné operace jako přidání poznámky k zakázce
Vše chráněno API tokenem typu mdk_*, který je per-uživatel a dědí jeho roli.
Per-user role
Role v CRM: ADMIN, TECHNICIAN, ASSISTANT, ACCOUNTANT, VIEWER. Každá má jiný přístup — např. VIEWER nemůže volat write/draft tools, ASSISTANT nevidí pokročilé MCP nástroje pro správu uživatelů. Audit log se píše pro každé MCP volání, retence 90 dní.
Příklad konverzace
Vy: Jaké jsou nejprodávanější náhradní díly za poslední měsíc?
Claude (přes MCP): Top 5: iPhone 13 sklo (24×), iPhone 14 sklo (19×), MacBook Air M1 baterie (12×), iPhone 12 sklo (11×), Apple Watch 7 sklo (8×). Sklad u prvních dvou je pod doporučenou hladinou — chcete navrhnout objednávku?
Pro koho je to použitelné
Pro každého, kdo má servisní dílnu a chce, aby AI klient byl skutečný asistent s přístupem k datům — ne jen chatbot s halucinacemi.