For the best experience, please enable JavaScript in your browser.

Zum Hauptinhalt springen

Einen Agenten verbinden

Richte einen Agent-Client auf dein SocialFaktory-Konto und lass ihn eine Marke von Anfang bis Ende führen, ohne die App zu öffnen.

Was es ist

Ein einziger Endpunkt, mit dem dein Agent-Client spricht. Er kann deine Marken und Kanäle lesen, Video und Text erzeugen, Dateien hochladen, Beiträge planen und senden und danach ihre Ergebnisse lesen.

Er kann keinen sozialen Kanal verbinden und deinen Tarif nicht ändern. Was er ausgeben darf, begrenzen seine Bereiche, das monatliche Credit-Limit seines Tokens und Idempotenzschlüssel, die eine Wiederholung nicht zweimal zahlen lassen. Einen Kanal zu verbinden ist eine Browser-Anmeldung und bleibt deshalb in der App.

Sehen Sie, was ein Agent für eine Marke führen kann

Ein Token holen

Erstelle in den Einstellungen ein persönliches Zugriffstoken. Das Geheimnis wird einmal gezeigt und gilt nur für diesen Endpunkt.

  • Die Bereiche entscheiden, was das Token darf — Lesen allein, dazu Erzeugen für alles, was Credits kostet, dazu Veröffentlichen für Beiträge.
  • Lege es auf eine Marke fest, und es sieht nur deren Kanäle, Generierungen, Beiträge und Texte. Credit-Guthaben, Uploads, Akteure und Produkte bleiben im ganzen Konto geteilt.
  • Setze ein monatliches Credit-Limit, und das Token startet keinen kostenpflichtigen Aufruf mehr, sobald die Ausgaben des Monats es erreichen. Ein bereits laufender Textauftrag wird zu seinen echten Kosten abgerechnet und kann etwas darüber liegen.
Einstellungen → API-Token öffnen

Endpunkt

http
POST https://www.socialfaktory.com/mcp

Streamable HTTP, Protokollversion 2025-06-18, Bearer-Authentifizierung im Authorization-Header. Es gibt keine Session-ID mitzuführen: das Token ist die Sitzung. Ein GET antwortet mit 405.

Claude Code

bash
claude mcp add -s user --transport http socialfaktory https://www.socialfaktory.com/mcp \
--header "Authorization: Bearer sfp_…"

Codex

bash
export SOCIALFAKTORY_TOKEN=sfp_…
codex mcp add socialfaktory --url https://www.socialfaktory.com/mcp --bearer-token-env-var SOCIALFAKTORY_TOKEN

Claude Desktop

Claude Desktop startet lokale Server aus seiner Konfigurationsdatei, deshalb startet dieser Eintrag mcp-remote über npx als Brücke zum Endpunkt, und Node.js muss installiert sein. claude.ai und Cowork erreichen ihn nur, wenn ein Administrator der Organisation ihn als Connector mit dem Token als Request-Header hinzufügt, eine Beta-Funktion bei Anthropic, die das Token mit der ganzen Organisation teilt.

claude_desktop_config.json
{
"mcpServers": {
"socialfaktory": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://www.socialfaktory.com/mcp", "--header", "Authorization:${SOCIALFAKTORY_AUTH}"],
"env": { "SOCIALFAKTORY_AUTH": "Bearer sfp_…" }
}
}
}

Jeder Streamable-HTTP-Client

Sende JSON-RPC 2.0 per POST. Akzeptiere sowohl JSON als auch den Event-Stream-Typ und nenne die Protokollversion bei jeder Anfrage.

http
POST https://www.socialfaktory.com/mcp
Authorization: Bearer sfp_…
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-06-18
{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Werkzeuge

Jedes Werkzeug nennt den Bereich, den es braucht. Ein Token ohne diesen Bereich wird abgelehnt, bevor das Werkzeug läuft. quote_generation ist eine freiwillige Preisprüfung für ein Video, und generate_text reserviert vorab ein paar Credits und rechnet danach ab, was der Text tatsächlich verbraucht hat.

Lesen, was du hast

  • list_brandsreadKostenlos
  • list_channelsreadKostenlos
  • get_channel_requirementsreadKostenlos
  • list_formatsreadKostenlos
  • get_walletreadKostenlos

Etwas Neues machen

  • quote_generationreadKostenlos
  • create_generationgenerateKostet Credits
  • generate_textgenerateKostet Credits
  • check_referencereadKostenlos

Ergebnisse lesen

  • get_generationreadKostenlos
  • list_generationsreadKostenlos
  • get_text_generationreadKostenlos
  • list_mediareadKostenlos

Eigene Datei mitbringen

  • create_uploadgenerateKostenlos
  • complete_uploadgenerateKostenlos
  • get_uploadreadKostenlos

Veröffentlichen

  • create_postspublishKostenlos
  • send_postpublishKostenlos
  • delete_postpublishKostenlos
  • list_postsreadKostenlos

Sicher wiederholen

Gib dieses Argument bei jedem Aufruf mit, der ausgibt oder veröffentlicht. Eine Wiederholung innerhalb von 24 Stunden liefert das ursprüngliche Ergebnis, als wiederholt markiert, statt die Arbeit zweimal zu tun.

idempotency_key

Grenzen

  • 120 Aufrufe pro Minute und Token sowie 300 Anfragen alle 5 Minuten pro Adresse.
  • Ein Video über einen Link zu klonen und Standbilder oder Karussells zu erzeugen, geht über einen Agenten noch nicht.