Installatiegids
SosoAPI-installatiegids
Verbind je AI-agent, koppel een sociaal account en bereid je eerste bericht voor.
Lezen als MarkdownBeoordeeld door het SosoAPI-team ·
Kies je startpunt
SosoAPI geeft de agent die je al gebruikt één verbinding met je sociale accounts. Je agent helpt inhoud schrijven en beoordelen; SosoAPI verzorgt ondersteunde accounthandelingen, planning en publicatieresultaten. Je kunt dezelfde berichten in de app bekijken of de API vanuit je eigen code gebruiken.
Deze gids begint met één persoon en één sociaal account. Je verbindt een lokale of gehoste MCP-client, kiest toegang, controleert een sociaal account, bereidt een bericht voor en keurt het goed, en leest het werkelijke resultaat. De geavanceerde uitleg behandelt CLI en HTTP-API. Voor het instellen zelf is geen testbericht nodig.
Voordat je begint
Je hebt een MCP-compatibele AI-client, een SosoAPI-account en een sociaal account nodig dat je mag beheren. Je kunt het SosoAPI-account maken wanneer het aanmelden wordt geopend. Bedenk alvast één echt stuk inhoud.
Lokale MCP vereist Node.js 20 of hoger met npm/npx en je gekozen AI-client. Gehoste MCP vereist een client met externe MCP, OAuth en automatische clientregistratie; een lokale Node.js-installatie is niet nodig. Clientfuncties kunnen afhangen van abonnement en beheerinstellingen.
SosoAPI verbindt Instagram, Threads, Facebook Pages, YouTube en X. Kies een account waarvan type, rechten en berichtformaat bij je taak passen. Een geschikt Threads-account is een bruikbaar eerste voorbeeld voor alleen tekst. Instagram en YouTube hebben geschikte media nodig voor hun ondersteunde publicatieformaten. Een platform in het verbindingsmenu betekent niet dat elke actie voor elk account beschikbaar is.
Controleer accountspecifieke mogelijkheden tijdens het instellen. Lees je huidige abonnement en quotum in de app voordat je een batch plant; X heeft een afzonderlijk credittegoed voor de Organization. Een voorbeeld voor één platform bewijst geen ondersteuning op een ander.
1. Je agent de instellingsaanvraag geven
Plak dit in je bestaande gesprek met Claude Code of Codex.
De agent moet eerst een werkende SosoAPI-verbinding zoeken en hergebruiken. Anders volgt deze de installatieprocedure en vertelt wanneer browseraanmelding of een clientherstart nodig is. Verwacht resultaat: SosoAPI-tools zijn bruikbaar in dit gesprek. Alleen een installatiemelding bewijst dit niet. Ga verder met aanmelden en accountcontrole of gebruik stap 3 voor handmatige configuratie.
Configureer SosoAPI via https://sosoapi.ai/setup.md. Behoud mijn huidige inhoud en taak. Ik meld me aan en geef toestemming wanneer daarom wordt gevraagd. Publiceer niets tijdens de configuratie.
2. Aanmelden en de toegang van je agent kiezen
Gebruik het bedoelde account: ga verder met Google of registreer met e-mail en voltooi de verificatie. Rond eventuele getoonde account- of Workspace-instellingen af. Kies het bedoelde merk of project als je bij meerdere Workspaces hoort. Controleer de gevraagde Workspaces en acties vóór goedkeuring en keer terug naar hetzelfde gesprek.
Bewaar de aanmeldlink van je agent zodat de browser naar de openstaande autorisatie kan terugkeren. Je kunt eerst in de app beginnen en daarna teruggaan naar je agent. Vervang een openstaande goedkeuringslink niet door een andere aanmeldlink.
Workspace-rollen en platformrechten blijven gelden: een viewer wordt geen editor doordat een agent publicatietoegang heeft. Publicatietoegang blijft gelden binnen de toegekende reikwijdte; SosoAPI vereist geen nieuwe browsergoedkeuring voor elk bericht. Vertel je agent wanneer deze moet pauzeren voor inhoudscontrole. Normale OAuth-instelling vereist niet dat je een sociaal wachtwoord of API-sleutel in de agent plakt.
Verwacht resultaat: aanmelden wordt voltooid met je bedoelde identiteit en de agent kan de door jou geautoriseerde Workspaces ophalen. Gebruik probleemoplossing als het verkeerde browserprofiel wordt geopend.
| Toegangskeuze | Waarvoor het dient |
|---|---|
| Lezen, maken en bewerken | Beschikbare accountinformatie lezen en werk voorbereiden. |
| Plannen en publiceren | Publicatiewerk binnen de gekozen reikwijdte indienen en beheren. |
| Aanvullende rechten | Schakel alleen in voor een specifieke behoefte. Gewoon publiceren vereist geen beheer van API-sleutels. |
3. Je agent zo nodig handmatig verbinden
Kies één verbindingsmethode. Sla dit onderdeel over als je agent al een werkende verbinding heeft ingesteld. Controleer voor lokale MCP eerst Node.js en npx. Node.js moet versie 20 of hoger zijn.
node --version
npx --versionLokale MCP: Claude Code of Codex
Voer alleen de opdracht voor je client uit: de eerste is voor Claude Code en de tweede voor Codex. Het core-profiel dekt dagelijks publiceren. Profielen veranderen welke tools zichtbaar zijn, maar verlenen geen rechten. Behoud een werkende verbinding met het full-profiel als je die al hebt.
Verbind opnieuw of herstart als de client daarom vraagt en controleer dan of SosoAPI-tools beschikbaar zijn in het huidige gesprek. De eerste geauthenticeerde aanroep start zo nodig het aanmelden via de browser.
claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapicodex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapiAndere lokale MCP-clients
Voeg bij clients met mcpServers-JSON deze vermelding toe aan de bestaande configuratie en behoud andere servers. Geef in andere configuratieformaten dezelfde opdracht, argumenten en omgevingsvariabele op via de eigen MCP-instellingen van de client.
{
"mcpServers": {
"sosoapi": {
"command": "npx",
"args": [
"-y",
"sosoapi"
],
"env": {
"SOSOAPI_TOOL_PROFILE": "core"
}
}
}
}Gehoste MCP: compatibele browser- of externe clients
Voeg in de instellingen voor aangepaste connectors of externe MCP een verbinding met de naam SosoAPI toe met onderstaande server-URL. Kies OAuth met automatische clientregistratie als die optie wordt aangeboden. Meld je aan bij SosoAPI, kies toegestane Workspaces en acties, keer terug naar het gesprek en activeer de verbinding indien nodig. Vraag de agent geautoriseerde accounts te controleren.
Gebruik https://sosoapi.ai voor een nieuwe gehoste verbinding. Het oudere endpoint https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp blijft ondersteund. Behoud een werkende lokale of gehoste verbinding; vervangen is niet nodig alleen om de URL te wijzigen.
Je hoeft geen API-sleutel, client-ID of clientgeheim te plakken. Aangepaste MCP-apps in ChatGPT hangen af van het abonnement, de ontwikkelaarsmodus en de beheerinstellingen van de client. Deze instructies beschrijven een eigen verbinding, geen vermelding in een appcatalogus. Gehoste MCP kan geen lokale bestanden lezen; gebruik import via een openbare URL of lokale MCP voor lokale uploads.
https://sosoapi.aiOptionele aanmeldcontrole in de terminal
Voer bij een lokale verbinding eerst auth status uit. Voer auth login alleen uit als je volgens de status niet bent aangemeld. Voltooi de browserstappen en controleer de status opnieuw. Tokens worden niet getoond. Dit controleert lokale CLI-authenticatie, niet de aanmelding van een afzonderlijke gehoste connector.
npx -y sosoapi auth statusnpx -y sosoapi auth login4. Je sociale account koppelen
Open Accounts koppelen of gebruik de lokale opdracht hieronder. Vervang threads door instagram, facebook, youtube of x waar nodig. Dit opent het verbindingsproces; er wordt geen inhoud gepubliceerd.
Controleer de getoonde Organization en Workspace. Kies het platform, meld je aan via de autorisatiepagina en selecteer het exacte account, de Page of het kanaal. Voltooi bij terugkeer de toestemming en eventuele bevestiging van de accountkeuze. Vraag de agent daarna de gekoppelde accounts voor de bedoelde Workspace te verversen.
Hergebruik een bestaande gezonde verbinding. Hoort deze bij een andere Organization of Workspace, los die keuze dan op in de app; een normale instelling hoort de verbinding niet te verbreken of te verplaatsen. Verwacht resultaat: het juiste account verschijnt in de bedoelde Workspace met actuele status- en functiegegevens. Een geslaagde callback bewijst op zichzelf geen publicatierecht.
| Bestemming | Wat je moet controleren |
|---|---|
| Threads | Het bedoelde profiel en de toestemming voor het gevraagde tekst- of mediaformaat. |
| Een ondersteunde professionele accountconfiguratie en publicatierecht voor het gevraagde formaat. | |
| De Page die je beheert en de rechten die daarvoor nodig zijn. | |
| YouTube | Het bedoelde kanaal, vooral als één Google-account er meerdere beheert. |
| X | De tekst- of videomogelijkheden van het account en de resterende X-credits van de Organization. |
npx -y sosoapi connect threads5. Toegang controleren zonder te publiceren
Plak het volgende in het gesprek met de verbonden agent.
De agent kan sosoapi_get_workspace_context en sosoapi_list_connected_accounts gebruiken, bekende context hergebruiken en de gekozen workspace_id expliciet meegeven. Accountinitialisatie kan je eerste Workspace maken; deze instellingscontrole maakt geen sociaal bericht.
Bevestig voordat je doorgaat de Workspace en bestemming, je rol en agenttoegang en of de bestemming het voorgestelde formaat ondersteunt. Gebruik probleemoplossing als een controle mislukt. Een pakket opnieuw installeren herstelt geen ontbrekende platformrechten.
Controleer mijn SosoAPI-instelling zonder iets te publiceren of te plannen. Toon de Workspaces die ik kan gebruiken en de sociale accounts in de Workspace die ik kies. Toon voor het account dat ik kies het platform, de accountnaam, verbindingsstatus en publicatiemogelijkheden voor mijn voorgestelde formaat. Vraag me welke je moet gebruiken als meerdere Workspaces of accounts kunnen passen. Bewaar interne ID’s voor toolaanroepen; vraag me niet ze te zoeken of te verzinnen.
6. Je eerste bericht voorbereiden en goedkeuren
Begin met één echt bericht en één bestemming. Vervang de velden tussen vierkante haken in deze conceptprompt. De agent schrijft; SosoAPI levert de verbinding en publicatiehandelingen. Controleer zelf beweringen, spelling, links en media.
Gebruik voor een toekomstig bericht een expliciete datum, lokale tijd en IANA-tijdzone. Als zomertijd een lokale tijd dubbelzinnig maakt, kies dan vóór het indienen welk tijdstip je bedoelt. Verwacht resultaat in deze fase: een exact concept ter beoordeling, zonder ingediende publicatieaanvraag.
Help me één productaankondiging voor te bereiden met SosoAPI. Product: [openbare productnaam] Geverifieerde feiten: [wat vandaag beschikbaar is] Doelgroep: [wie dit helpt] Bestemming: [accountnaam en platform] Taal: [taal] Gewenste lokale datum en tijd: [YYYY-MM-DD HH:mm] Tijdzone: [IANA-tijdzone, bijvoorbeeld Asia/Hong_Kong] Media: [geen, een lokaal bestand of een openbare media-URL] Gebruik alleen de feiten die ik heb gegeven. Controleer de formaateisen van de bestemming. Toon het exacte concept, de media, bestemming, datum, tijd en tijdzone ter beoordeling. Plan of publiceer nog niets.
Het exacte bericht goedkeuren vóór het plannen
Geef met de onderstaande prompt een specifieke opdracht als alle details kloppen. Dit maakt een echte planning die openbaar kan publiceren. Gebruik inhoud en een account waarop je wilt publiceren. Direct publiceren vereist ook een expliciete opdracht na controle van dezelfde details.
Verwacht resultaat: een Scheduled Post-ID, bedoelde bestemming, geaccepteerde tijd en huidige status. Een geaccepteerde planning betekent niet dat de aanbieder heeft gepubliceerd.
Plan het exacte hieronder goedgekeurde bericht voor het genoemde account op de opgegeven datum, tijd en tijdzone. [Plak de definitieve inhoud, media, bestemming, datum, tijd en tijdzone.] Controleer eerst of er een overeenkomende planning bestaat. Dien dit bericht eenmaal in en lees het opgeslagen resultaat terug. Geef de ID, bestemming, geaccepteerde tijd en huidige status terug. Controleer bij een onzeker resultaat de bestaande aanvraag voordat je iets anders doet.
7. Het resultaat controleren, opnieuw plannen of annuleren
Vraag de agent dezelfde Scheduled Post te lezen met sosoapi_get_scheduled_post. Je kunt ook https://app.sosoapi.ai/scheduled-posts/<post-id> openen nadat je met een geautoriseerd account bent aangemeld. Controleer elke bestemming afzonderlijk als een aanvraag meerdere accounts betreft; sommige kunnen slagen terwijl andere aandacht nodig hebben.
Lees het huidige resultaat van Scheduled Post [teruggegeven ID]. Toon de bestemming, geplande tijd, huidige status en publicatie-uitkomst. Als publicatie is bevestigd, voeg dan de live link toe als die beschikbaar is. Probeer niet opnieuw, plan niet opnieuw en maak geen ander bericht.
| Resultaat | Betekenis | Volgende stap |
|---|---|---|
| Gepland | Geaccepteerd voor een toekomstig tijdstip. | Bewaar de ID en controleer na het geplande tijdstip. |
| Voorbereiden, publiceren of afstemmen | Het werk is bezig of het definitieve resultaat van de aanbieder is onbekend. | Lees hetzelfde bericht later opnieuw; vermijd een nieuwe indiening. |
| Gepubliceerd | Bewijs van de aanbieder bevestigt publicatie. | Open de teruggegeven permalink als die beschikbaar is. |
| Mislukt of aandacht nodig | Een specifieke reparatie of toegestane actie is nodig. | Lees de reden en beschikbare acties. |
| Opnieuw plannen nodig of verlopen | De oorspronkelijke planning kan niet doorgaan zoals aangevraagd. | Lees de uitleg en kies een beschikbare actie. |
| Geannuleerd | Annulering is bevestigd. | Verwacht niet dat deze planning wordt gepubliceerd. |
Een openstaand bericht beheren en later terugkeren
Geef de ID en nieuwe details op om een openstaand bericht te wijzigen. De agent moet de huidige versie en beschikbare acties lezen voordat een ondersteunde wijziging of annulering wordt gebruikt. Annuleren hangt af van de afleverfase en kan niet meer beschikbaar zijn zodra aflevering begint. Een planning annuleren verwijdert geen al gepubliceerd bericht bij de aanbieder.
Na ontvangst van de opgeslagen gegevens voor een toekomstige planning kun je het gesprek verlaten en later naar hetzelfde bericht terugkeren. Een gesloten agentgesprek belooft niet zichzelf te activeren of je te waarschuwen, tenzij dit afzonderlijk is ingesteld.
8. Afbeeldingen of video toevoegen en de werkwijze hergebruiken
Zorg dat de werkwijze voor één bericht werkt voordat je een grotere batch voorbereidt. Vertel de agent of de media een lokaal bestand, openbare URL of bestaande SosoAPI-asset is.
Lokale bestanden: lokale MCP kan sosoapi_upload_asset gebruiken. Het bestand moet in een toegestane uploadmap staan; de tool licht toegestane locaties toe als het pad erbuiten valt. Gehoste MCP kan geen bestanden op je computer lezen.
Openbare URL’s: gebruik sosoapi_import_asset_url en daarna sosoapi_get_asset_import_status met include_asset=true. Wacht tot de asset gereed is. Controleer bij een bestaande asset of deze bij de bedoelde Workspace hoort en klaar is voor het gekozen formaat.
De normale planningsaanvraag gebruikt de geregistreerde asset-ID en canonieke asset-URL samen. Een tijdelijke voorbeeld-URL of oorspronkelijke externe bron-URL vervangt ze niet. Voor de ondersteunde werkwijze met één afbeeldings-URL combineert sosoapi_post_image_url importeren en indienen. Dit is een publicatiehandeling: keur eerst het volledige bericht goed. Bewaar de ID van het geaccepteerde bericht tijdens de verwerking; start geen nieuwe import om verder te gaan.
X ondersteunt een oorspronkelijke TEXT-Post zonder media, of VIDEO met precies één gereed geregistreerde MP4-videoasset, minimaal 0.5 seconde lang en binnen de uploadlimiet van 500 MiB. Video vereist geverifieerde can_publish_video voor het exacte account; alleen teksttoegang is onvoldoende. Een oudere verbinding kan jouw toestemming nodig hebben om opnieuw te verbinden met rechten voor video-upload. Tekst, hashtags en link moeten binnen de gewogen tekstlimiet van X passen. Foto’s, antwoorden, citaten, reposts en threads worden niet ondersteund. Acceptatie van upload of videoverwerking is geen gepubliceerd resultaat.
Lees vóór indiening bij X sosoapi_get_x_usage voor de bedoelde workspace_id en definitieve tekst. Het tegoed en de kosten staan los van het algemene abonnementsquotum. Omzeil geen creditlimiet door herhaald in te dienen; stem een onzekere publicatie af voordat je opnieuw verstuurt.
Een beoordeelde batch voorbereiden en prestaties eerlijk lezen
Probeer na je eerste geslaagde bericht de onderstaande productlanceringsprompt. Controleer de batch aan de abonnementslimieten nadat je de exacte tabel hebt goedgekeurd. Meld geaccepteerde en afgewezen bestemmingen afzonderlijk en bewaar de identiteit van elk geaccepteerd bericht.
Toegang tot publiceren en analyses kan verschillen. Als je later een prestatieoverzicht vraagt, moeten ontbrekende statistieken als niet beschikbaar worden gemeld. Verzin geen nullen en leid uit een gepubliceerd bericht niet af dat elke statistiek leesbaar is.
Bereid met dezelfde geverifieerde instelling zeven concepten voor een productaankondiging voor, één per dag, op basis van de openbare feiten die ik geef. Toon een beoordelingstabel met concept, bestemming, media, lokale datum, tijd en tijdzone per rij. Houd alle zeven als concept totdat ik de exacte tabel goedkeur.
9. CLI- en API-uitleg
Gebruik deze optionele route voor expliciete aanvraagbestanden of een backendintegratie. Agentgebruikers kunnen deze overslaan. De voorbeelden gebruiken dezelfde account-, Workspace- en publicatierechten als MCP.
Bekijk eerst de hulp en het ingebouwde contract van het geïnstalleerde pakket; contractinspectie vereist geen aanmelding. Het toont de meegeleverde handelingen en schema’s. Gebruik die veldnamen in plaats van het aanvraagformaat van een andere aanbieder.
npx -y sosoapi --help
npx -y sosoapi api contract --summary
npx -y sosoapi api contract --route /studio-api/scheduled-posts/CLI: je eerste geauthenticeerde contextaanvraag
Voltooi auth login. Sla met een teksteditor workspaces.json met onderstaande JSON op en voer de opdracht uit. Gebruik bestanden voor aanvraaginhoud in plaats van inhoud in shellopdrachten in te voegen.
De CLI geeft schema_version, http_status en body terug. Een geslaagd antwoord bevat body.active_workspace_id en body.workspaces. Kies de bedoelde Workspace uit dat antwoord; de actieve Workspace bepaalt niet stilzwijgend de bestemming van een nieuwe taak. De eerste aanroep van een nieuw account kan de eerste Workspace initialiseren.
Controleer http_status en body, niet alleen de shell-exitcode. Een opdracht kan een HTTP-foutenvelop teruggeven zonder dat de API-handeling is geslaagd.
{}npx -y sosoapi api post /identity-api/workspace/list < workspaces.jsonCLI: het gekoppelde sociale account kiezen
Sla accounts.json op met de voor je account teruggegeven Workspace-ID en voer de opdracht uit. Kies het bedoelde account uit body.accounts. De SosoAPI-account-ID is de social_account_id voor het plannen; een gebruikersnaam of Page-ID van de aanbieder vervangt die niet.
{
"workspace_id": "<YOUR_WORKSPACE_ID>"
}npx -y sosoapi api post /identity-api/user/social-accounts/list < accounts.jsonCLI: één goedgekeurd Threads-tekstbericht plannen
Dit is een aanvraagtemplate, geen direct uitvoerbaar bericht. Sla post.json op met een editor en vervang elke waarde tussen vierkante haken door je eigen geautoriseerde waarden. Kies een toekomstige ISO-tijdstempel met expliciete UTC-offset, of Z voor UTC. display_timezone is een IANA-tijdzone voor weergave; deze maakt een dubbelzinnige lokale tijdstempel niet volledig.
Maak een unieke idempotency_key, zoals een UUID, en bewaar die met de exacte aanvraaginhoud. Herhaal een identieke aanvraag met dezelfde sleutel; een vertraagd antwoord is geen reden om een nieuwe sleutel te maken. Een gewijzigd bericht is een andere aanvraag: controleer het oorspronkelijke resultaat voordat je een nieuwe identiteit kiest.
Voer na bevestiging van inhoud, account, tijd, rechten en huidig quotum de opdracht create uit. Hiermee plan je een echt bericht. Bewaar bij acceptatie body.post.id en lees body.post.status, body.post.scheduled_at en body.post.destination. body.deduped geeft aan of een bestaande aanvraag is hergebruikt. Acceptatie is geen door de aanbieder bevestigde publicatie.
{
"workspace_id": "<YOUR_WORKSPACE_ID>",
"social_account_id": "<YOUR_THREADS_ACCOUNT_ID>",
"caption": "<YOUR_APPROVED_POST_TEXT>",
"hashtags": [],
"media": [],
"provider_payload": {
"platform": "threads",
"publish_options": {
"post_type": "TEXT"
}
},
"scheduled_at": "<FUTURE_ISO_8601_TIME_WITH_OFFSET>",
"display_timezone": "Asia/Hong_Kong",
"idempotency_key": "<NEW_STABLE_REQUEST_KEY>"
}npx -y sosoapi api post /studio-api/scheduled-posts/create < post.jsonCLI: het opgeslagen bericht en resultaat lezen
Sla post-status.json op met de teruggegeven ID. Lees body.post, body.delivery, body.actions en body.outcomes. Bevestig een gepubliceerd resultaat voordat je succes meldt. Als het create-antwoord verloren is gegaan, herstel dan de oorspronkelijke aanvraag met de opgeslagen identiteit; maak geen andere planning met een nieuwe sleutel.
{
"id": "<RETURNED_POST_ID>"
}npx -y sosoapi api post /studio-api/scheduled-posts/get < post-status.jsonCLI: alleen annuleren als het huidige resultaat dit toestaat
Als de laatste uitlezing annuleren toestaat en je wilt annuleren, sla cancel.json op met de teruggegeven ID en de huidige numerieke body.post.version. De voorbeeldwaarde 1 is illustratief: vervang die door de net gelezen versie. Voer daarna de opdracht uit en bevestig het resultaat.
Als de versie is gewijzigd of annuleren niet beschikbaar is, lees hetzelfde bericht dan opnieuw en gebruik de werkelijk beschikbare acties. Omzeil geen versieconflict en verwar annuleren niet met het verwijderen van een al gepubliceerd bericht.
{
"id": "<RETURNED_POST_ID>",
"expected_version": 1
}npx -y sosoapi api post /studio-api/scheduled-posts/cancel < cancel.jsonHTTP: aanroepen vanuit je eigen backend
Maak voor een serverintegratie een API-sleutel onder Connection → API en sla het geheim op in de geheimenconfiguratie van je server. Het huidige scherm vraagt om een naam; er zijn geen keuzes voor Workspace of mogelijkheden. Een door de gebruiker gemaakte sleutel heeft standaard operate, publish en engage voor de Workspaces waartoe die gebruiker toegang heeft. Controleer of die bevoegdheid bij je integratie past. Het API-contract ondersteunt expliciet beperkte capabilities en workspace_ids voor een afgebakende sleutel.
Normale agentinstelling gebruikt OAuth en vereist deze API-sleutelstap niet. In het voorbeeld is SOSOAPI_ACCESS_TOKEN je voorbeeldvariabele op de server met de sleutel; het is geen instelling van de SosoAPI-CLI. De optionele CLI-variabele voor een persoonlijk toegangstoken is VICKY_API_KEY.
Gebruik het bovenstaande bestand workspaces.json. Rechtstreeks HTTP geeft de endpointinhoud zonder de CLI-envelop http_status/body; lees de werkelijke HTTP-status en JSON. Bewaar inloggegevens op de backend en niet in browsercode, prompts, schermafbeeldingen of gedeelde aanvraagbestanden.
Sociale koppelingen inbouwen in een product voor je eigen klanten is een afzonderlijke integratietaak. Deze uitleg voor één account bewijst niet dat die klantonboarding gereed is.
curl --fail-with-body --silent --show-error \
-H "Authorization: Bearer ${SOSOAPI_ACCESS_TOKEN}" \
-H 'Content-Type: application/json' \
--data-binary @workspaces.json \
'https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/workspace/list'10. Problemen oplossen
Gebruik de werkelijke fout en de verbinding die je onderzoekt. Meer rechten of een herhaalde indiening verhelpen niet elke fout.
| Symptoom | Wat je moet controleren of doen |
|---|---|
| node of npx is niet beschikbaar | Installeer een ondersteunde Node.js-runtime voor lokale MCP of gebruik compatibele gehoste MCP. |
| npx sosoapi lijkt eindeloos te wachten | Zonder opdracht wacht de stdio-MCP-server op zijn client. Gebruik --help voor terminalinstructies. |
| Geïnstalleerd, maar geen tools in het gesprek | Verbind de daadwerkelijke client opnieuw of herstart deze en schakel SosoAPI in het huidige gesprek in. |
| Aanmelden opent het verkeerde browserprofiel | Stop je openstaande lokale aanmelding. Controleer met --help of --no-open bestaat en voer daarna npx -y sosoapi auth login --no-open uit. Open de nieuwe link in het bedoelde profiel en verifieer je identiteit voordat je toestemming geeft. Gebruik niet twee profielen tegelijk voor dezelfde link. |
| Poort 8789 is bezet | Controleer met lsof -nP -iTCP:8789 -sTCP:LISTEN. Stop een luisterend proces alleen als het je eigen openstaande aanmeldproces is. |
| E-mailverificatie of aanmelden mislukt | Lees de werkelijke fout en gebruik de aangeboden herhaling. Aanmelden met e-mail gebruikt achtergrondverificatie zonder CAPTCHA-vakje dat je moet zoeken. Doorgaan met Google is een andere optie. |
| 401-antwoord | Controleer de aanmelding en geldigheid van de inloggegevens van deze verbinding. Lokale auth status controleert geen gehoste connector. |
| 403 of een ontbrekende publicatieactie | Controleer de gekozen Workspace, rol en toegekende mogelijkheid. Vraag de eigenaar waar nodig om toegang. |
| Het verwachte sociale account ontbreekt | Controleer identiteit, Workspace en accountkeuze bij de aanbieder. Voltooi eventuele openstaande verbindingsbevestiging. |
| Verbonden, maar publiceren is niet beschikbaar | Lees de mogelijkheden van het exacte account en de platformvereisten. Maak alleen opnieuw verbinding als nieuwe toestemming bij de aanbieder echt nodig is; videotoegang kan verschillen van teksttoegang. |
| Uploadpad valt buiten toegestane mappen | Gebruik een toegestane map of stel bewust SOSOAPI_UPLOAD_ROOTS in de lokale MCP-omgeving in. |
| Media-import blijft in behandeling | Controleer de bestaande import en taak-ID. Meld de uitvoerings- of configuratiefout in plaats van dubbele imports te maken. |
| Quotum of X-credits zijn verbruikt | Lees het relevante tegoed en kies een toegestane plannings- of abonnementsactie. Herhaald indienen heft de limiet niet op. |
| Time-out bij de aanmaakaanvraag | Bewaar de aanvraagsleutel en, indien bekend, de ID van het geaccepteerde bericht. Lees of herstel de oorspronkelijke aanvraag voordat je het opnieuw probeert; een identieke herhaling houdt dezelfde sleutel. |
| Versieconflict bij wijzigen of annuleren | Lees hetzelfde bericht opnieuw, controleer de beschikbare acties en gebruik de huidige versie alleen voor de bedoelde actie. |
| Schemafout of versieverschil | Werk het pakket bij dat de MCP-client daadwerkelijk uitvoert, verbind opnieuw en bekijk dat contract. Meer rechten herstellen geen schema-afwijking. |
Bijwerken, toegang intrekken of hulp vragen
De eerste opdracht hieronder bekijkt de hulp van het nieuwste pakket zonder de MCP-server te starten. Als de client een versie vastlegt in de opgeslagen opdracht, werk die opdracht dan bewust bij. Een afzonderlijke globale installatie bijwerken werkt de vastgelegde kopie van de client niet bij.
Trek een lokaal apparaat in via Connection → Agent of de onderstaande opdracht auth logout. Trek bij een gehoste connector de bijbehorende gehoste autorisatie in onder Connection → Agent. API-sleutels worden apart beheerd onder Connection → API. Agenttoegang intrekken annuleert geen al geaccepteerde planningen; beheer die berichten afzonderlijk.
Geef voor hulp de client- en pakketversie, mislukte stap, getoonde fout en tijd/tijdzone. Deel relevante aanvraag- of bericht-ID’s waar nodig privé met ondersteuning. Stuur geen inloggegevens, autorisatielinks of ruwe logboeken die tokens kunnen bevatten.
npx -y sosoapi@latest --helpnpx -y sosoapi auth logoutChecklist voor voltooide instelling
Je kunt de verbinding instellen zonder een bericht in te dienen. Als je publiceert, gebruik dan de afzonderlijke resultaatcontrole om die eerste publicatiewerkwijze te bevestigen.
- Mijn client kan SosoAPI-tools gebruiken, of mijn CLI/API kan een geautoriseerde aanvraag doen.
- Ik ben met het bedoelde account aangemeld en heb de juiste Workspace gekozen.
- Mijn sociale account verschijnt met de mogelijkheden die voor de taak nodig zijn.
- Ik begrijp of mijn agent werk kan voorbereiden of ook kan plannen en publiceren.
- Ik kan een concept voorbereiden en de exacte bestemming, inhoud en tijd controleren.
- Als ik een bericht heb ingediend, heb ik de ID bewaard en kan ik acceptatie onderscheiden van bevestigde publicatie.
- Ik weet hoe ik een fout kan onderzoeken, een openstaande planning kan beheren en toegang kan intrekken.