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.

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é.

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.