Керування контактами й кампаніями через MCP та SDK

  1. Ще немає ключа? Підключіть будь-який MCP-клієнт до https://coldleads.app/api/mcp/demo (у Claude Code: `claude mcp add --transport http coldleads-demo https://coldleads.app/api/mcp/demo`). Він має ті самі інструменти над зразковими даними, ніколи не надсилає листів і не витрачає кредити. Ліміти: сесія триває 24 години від початку; до 10 контактів (разом із 4 зразковими), 1 власний шаблон і 1 чернетка кампанії; нотатки обрізаються до 100 символів, текст шаблону до 500, повідомлення до 200. Еталонний агент на GitHub проходить на ньому весь цикл.
  2. Підключіть MCP-клієнт до https://coldleads.app/api/mcp через OAuth ChatGPT або секретний API-ключ із Налаштування → API keys (план Business). Node SDK використовує ті самі інструменти через `new ColdLeads({ apiKey }).crm`.
  3. list_contacts та import_contacts працюють із контактами вашого робочого простору. Для CSV/XLSX попросіть асистента перетворити файл на структуровані рядки (до 100 за виклик). Імпорт усуває дублікати, пропускає глобальний список do-not-contact і не надсилає листи. Для веб-заявок використовуйте `inquiry`; `b2b_outreach` — лише за наявності законної підстави.
  4. update_contact редагує поля або позначає відмову; MCP не скасовує opt-out. get_conversation читає листи, синхронізовані з підключеної пошти. send_contact_message надсилає один лист лише після схвалення одержувача й остаточного тексту користувачем (`confirm_send: true`).
  5. list_templates і save_template готують вміст; list_campaigns і create_campaign_draft створюють чернетку з оцінкою аудиторії. Перед запуском користувач перевіряє шаблон і аудиторію та явно підтверджує `launch_campaign` (`confirm_launch: true`). Діють перевірки політики, ліміти, DNC і відписки.
  6. get_workspace_info повертає лише нетайний стан облікового запису й пошти. setup_website_lead_capture створює публічний ключ `lk_…` і форму для /api/hooks/lead. Ключ призначений лише для форми; заявки позначаються inquiry й автоматично не стають контактами для холодної розсилки.
  7. Приклади SDK: `coldleads.crm.importContacts({ contacts: [{ email: 'person@example.com', consent: 'inquiry' }] })`; `coldleads.crm.setupWebsiteLeadCapture({ site: 'https://example.com' })`.