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 kannEin 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.
Endpunkt
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
claude mcp add -s user --transport http socialfaktory https://www.socialfaktory.com/mcp \--header "Authorization: Bearer sfp_…"
Codex
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.
{"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.
POST https://www.socialfaktory.com/mcpAuthorization: Bearer sfp_…Content-Type: application/jsonAccept: application/json, text/event-streamMCP-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_brandsreadKostenloslist_channelsreadKostenlosget_channel_requirementsreadKostenloslist_formatsreadKostenlosget_walletreadKostenlos
Etwas Neues machen
quote_generationreadKostenloscreate_generationgenerateKostet Creditsgenerate_textgenerateKostet Creditscheck_referencereadKostenlos
Ergebnisse lesen
get_generationreadKostenloslist_generationsreadKostenlosget_text_generationreadKostenloslist_mediareadKostenlos
Eigene Datei mitbringen
create_uploadgenerateKostenloscomplete_uploadgenerateKostenlosget_uploadreadKostenlos
Veröffentlichen
create_postspublishKostenlossend_postpublishKostenlosdelete_postpublishKostenloslist_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_keyGrenzen
- 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.