Veröffentliche mit Influence aus deinen Tools

Mit API und MCP von Influence kannst du Entwürfe speichern, Beiträge prüfen und ihre Veröffentlichung nach der Freigabe planen. Deine Tools können dabei auf die verbundenen Konten und gespeicherten Veröffentlichungsergebnisse zugreifen.

Zugangsdaten, Freigabe und Veröffentlichungsstatus

Begrenze den Zugriff über Zugangsdaten

Wähle die Rechte, die der Client braucht. Influence prüft bei jeder Operation die Zugehörigkeit zum Arbeitsbereich und den Zugriff. Jedes Tool legt fest, ob eine Bestätigung nötig ist; der Server setzt diese Vorgabe durch.

Gib die genaue Veröffentlichungsaktion frei

Prüfe Konten, Inhalt, Medien und Zeit vor der Ausführung. Eine wesentliche Änderung braucht eine neue Prüfung und Freigabe; freigegebene Arbeit geht in den Scheduler von Influence.

Veröffentlichungsstatus abrufen

Rufe jeden Beitrag mit den zurückgegebenen IDs ab. Geplant bedeutet, dass er auf den Versand wartet; Veröffentlicht bestätigt den Versand. Prüfung erforderlich bedeutet, dass das Ergebnis ungewiss ist und vor einem weiteren Versand geklärt werden muss.

Lies deine verbundenen Konten über MCP aus

Dieses Node.js-Beispiel verbindet sich mit Influence und listet die Social-Media-Konten in deinem Arbeitsbereich auf. Es liest Kontodaten, ohne einen Entwurf anzulegen oder einen Beitrag zu veröffentlichen.

1. Erstelle einen Schlüssel mit Lesezugriff

Öffne in den Einstellungen Apps und Automatisierungen → Entwicklerwerkzeuge. Wähle Verbundene Kanäle lesen (integrations:read), entferne die Häkchen bei allen anderen Berechtigungen und erstelle dann den API-Schlüssel. Speichere ihn in deinem lokalen Secret-Manager oder als Umgebungsvariable INFLUENCE_API_TOKEN. Der Schlüssel wird nur einmal angezeigt; er gehört weder in den Quellcode noch in einen Chat.

API-Schlüssel verwalten

2. Führe das Beispiel aus

Node.js und npm müssen bereits installiert sein. Installiere das MCP-SDK in deinem Projekt. Speichere den folgenden Code als accounts.mjs und führe node accounts.mjs in einer Umgebung aus, in der INFLUENCE_API_TOKEN gesetzt ist. Das SDK übernimmt die MCP-Verbindung und Initialisierung.

npm install @modelcontextprotocol/client@2.3.1

accounts.mjs

import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";

const token = process.env.INFLUENCE_API_TOKEN;
if (!token) throw new Error("Set INFLUENCE_API_TOKEN first.");

