@silkcrm/mcp

Serwer MCP dający asystentom AI (Claude Desktop, ChatGPT i innym klientom MCP) programatyczny, bezpieczny dostęp do narzędzi AI Twojego salonu w SilkCRM — bez udostępniania hasła ani pełnego API.

Jak to działa

Serwer jest cienkim klientem HTTP. Nie łączy się z bazą danych ani nie ma dostępu do sekretów produkcyjnych — przy każdym uruchomieniu:

1. tools/list → pobiera listę narzędzi z GET /api/v1/ai/tools (przefiltrowaną po roli Twojego klucza),
2. tools/call → wykonuje narzędzie przez POST /api/v1/ai/tools/:name/execute.

Cała autoryzacja (klucz API), izolacja tenantów (RLS), kontrola ról (RBAC per narzędzie) i anonimizacja danych osobowych klientek (tokeny cli_… zamiast imion/telefonów) pozostają po stronie serwera SilkCRM.

Wymagania

• Node.js ≥ 18
• Plan Pro lub wyższy (narzędzia AI)
• Klucz API silk_… z Ustawienia → Klucze API w SilkCRM

Konfiguracja — Claude Desktop

Dodaj do claude_desktop_config.json:

{
  "mcpServers": {
    "silkcrm": {
      "command": "npx",
      "args": ["-y", "@silkcrm/mcp"],
      "env": {
        "SILK_API_KEY": "silk_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Zmienne środowiskowe:

| Zmienna | Wymagana | Domyślnie | Opis | |---|---|---|---| | SILK_API_KEY | ✅ | — | Klucz API silk_… z Ustawień | | SILK_API_URL | ❌ | https://app.silkcrm.net | Bazowy URL API (self-hosting / staging) |

Po zapisaniu konfiguracji zrestartuj Claude Desktop — narzędzia SilkCRM pojawią się w rozmowie.

Bezpieczeństwo

• Klucz API ma wąski zasięg: może wołać wyłącznie endpointy /api/v1/ai/tools (path-guard po stronie API). Nie da się nim zmieniać danych poza narzędziami AI.
• Faza 1 jest read-only (odczyt + generowanie treści). Narzędzia mutujące (rezerwacje, kampanie) pojawią się w kolejnej fazie z osobnymi zakresami i potwierdzeniami.
• Klucz odwołasz w każdej chwili w Ustawienia → Klucze API.

Pomoc techniczna

Wtyczka nie działa, narzędzia nie pojawiają się w Claude albo coś zwraca błąd?

📧 [email protected]

Pisząc, dołącz w miarę możliwości:

• wersję wtyczki (npx @silkcrm/mcp --version) i klienta (np. Claude Desktop),
• treść komunikatu błędu,
• prefiks klucza API (np. silk_live_abcd…) — nigdy całego klucza.

Licencja

MIT — patrz plik LICENSE.