Kontakte und Kampagnen mit MCP und SDK verwalten

  1. Noch kein Schlüssel? Verbinden Sie einen MCP-Client mit https://coldleads.app/api/mcp/demo (in Claude Code: `claude mcp add --transport http coldleads-demo https://coldleads.app/api/mcp/demo`). Er hat dieselben Tools über einen Beispiel-Arbeitsbereich, sendet nie E-Mails und verbraucht keine Credits. Limits: Eine Sitzung dauert 24 Stunden ab Start; höchstens 10 Kontakte (inklusive 4 Beispiele), 1 eigene Vorlage und 1 Kampagnenentwurf; Notizen werden auf 100 Zeichen gekürzt, Vorlagentexte auf 500, Nachrichten auf 200. Der Referenz-Agent auf GitHub durchläuft damit den ganzen Kreislauf.
  2. Verbinden Sie einen MCP-Client mit https://coldleads.app/api/mcp über ChatGPT OAuth oder einen geheimen API-Schlüssel unter Einstellungen → API keys (Business-Tarif). Das Node SDK verwendet dieselben Tools über `new ColdLeads({ apiKey }).crm`.
  3. list_contacts und import_contacts verwalten Datensätze Ihres Arbeitsbereichs. Lassen Sie CSV/XLSX vom Assistenten in strukturierte Zeilen umwandeln (bis zu 100 pro Aufruf). Importe entfernen Duplikate, überspringen globale Sperrlisten und versenden keine E-Mails. Für Website-Anfragen `inquiry` verwenden; `b2b_outreach` nur bei rechtmäßiger Grundlage.
  4. update_contact bearbeitet Felder oder markiert einen Opt-out; MCP kann ihn nicht rückgängig machen. get_conversation liest bereits synchronisierte Nachrichten. send_contact_message versendet genau eine E-Mail, nachdem der Nutzer Empfänger und endgültigen Text bestätigt hat (`confirm_send: true`).
  5. list_templates und save_template erstellen Inhalte; list_campaigns und create_campaign_draft erstellen Entwürfe mit Empfängerschätzung. Vor dem Start prüft der Nutzer Vorlage und Zielgruppe und bestätigt `launch_campaign` ausdrücklich (`confirm_launch: true`). Richtlinien, Kontolimits, DNC und Abmeldeschutz gelten.
  6. get_workspace_info liefert nur nicht geheime Kontodaten und den Mailbox-Status. setup_website_lead_capture erstellt einen öffentlichen `lk_…`-Schlüssel und ein Formular für /api/hooks/lead. Der Schlüssel gehört nur ins Website-Formular; Einsendungen sind inquiry und nicht automatisch für Kaltakquise freigegeben.
  7. SDK-Beispiele: `coldleads.crm.importContacts({ contacts: [{ email: 'person@example.com', consent: 'inquiry' }] })`; `coldleads.crm.setupWebsiteLeadCapture({ site: 'https://example.com' })`.