# SosoAPI für die Person einrichten, die diesen Assistenten nutzt Nutze den bestehenden Assistenten der Person und behalte ursprüngliche Aufgabe, Inhalte und Medienverweise in diesem Gespräch. Nutze ein SosoAPI MCP für ihre verbundenen Social-Media-Konten. Verwende eine bestehende Verbindung oder wähle lokalen oder gehosteten Zugriff unten. Die Einrichtung veröffentlicht keinen Beitrag. Die Person meldet sich an und wählt, was sie im Browser autorisieren. Gib niemals ihre Zugangsdaten ein und genehmige keine Zustimmung für sie. Für Free ist keine Karte nötig. ## 1. Diesen Assistenten verbinden Prüfe zuerst den aktuellen Host und seine bestehende SosoAPI-Konfiguration. Nutze eine funktionierende Verbindung; melde dich nicht ab, überschreibe keine Konfiguration und erstelle keine weitere Verbindung, nur weil diese Anleitung erneut geöffnet wurde. Prüfe für eine lokale Shell, ob Node.js 20 oder neuer und npx verfügbar sind. Nutze eine bestehende unterstützte Laufzeitumgebung. Fehlt sie, erkläre die Voraussetzung in einfacher Sprache; führe keine privilegierten oder globalen Systemänderungen automatisch durch. Claude Code: ```sh claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Codex: ```sh codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Prüfe nach der Serverregistrierung, ob du seine Tools in diesem aufrufen kannst Gespräch. Falls der Host erneutes Verbinden oder Neustarten erfordert, sage der Person, welcher nötige Aktion. Warte auf funktionierende Tools, bevor du die Verbindung als bereit meldest. Neue Verbindungen nutzen das bestehende core-Profil mit 28 Tools für normale Veröffentlichung, Medien, Kommentare und Insights. Eine funktionierende full-Profil-Verbindung sollte weiterverwendet werden. Fehlt eine angeforderte Verwaltungsoperation, erkläre, dass das full-Profil ist verfügbar; ein ausgeblendetes Tool erteilt oder widerruft keine Berechtigung. Für einen reinen Browser-Client wie ChatGPT mit Unterstützung eigener MCP-Apps füge dieses Remote-MCP-URL hinzu und wähle OAuth mit automatischer Clientregistrierung: `https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp` Kein API-Schlüssel, keine Client-ID und kein Client-Geheimnis müssen eingefügt werden. Die Person meldet sich an bei SosoAPI an und wählt Workspaces/Aktionen. Eigene ChatGPT-Apps hängen ab von Tarif und Entwicklermodus-Verfügbarkeit. Nutze eine funktionierende lokale oder Remote- Verbindung, falls bereits eine konfiguriert ist. X unterstützt eigene Texte und Links. Jede Organisation teilt 10 Free-X-Credits einmal oder 100 pro Pro-Abrechnungszeitraum. Reiner Text kostet 1; ein Beitrag mit URL kostet 10. Lies `sosoapi_get_x_usage` mit workspace_id, bevor du X-Nutzung planst. Es entstehen keine automatischen Mehrverbrauchsgebühren; eine ungewisse Veröffentlichung bindet ihre Credit- Reservierung und muss vor einem weiteren Versand abgeglichen werden. ## 2. Ohne API-Schlüssel anmelden Der erste authentifizierte MCP-Aufruf öffnet die bestehende Browseranmeldung und Agenten- Zustimmungsablauf. Die Person kann Google nutzen oder sich registrieren und ihre E-Mail verifizieren. Lass sie ihren Workspace auswählen und entscheiden, ob der Assistent nur Inhalte vorbereiten oder auch planen und veröffentlichen darf. Bitte sie nicht, Zugangsdaten zu kopieren. Veröffentlichungszustimmung gilt im ausgewählten Umfang fortlaufend, keine erzwungene Freigabeansicht je Beitrag. Halte Schlüsselverwaltung für gewöhnliche Veröffentlichung deaktiviert. E-Mail-Registrierung und Anmeldung nutzen Sicherheitsprüfung im Hintergrund, ohne Kontrollkasten, den die Person selbst lösen muss. Scheitert die Prüfung, melde den tatsächlichen Fehler und nutze die verfügbare Wiederholungsaktion; bitte die Person nicht, etwas zu finden oder anzuklicken ein CAPTCHA-Kästchen. Die bestehende Option **Mit Google fortfahren** ist ebenfalls verfügbar, wenn die Person Google verwenden möchte; Google kann eine eigene Identitätsprüfung verlangen. Lass die Person ihr Konto wählen und Zugriff genehmigen. Behalte den aktuellen Anmelde-/Freigabelink und sein Rückkehrziel; ersetze nicht ihn durch eine reine Registrierungs-URL oder wechsle nicht stillschweigend zu einer bestehenden Maintainer-Identität. Ein Anmeldefehler beweist nicht, dass jede Anmeldemethode ausfällt. Pausiere nur den Schritt, der Identität oder Zustimmung der Person benötigt. Während sie dies abschließen, beende Installationsprüfungen und bereite den ursprünglichen Entwurf vor, ohne ein Konto oder einen Workspace zu erfinden. Erkläre, was bereits bereit ist, und den einen nächsten nötigen Schritt. Lies nach der Anmeldung den authentifizierten Kontext erneut und setze die dieselbe Aufgabe. Deaktiviere kein CAPTCHA, nutze keine Administrator-Registrierungs-APIs, frage nicht nach Token, oder behaupte keine Konten-/Verbindungsbereitschaft vor tatsächlichem Ablaufabschluss. Falls MCP-Tools einen Host-Neustart benötigen, steht diesem auch die lokale CLI zur Verfügung Assistenten. Führe `npx -y sosoapi auth status` zuerst; nutze `npx -y sosoapi auth login` nur wenn eine Anmeldung nötig ist. Lies niemals den Zugangsdaten-Datei und gib keine Token aus. Öffnet die Anmeldung das falsche Browserprofil, stoppe diese ausstehende Anmeldung, bevor du eine neue `npx -y sosoapi auth login --no-open`. Die Person öffnet den neu ausgegebenen Link im vorgesehenen Profil und prüft die angemeldete Identität vor der Zustimmung. Verwende niemals zwei Profile gleichzeitig für denselben Link. Nutze `--help` zuerst, um das Vorhandensein dieser Wiederherstellungsoption in der installierten CLI zu prüfen; falls nicht vorhanden, erkläre die Versionsgrenze, statt eine funktionierende Option zu erfinden. Die CLI kann ihre eingebetteten Verträge prüfen: ```sh npx -y sosoapi api contract --summary npx -y sosoapi api contract --route /studio-api/scheduled-posts/ ``` Die CLI-Anfragesyntax lautet `sosoapi api post < request.json`. Schreibe JSON mit deinem Dateitool; interpoliere keine Nutzerinhalte in Shell- Befehle. Lies http_status und Antwortinhalt, nicht nur den Prozess-Exit- Code. Ein API-Fehler ist kein Erfolg. Nutze nur Routen und Schemas aus dem eingebetteten Vertrag; erfinde keine Namen und umgehe keine fehlende Funktion. ## 3. Eigenes Social-Media-Konto der Person verbinden Ermittle authentifizierte Organisation und Workspace aus dem SosoAPI-Kontext. Rate niemals Kennungen und ersetze nie stillschweigend einen Workspace. Wenn gibt es mehrere geeignete Marken, frage nach der gewünschten. Nutze eine bestehende gesunde Verbindung. Führe andernfalls aus `npx -y sosoapi connect ` (instagram, threads, facebook, youtube oder x) oder gib der Person https://app.sosoapi.ai/connect. Sie erteilen die Anbieter- Zustimmung und prüfe das genaue Konto im Browser. Nach ihrer Rückkehr lies Konten und Veröffentlichungsfunktionen erneut. Ein Verbindungs-Callback ist kein Nachweis einer Veröffentlichungsberechtigung. Nutze den ursprünglichen Entwurf; bitte die Person, eine interne Kennung zu kopieren oder ihre Inhalte neu zu erstellen. ## 4. Ursprüngliche Veröffentlichungsaufgabe abschließen Nutze die bestehende Anfrage der Person oder frage, was sie bewerben möchte. Nicht erfinde keinen Testbeitrag. Zeige genaues Zielkonto, Inhalt, Medien und lokales Datum/Uhrzeit vor der ersten Einreichung. Bestätige die Zeitzone, wenn sie unbekannt. Lies aktuelle Kontofunktionsfakten; ein persönliches Instagram-Konto oder fehlende Anbieterberechtigungen erfordern möglicherweise einen unterstützten Kontotyp oder erneutes Verbinden. X akzeptiert nur eigene Texte und Links; lasse media leer. X-Medien, Antworten, Zitate, Reposts und Thread-Veröffentlichung werden nicht unterstützt. Registriere Medien vor dem Planen für unterstützte Ziele: Nutze für lokale Dateien sosoapi_upload_asset innerhalb erlaubter Ordner; nutze für eine externe URL sosoapi_import_asset_url und frage sosoapi_get_asset_import_status mit include_asset=true ab, bis der begrenzte Import bereit ist. Die bereite asset.id wird zu media.asset_id und asset.asset_url wird zu media.url; ein separater get_asset-Aufruf ist nicht nötig. Behalte dieselbe Importidentität, beachte Wiederholungshinweise und stoppe bei endgültigem Fehler. Eine erfolgreiche Anfrage beweist keinen abgeschlossenen Dekodierungs-/Importvorgang. Lies bei Stillstand sosoapi_job_status mit der job_id dieses Imports, bevor du erneut wartest. Ein ausstehender Job kann bereits einen Ausführungsfehler enthalten. Ein Dienst- Konfigurationsfehler erfordert Betreiberhilfe, keinen weiteren Import, kein neues Social-Media- Verbindung oder Berechtigung der Person. Melde das Hindernis, ohne zu behaupten, das Bild bereit ist. Nutze registrierte Asset-ID und kanonische Medien-URL gemeinsam. Niemals die ursprüngliche externe URL oder eine temporäre Vorschau-URL als Ersatz planen. Verwende ein bestehendes bereites Asset erst nach Prüfung von Workspace und Identität erneut. Nutze sosoapi_get_scheduled_post_eligibility für hilfreiche unverbindliche Vorschauen; es ist optional und ersetzt keine kanonische create-/Ausführungsvalidierung. Kanonischen Scheduled Post nutzen Tools. Ein Beitrag entspricht einem Ziel. Verwende für Wiederholungen denselben idempotency_key genau derselben Anfrage; ein geänderter Entwurf ist eine neue Anfrage. Nach einem Timeout, lies den bestehenden Beitrag vor einer weiteren Aktion. Sende niemals blind erneut eine ungewissen Anbieter-Schreibvorgang. Updates, Abbruch und explizite Wiederholung nutzen die aktuelle Version und Aktionseignung des Servers. Das Ergebnis muss unterscheiden: - Geplant: für den angegebenen Zeitpunkt angenommen; noch nicht veröffentlicht. - In Bearbeitung oder Abgleich: Das endgültige Ergebnis ist unbestätigt; nicht erneut senden. - Veröffentlicht: Ein anbieterbelegtes endgültiges Ergebnis bestätigt genau diesen Beitrag; gib den Live-Link zurück, falls verfügbar. - Fehlgeschlagen oder Handlungsbedarf: Nenne bekannte Fakten und die nächste erlaubte Aktion; verbinde nur das betroffene Konto erneut, wenn die Person wieder Zugriff gewähren muss. Melde mehrere Ziele separat. Bezeichne nicht die gesamte Aufgabe als erfolgreich, wenn nur einige Plattformen erfolgreich waren. Bei zukünftigem Zeitplan gib Beitrags-IDs und angenommene Zeitpunkte; halte das Gespräch nicht wartend bis zum Fälligkeitszeitpunkt oder erstelle keine Polling-Schleife. Lies bei Rückkehr dieselben Beiträge erneut. Die Person kann dasselbe Ergebnis auch erneut aufrufen unter https://app.sosoapi.ai/scheduled-posts/, mit der tatsächlich zurückgegebenen ID von SosoAPI. Die Seite verlangt ihre eigene autorisierte Anmeldung. Für eine eigene Umgebung, nutze stattdessen den ausdrücklich konfigurierten App-Ursprung. Versprich nicht, einen geschlossenen Assistenten zu wecken oder eine Erfolgsmeldung zu senden, die wurde nicht konfiguriert und verifiziert. ## Referenzen - Schnellstart für Menschen: https://app.sosoapi.ai/start - Produktanleitung: https://sosoapi.ai/de/docs/quickstart - Unterstützter Umfang: Instagram, Threads, Facebook-Seiten, YouTube und eigene X- Text/Links. Formate und Berechtigungen variieren je Konto; andere Plattformen sind nicht verfügbar, nur weil die Person danach fragt.