SMOC ist jetzt eine API: MCP, REST und optionales Schreiben

Eine unternehmensweit gültige Invoke-Schicht bedient jetzt zwei Oberflächen: KI-Clients nutzen MCP, Pipelines nutzen REST v2, und der Legacy-Kontakt-Endpunkt bleibt bestehen. Standardschlüssel sind schreibgeschützt. Aktivieren Sie Begrenztes Schreiben erlauben, wenn Sie einen Schlüssel erstellen, und dieselben Tools können Kontakte, Listen und Tags aktualisieren — und eine Textantwort im Posteingang senden.

Was ausgeliefert wurde

SMOC hatte bereits einen Streamable HTTP MCP-Server auf demselben Worker wie die öffentliche API. Jedes Domain-Tool ist auf zwei Arten aufrufbar:

• MCP unter https://api.smoc.ai/mcp für Claude, Cursor, VS Code und andere MCP-Clients
• REST v2 unter POST /api/v2/{toolName} mit demselben JSON-Body

Richtlinien, Mandantenfähigkeit, Ratenbegrenzung, Bestätigung und Idempotenz werden einmalig ausgeführt. Ein Schreibvorgang, der bei MCP blockiert wird, ist auch bei REST blockiert.

GET /api/company/mongocontact bleibt unverändert. Zapier-Schlüssel bleiben schreibgeschützt und behalten denselben Pfad, token-Header und Antwortformat.

Was Sie lesen können

Kundenschlüssel gelten für das gesamte Unternehmen, nicht nur für Kontakte:

• Kontakte, Statistiken, Tags und Interessentenlisten
• Unternehmensprofil, Assets und CPCS-Crawl-Status
• Studio-Katalog — Versionen, Themes, Targeting-Portfolios, Generierungs- und Übersetzungsaufträge
• Ablauf-Analysen
• LinkedIn-Posteingang-Threads und Nachrichtenablauf-Konversationen

Ein Kundentoken kann kein anderes Unternehmen auswählen. Super-User-Schlüssel übergeben weiterhin companyId, wenn nötig.

Was schreibberechtigte Schlüssel tun können

Erstellen Sie den Schlüssel unter Einstellungen → Integrationen → MCP oder API und aktivieren Sie Begrenztes Schreiben erlauben. Bestehende schreibgeschützte Schlüssel erhalten keine Schreibrechte, bis Sie einen neuen mit dieser Option erstellst.

Kontakte und Listen

• Einen Kontakt erstellen oder aktualisieren
• Einen Tag erstellen oder umbenennen, zuweisen oder entfernen
• Eine Interessentenliste erstellen oder umbenennen, einen Kontakt hinzufügen oder entfernen

Unternehmen und Crawl

• Unternehmensprofil-Felder aktualisieren
• Basisdaten von Unternehmens-Assets aktualisieren
• Eine CPCS-URL zum Crawlen hinzufügen

Studio-Metadaten

• Einen Ablauf umbenennen
• Den Status einer Empfehlung aktualisieren (anwenden / ablehnen — nicht veröffentlichen)

Posteingang

• Einen Thread archivieren, als ungelesen markieren oder als beantwortet markieren
• Eine Nur-Text-Antwort mit inbox_threads_send senden

Für das Senden werden threadId, body und idempotencyKey benötigt. Der Schlüssel muss diesen Thread zuerst laden können; ein fehlender oder anderer Unternehmens-Thread ergibt „nicht gefunden“. Wiederholungen mit demselben Schlüssel führen nicht zu doppeltem Versand. Ratenlimit: 10 Sendungen pro Minute. Keine Anhänge.

Was bei Kundenschlüsseln weiterhin deaktiviert bleibt

Schreibberechtigt bedeutet nicht volle Admin-Rechte.

Kundenschlüssel können weiterhin nicht:

• Kontakte, Tags, Listen, Unternehmen oder Assets löschen
• Einen Ablauf veröffentlichen oder live schalten (flowcharts_set_active)
• Einen Ablauf erstellen oder duplizieren
• Targeting ändern
• Kreditverbrauchende Jobs starten (Generierung, Crawl-Planänderungen)
• Eine LinkedIn-Outreach-Kampagne starten

Das bleibt Super-Usern vorbehalten. Das ist die Grenze zwischen „Ihre KI kann im Unternehmen arbeiten“ und „Ihre KI kann das Produkt live schalten“.

Wie Sie auswählen

• Zapier / bestehende Synchronisationen: behalten Sie GET /api/company/mongocontact
• Pipelines und Skripte: POST /api/v2/{toolName} (Bearer oder token)
• KI-Clients: MCP, dann skills_search, falls der Tool-Name nicht offensichtlich ist

OpenAPI finden Sie unter GET /api/v2/openapi.json.

So schalten Sie Schreibrechte frei

1. Console → Einstellungen → Integrationen → MCP (oder API).
2. Einen Schlüssel generieren. Begrenztes Schreiben erlauben aktivieren.
3. Einmalig kopieren. Wie jedes andere Geheimnis sicher aufbewahren.
4. Den Client auf https://api.smoc.ai/mcp mit Authorization: Bearer <key> richten oder POST /api/v2/{toolName} aufrufen.
5. Den Client whoami und dann mcp_capabilities ausführen lassen. Die Capability-Liste zeigt, welche Schreibrechte dieser Schlüssel hat.

Fehlt ein Tool, benennt mcp_capabilities die Berechtigung. Für das Senden im Posteingang wird inbox:write auf einem schreibberechtigten Schlüssel benötigt. Ältere Schlüssel ohne Posteingangs-Berechtigungen müssen rotiert werden.

Warum diese Struktur

Wir haben Lesezugriffe zuerst geöffnet, damit Claude und Cursor das Unternehmen ohne eine zweite API sehen können. Schreibrechte wurden nur dort geöffnet, wo Fehler rückgängig gemacht werden können: ein Tag, eine Listenmitgliedschaft, eine Unternehmens-URL, eine Textantwort mit Idempotenzschlüssel.

Wir haben Veröffentlichen, Live-Schaltung, Löschen oder Kampagnenversand nicht geöffnet. Diese verbrauchen Credits oder ändern, was Interessenten sehen. Sie bleiben einem Menschen in der Console — oder einem Super-User-Token — vorbehalten.

Die gleichen Tools gibt es auf REST v2, sodass Skript und MCP-Client nicht auseinanderlaufen können.

Mehr erfahren

• MCP eGuide
• REST eGuide
• REST v2 Referenz
• Posteingang für LinkedIn-Antworten
• Integrationen
• FAQ-Kategorie apis-mcp

Diesen Monat ausgeliefert — Änderungsprotokoll September 2026.