Správa kontaktů a kampaní přes MCP a SDK

  1. Ještě nemáte klíč? Připojte libovolného MCP klienta k https://coldleads.app/api/mcp/demo (v Claude Code: `claude mcp add --transport http coldleads-demo https://coldleads.app/api/mcp/demo`). Má stejné nástroje nad ukázkovými daty, nikdy neodesílá e-maily a nespotřebuje kredity. Limity: relace trvá 24 hodin od začátku; nejvýše 10 kontaktů (včetně 4 ukázkových), 1 vlastní šablona a 1 koncept kampaně; poznámky se zkracují na 100 znaků, text šablony na 500 a zprávy na 200. Referenční agent na GitHubu na něm projde celý cyklus.
  2. Připojte MCP klienta k https://coldleads.app/api/mcp přes OAuth ChatGPT nebo tajný API klíč v Nastavení → API klíče (tarif Business). Node SDK používá stejné nástroje přes `new ColdLeads({ apiKey }).crm`.
  3. Nástroje list_contacts a import_contacts spravují záznamy vašeho účtu. U CSV/XLSX nechte asistenta soubor převést na strukturované řádky (nejvýše 100 na volání). Import deduplikuje adresy, přeskočí globální seznam zákazů kontaktu a nic neodesílá. Webové poptávky označte `inquiry`; `b2b_outreach` použijte jen při zákonném důvodu.
  4. update_contact upravuje pole nebo zaznamená odhlášení; MCP odhlášení neumí vrátit. get_conversation čte zprávy synchronizované z připojené schránky. send_contact_message odešle jednu zprávu jen po schválení příjemce a finálního textu uživatelem (`confirm_send: true`).
  5. list_templates a save_template připravují obsah; list_campaigns a create_campaign_draft vytvoří koncept a odhad příjemců. Před spuštěním uživatel zkontroluje šablonu a publikum a výslovně schválí `launch_campaign` s `confirm_launch: true`. Platí pravidla služby, limity, DNC a odhlášení.
  6. get_workspace_info vrací jen ne-tajný stav účtu a schránky. setup_website_lead_capture vytvoří veřejný klíč `lk_…` a formulář pro /api/hooks/lead. Klíč patří jen do formuláře; nové záznamy mají souhlas inquiry a nejsou automaticky vhodné pro cold outreach.
  7. SDK příklady: `coldleads.crm.importContacts({ contacts: [{ email: 'person@example.com', consent: 'inquiry' }] })`; `coldleads.crm.setupWebsiteLeadCapture({ site: 'https://example.com' })`.