Využití Boldem MCP pro práci s Boldem

Adam Koutný Adam Koutný
25. března 2026

Boldem MCP Server je rozšíření, které propojí váš Boldem účet s AI asistenty jako Claude, Cursor nebo Windsurf. Díky protokolu MCP (Model Context Protocol) můžete spravovat kontakty, kampaně, šablony a další části Boldemu pomocí přirozeného jazyka. Stačí napsat, co potřebujete, a AI to provede za vás.

MCP můžeme nastavit dvěma způsoby, buď pomocí promptu, který předáme AI asistentovi nebo manuálně. Oba postupy jsou popsané níže.

Momentálně je MCP koncipováno tak, aby odpovídalo našemu API, takže můžete provádět všechny operace, které tam jsou dostupné.

Při práci přes AI asistenta (Claude, ChatGPT, Cursor…) jsou vaše dotazy i kontextová data z Boldemu odesílána poskytovateli daného AI nástroje (Anthropic, OpenAI apod.). Ujistěte se, že nesdílíte citlivé osobní údaje, a zkontrolujte podmínky zpracování dat vašeho AI klienta.

1. Prompt pro AI asistenta

Nainstaluj a zprovozni mi Boldem MCP server — npm balíček `boldem-api-mcp`, https://www.npmjs.com/package/boldem-api-mcp — abych mohl přes tebe pracovat se svým Boldem účtem: kontakty, kampaněmi, šablonami, objednávkami, transakčními e-maily a SMS.

Postupuj takto:

1. **Zjisti, kde běžíš.** Máš k dispozici nástroj na spouštění příkazů v terminálu (Bash / PowerShell)?
   - **Ano** (typicky Claude Code): pokračuj bodem 2 a instalaci proveď sám.
   - **Ne** (typicky Claude Desktop, Cursor, Windsurf a další): přeskoč na bod 5 a připrav mi konfiguraci k ručnímu vložení.

2. **Ověř Node.js.** Spusť `node --version`. Vyžaduje se verze 18 nebo vyšší. Pokud Node.js chybí nebo je starší, zastav se a napiš mi, ať ho nejdřív nainstaluji z https://nodejs.org.

3. **Vyžádej si přihlašovací údaje.** Potřebuješ moje OAuth `Client ID` a `Client Secret` z Boldemu. Pokud jsem ti je nedal spolu s tímto zadáním, zeptej se mě na ně a počkej na odpověď — nehádej je a nepoužívej zástupné hodnoty.

4. **Zaregistruj MCP server** příkazem:
   ```
   claude mcp add boldem -e BOLDEM_CLIENT_ID=<moje-client-id> -e BOLDEM_CLIENT_SECRET=<muj-client-secret> -- npx -y boldem-api-mcp
   ```
   Pak pokračuj bodem 6.

5. **Připrav konfiguraci pro ruční vložení.** Vygeneruj mi tento JSON s doplněnými údaji a napiš mi, do kterého souboru ho mám vložit podle mého klienta a operačního systému (u Claude Desktop je to `claude_desktop_config.json`, dostupný přes Settings → Developer → Edit Config). Pokud už soubor nějaké `mcpServers` obsahuje, ukaž mi, jak sekci `boldem` doplnit vedle nich, ne jak celý soubor přepsat:
   ```json
   {
     "mcpServers": {
       "boldem": {
         "command": "npx",
         "args": ["-y", "boldem-api-mcp"],
         "env": {
           "BOLDEM_CLIENT_ID": "<moje-client-id>",
           "BOLDEM_CLIENT_SECRET": "<muj-client-secret>"
         }
       }
     }
   }
   ```
   Nakonec mi připomeň, že po uložení souboru musím klienta úplně ukončit a znovu spustit. Tím jsi hotov — body 6 a 7 provedeme až po restartu.

6. **Restartuj sezení, pokud je potřeba.** Server se v už běžícím sezení nemusí načíst. Pokud ho nevidíš, řekni mi, ať sezení restartuji, a počkej.