const client = new Client({ name: "influence-quickstart", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
  new URL("https://influence.so/api/mcp"),
  { requestInit: { headers: { Authorization: `Bearer ${token}` } } }
);

try {
  await client.connect(transport);
  const result = await client.callTool({
    name: "accountList",
    arguments: { limit: 20 }
  });
  console.log(JSON.stringify(result.structuredContent, null, 2));
  if (result.isError) process.exitCode = 1;
} finally {
  await client.close();
}

3. Lies die Antwort

Beispielantwort mit erfundenen Kontonamen und IDs. Deine Antwort nennt deinen Arbeitsbereich und die dort verbundenen Social-Media-Konten.

{
  "ok": true,
  "output": {
    "cursor": null,
    "done": true,
    "items": [
      {
        "connectionId": "account_example_01",
        "eligible": true,
        "name": "Example studio",
        "platform": "bluesky",
        "supportsImage": true,
        "supportsText": true,
        "supportsVideo": true
      }
    ],
    "workspaceId": "workspace_example_01",
    "workspaceName": "Example workspace"
  },
  "toolName": "accountList"
}

Was das Ergebnis bedeutet

Zurückgegebene Konten

connectionId identifiziert das jeweilige Konto. eligible und supportsText, supportsImage und supportsVideo zeigen seine aktuellen Veröffentlichungsmöglichkeiten. Prüfe diese Werte erneut, bevor du einen Beitrag vorbereitest.

Keine Konten zurückgegeben

ok: true mit items: [] und done: true bedeutet, dass die Abfrage erfolgreich war. Verbinde ein Social-Media-Konto in dem Arbeitsbereich, den workspaceName nennt, und führe das Beispiel erneut aus.

Weitere Ergebnisseiten

Wenn done false ist, rufe accountList erneut mit dem zurückgegebenen cursor und demselben Wert für limit auf. Fahre fort, bis done true ist; die erste Seite kann weniger als 20 Konten enthalten.

Zugriff abgelehnt

Prüfe bei einer 401-Antwort, ob der Schlüssel noch gültig ist und integrations:read erlaubt. Auch eine fehlende Berechtigung kann bei API-Schlüsseln zu 401 führen. Eine OAuth-Verbindung kann 403 insufficient_scope zurückgeben. Verbinde sie erneut und erlaube das Lesen der Konten.

ChatGPT und Claude können sich statt mit einem Schlüssel über eine Freigabe im Browser verbinden. Folge der Anleitung für deinen Assistenten und bitte ihn dann, deine verbundenen Konten aufzulisten. Dieses Beispiel nutzt den vollständigen MCP-Endpunkt https://influence.so/api/mcp; der Claude-Core-Connector hat eine eigene Einrichtung.

Verfügbare Tools und erforderliche Rechte

GET /api/v1/tools listet die Werkzeuge auf, auf die dein Schlüssel zugreifen kann. Diese Anfrage zeigt die Berechtigungen und Bestätigungsanforderungen für accountList. Zum Anlegen von Entwürfen brauchst du zusätzliche Schreibrechte.

HTTP API

GET /api/v1/tools

Deine Anwendung liest den Katalog und ruft die verfügbaren Tools auf.

MCP

tools/list

Ein unterstützter Assistent findet die Tools und nutzt denselben Prüfungsablauf.

Influence
  1. 1. Einen Entwurf vorbereiten

    Verwende campaignDraftSave mit Konten und Medien aus dem Arbeitsbereich. Bewahre Version und Anfragekennung auf, um das Ergebnis bei einer unterbrochenen Antwort wiederzufinden. Schreibzugriffe auf Entwürfe erfordern eine serverseitige Bestätigung.

  2. 2. Prüfung vorbereiten

    Verwende campaignReview für die gespeicherte Version und die gewünschte Aktion. Zeige Konten, Inhalt, Medien, Einstellungen, Zeitpunkt und Gültigkeitsende, bevor du um Freigabe bittest.

  3. 3. Freigegebene Aktion ausführen

    campaignReviewExecute erfordert die Freigabe genau dieser Prüfung. Für Textbeiträge ist eine neue Antwort auf die vollständige Prüfung nötig, für Medien eine visuelle Freigabe. Der Server übergibt die Aktion an den Scheduler mit dauerhafter Speicherung, statt den Anbieter direkt aufzurufen.

  4. 4. Vor einem erneuten Versuch das Ergebnis lesen

    Lies den Status jedes Kontos und, falls vorhanden, den Veröffentlichungslink. Ein unklarer Versand bleibt im Status „Prüfung erforderlich“, bis das Ergebnis geklärt ist. Rufe das Ergebnis der bestehenden Anfrage ab, bevor du einen weiteren Beitrag erstellst. Sonst könntest du denselben Beitrag doppelt senden.

Wähle die Verbindung für dein Tool

Influence: Wähle die Verbindung für dein Tool
VerbindungEinsatzZugriff
HTTP APIDeine Anwendung liest den Katalog und ruft die verfügbaren Tools auf.Verwende eine Bearer-Zugangskennung mit begrenzten Rechten aus einer Umgebungsvariablen.
MCPEin unterstützter Assistent findet die Tools und nutzt denselben Prüfungsablauf.Folge der Einrichtung deines Assistenten in den Influence-Einstellungen. Die Verfügbarkeit hängt von der Assistentenumgebung und den gewährten Rechten ab.

Kataloganfrage

curl --fail-with-body 'https://influence.so/api/v1/tools' \
  --header "Authorization: Bearer $INFLUENCE_API_TOKEN" \
  | jq '{tools: [.tools[] | select(.name == "accountList") | {name, scopes, confirmation, mutability}]}'

Beispielfelder aus dem Katalog

{
  "tools": [
    {
      "confirmation": "none",
      "mutability": "read",
      "name": "accountList",
      "scopes": [
        "integrations:read"
      ]
    }
  ]
}

Die Beispielfelder stammen aus den Tooldefinitionen. Der aktuelle Katalog, die Berechtigungen des verwendeten Zugangs und die verbundenen Konten bestimmen, welche Aktionen verfügbar sind.

Blaue Kabel verbinden eine Schale mit Fotokarten, Blöcke, einen Stempel, einen Kalender und einen versiegelten Umschlag.

Veröffentlichungsabläufe für deine Tools

Beiträge aus Artikeln und Projektneuigkeiten vorbereiten

Bereite mit deinen Tools Entwürfe aus einem Artikel, Änderungsprotokoll oder Community-Hinweis vor. Zeige genaue Konten, Inhalte und Zeit zur Prüfung, bevor du Influence mit der Planung beauftragst.

Eine Anfrage nach verlorener Antwort wiederfinden

Behalte die ursprüngliche Anfrage und den Idempotenzschlüssel und prüfe das gespeicherte Ergebnis. Ein unklarer Versand bleibt Prüfung erforderlich, bis ein Abgleich das Ergebnis belegt; erstelle keine Ersatzveröffentlichung.

Beiträge mit Influence IQ entwerfen

Gib Influence IQ einen Artikel, Projektnotizen oder Community-Neuigkeiten und deine gespeicherten Markenrichtlinien für bearbeitbare Entwürfe. Verfügbare autorisierte KI-Tools nutzen IQ-Credits und behalten ihre Bestätigungsanforderungen.

Gib Influence IQ deine Notizen und gespeicherten Markenrichtlinien. IQ schlägt bearbeitbare Beiträge und Termine vor. Entwürfe und Bilderzeugung nutzen IQ-Credits. Prüfe die Kosten vor einer Bilderzeugung und die fertigen Inhalte vor der Veröffentlichung.

Influence IQ entdecken

Starte mit einem KI-Assistenten

Mit einer unterstützten Influence-Verbindung kannst du in ChatGPT oder Claude Kampagnen planen und Entwürfe überarbeiten. Bitte deinen Assistenten, Bilder und Videos hochzuladen, auf die er zugreifen kann, oder fertige Medien aus Influence zu verwenden. Hat er keinen Zugriff auf die Datei, lade sie zuerst in Influence hoch. Prüfe die genauen Konten, Texte, Medien, Einstellungen und den Zeitpunkt. Gib anschließend die vollständige Vorschau über eine unterstützte Karte im Chat oder mit einer neuen ausdrücklichen Zustimmung frei. Gib für TikTok Direct deine Einstellungen und Einwilligung im Chat an und bestätige anschließend die aktualisierte Vorschau. Eine Vorschaukarte ist optional. Einrichtung und Verbindungsstatus findest du in den Einstellungen.

Auf deinen verbundenen Konten veröffentlichen

Wähle Konten aus, die in deinem Arbeitsbereich verfügbar sind. Passe den Text und die unterstützten Medien für jedes Ziel an und prüfe die Beiträge vor der Veröffentlichung.

Bereite deine nächsten Beiträge vor

Füge deine Konten hinzu, bereite die Beiträge vor und wähle die Termine. Prüfe den Inhalt, bevor du die Veröffentlichung planst.

Loslegen

Häufige Fragen

Was können API und MCP?
Die verfügbaren Tools können Konten abrufen, Entwürfe und unterstützte Medien verwalten, Beiträge zur Prüfung anzeigen, Termine ändern und den Status abfragen. Welche Tools du nutzen kannst, hängt von den aktivierten Funktionen und deinen Berechtigungen ab.
Umgehen API- oder MCP-Aufrufe die Freigabe?
Nein. Der Server setzt die Bestätigungsanforderungen jedes Tools durch. Zum Veröffentlichen muss die aktuelle Prüfung freigegeben sein. Vor der Planung prüft Influence Arbeitsbereich, Berechtigungen, Konten und Inhalt.
Welche Medien akzeptiert der Assistentenablauf?
Bitte deinen Assistenten, Bilder und Videos hochzuladen, auf die er zugreifen kann, oder fertige Medien aus Influence zu verwenden. Hat er keinen Zugriff auf die Datei, lade sie zuerst in Influence hoch. Prüfe die genauen Konten, Texte, Medien, Einstellungen und den Zeitpunkt. Gib anschließend die vollständige Vorschau über eine unterstützte Karte im Chat oder mit einer neuen ausdrücklichen Zustimmung frei. Gib für TikTok Direct deine Einstellungen und Einwilligung im Chat an und bestätige anschließend die aktualisierte Vorschau. Eine Vorschaukarte ist optional.
Wie gehst du mit einer fehlenden Antwort oder einem unklaren Sendeergebnis um?
Rufe das ursprüngliche Ergebnis ab und prüfe den Status. Wiederhole kein ungewisses Senden. „Prüfung erforderlich“ bleibt bestehen, bis ein Abgleich das Ergebnis belegt.
Garantiert MCP, dass jeder Assistent funktioniert?
Nein. Melde dich an und öffne Einstellungen → Apps und Automatisierungen → Deinen Assistenten verbinden. Dort findest du die Einrichtung und den aktuellen Verbindungsstatus.
Kann eine Integration geplante oder veröffentlichte Beiträge bearbeiten?
Ein geplanter Beitrag kann zur Bearbeitung und erneuten Prüfung als Entwurf geöffnet werden, solange der Versand nicht begonnen hat und kein ungeklärter Sendevorgang vorliegt. Bereits in einem Netzwerk veröffentlichte Inhalte kann der Assistent weder bearbeiten noch löschen.