7. **Ověř, že to funguje.** Zavolej nástroj `boldem_get_account_info` — je pouze pro čtení, nic nezmění. Pak mi shrň:
   - jestli je server připojený a autentizace prošla,
   - k jakému Boldem účtu jsem připojený,
   - stručně, s čím ti teď můžu pomoct (kontakty, mailing listy, kampaně, šablony, produkty, objednávky, transakční e-maily a SMS, automatizace).

**Bezpečnostní pravidla:**
- Můj Client Secret nikdy nevypisuj zpět do odpovědi ani do žádného souboru, který by mohl skončit v gitu. Konfiguraci s údaji nikdy neukládej do adresáře projektu.
- Během instalace a ověřování nevolej žádný nástroj, který něco vytváří, mění, maže nebo odesílá. Používej výhradně čtecí nástroje.
- Pokud kterýkoli krok selže, zastav se, ukaž mi přesnou chybu a zeptej se, jak dál. Nezkoušej obcházet chybu jinou cestou.

Požadavky

  • Node.js 18 nebo novější link na stažení zde
  • AI klient s podporou MCP. Například Claude Code, Claude Desktop, Cursor nebo Windsurf

Krok 1: Vytvoření API klíče

  1. Přihlaste se do svého Boldem účtu.
  2. Přejděte do Nastavení → API
  3. Vytvořte nový API klíč
  4. Zkopírujte si hodnoty Client ID a Client Secret. Budete je potřebovat při instalaci.

Krok 2: Instalace MCP serveru

Claude Code

Otevřete terminál a zadejte:

npm install -g boldem-api-mcp
claude mcp add boldem -e BOLDEM_CLIENT_ID=váš-client-id -e BOLDEM_CLIENT_SECRET=váš-client-secret -- boldem-api-mcp

Poté restartujte Claude Code session a ověřte připojení příkazem /mcp. Měli by jste vidět toto:

Claude Desktop

Otevřete soubor claude_desktop_config.json a přidejte:

{
  "mcpServers": {
    "boldem": {
      "command": "npx",
      "args": ["-y", "boldem-api-mcp"],
      "env": {
        "BOLDEM_CLIENT_ID": "váš-client-id",
        "BOLDEM_CLIENT_SECRET": "váš-client-secret"
      }
    }
  }
}

Cursor / Windsurf / další MCP klienti

Použijte stejnou JSON konfiguraci jako pro Claude Desktop v nastavení MCP vašeho klienta.

FAQ

Musím znát názvy API nástrojů?
Ne. Stačí popsat, co chcete, běžným jazykem. AI asistent automaticky zvolí správný nástroj a parametry.

Je to bezpečné?
MCP server běží lokálně na vašem počítači. API klíče se nikam neodesílají — zůstávají ve vaší konfiguraci. Komunikace s Boldem API probíhá šifrovaně přes HTTPS.

Může AI omylem odeslat kampaň?
AI asistenti jako Claude se před destruktivními akcemi (odeslání kampaně, smazání kontaktu) zeptají na potvrzení. Přesto doporučujeme nejprve využít funkci testovacího e-mailu.

Kolik to stojí?
Boldem MCP Server je zdarma a open-source (licence MIT). K jeho použití potřebujete aktivní Boldem účet a AI klienta s podporou MCP.

Jak server aktualizuji?
Pokud jste instalovali globálně: npm update -g boldem-api-mcp. Pokud používáte npx, aktualizace se stahuje automaticky.

Něco nefunguje — co mám dělat?

  1. Ověřte, že máte Node.js 18 nebo novější (node –version).
  2. Zkontrolujte správnost Client ID a Client Secret.
  3. V Claude Code zadejte /mcp a ověřte, že server svítí jako připojený.
  4. Pokud problém přetrvává, kontaktujte nás na support@boldem.cz.