Søk lastes bare når du bruker det. Bla gjennom alle kategoriene nedenfor.

Oppsettsveiledning

Oppsettsveiledning for SosoAPI

Koble til AI-agenten din, knytt til en sosial konto og forbered ditt første innlegg.

Les som Markdown

Gjennomgått av SosoAPI-teamet ·

Velg hvor du vil starte

SosoAPI gir agenten du allerede bruker én tilkobling til dine sosiale kontoer. Agenten hjelper med skriving og gjennomgang; SosoAPI håndterer støttede kontooperasjoner, planlegging og publiseringsresultater. Du kan gjennomgå de samme innleggene i appen eller bruke API-et fra egen kode.

Denne veiledningen starter med én person og én sosial konto. Du kobler til en lokal eller driftet MCP-klient, velger tilgang, sjekker en sosial konto, forbereder og godkjenner et innlegg og leser det faktiske resultatet. Den avanserte gjennomgangen dekker CLI og HTTP API. Selve oppsettet krever ikke et testinnlegg.

Før du begynner

Du trenger en MCP-kompatibel AI-klient, en SosoAPI-konto og en sosial konto du har lov til å administrere. Du kan opprette SosoAPI-kontoen når innloggingssiden åpnes. Ha et reelt innhold i tankene.

Lokal MCP trenger Node.js 20 eller nyere med npm/npx og AI-klienten du velger. Driftet MCP trenger en klient med støtte for remote MCP, OAuth og automatisk klientregistrering; lokal Node.js-installasjon er ikke nødvendig. Klientfunksjoner kan avhenge av plan og administratorinnstillinger.

SosoAPI kobler til Instagram, Threads, Facebook Pages, YouTube og X. Velg en konto med type, tillatelser og innleggsformat som passer oppgaven. En kvalifisert Threads-konto er et nyttig første eksempel med bare tekst. Instagram og YouTube trenger egnet medieinnhold for sine støttede publiseringsformater. At en plattform finnes i tilkoblingsmenyen betyr ikke at alle handlinger er tilgjengelige for alle kontoer.

Kontroller kontospesifikke funksjoner under oppsettet. Les gjeldende plan og kvote i appen før du planlegger en bunke; X har en separat kredittkvote per organisasjon. Et eksempel for én plattform dokumenterer ikke støtte på en annen.

1. Gi agenten oppsettsforespørselen

Lim dette inn i den eksisterende Claude Code- eller Codex-samtalen.

Agenten bør først se etter en fungerende SosoAPI-tilkobling og gjenbruke den. Ellers følger den oppsettsoppskriften og sier fra når nettleserinnlogging eller klientomstart er nødvendig. Forventet resultat: SosoAPI-verktøy kan brukes i denne samtalen. En installasjonsmelding alene er ikke bevis. Fortsett med innlogging og kontokontroll, eller bruk trinn 3 for manuell konfigurering.

Sett opp SosoAPI fra https://sosoapi.ai/setup.md. Behold innholdet og oppgaven jeg jobber med. Jeg logger inn og godkjenner tilgang når jeg blir bedt om det. Ikke publiser noe under oppsettet.

2. Logg inn og velg agentens tilgang

Bruk riktig konto: fortsett med Google, eller registrer deg med e-post og fullfør verifisering. Fullfør eventuelt konto- eller arbeidsområdeoppsett som vises. Hvis du tilhører flere arbeidsområder, velger du ønsket merkevare eller prosjekt. Gjennomgå forespurte arbeidsområder og handlinger før godkjenning, og gå tilbake til samme samtale.

Behold innloggingslenken fra agenten, slik at nettleseren kan gå tilbake til den ventende autorisasjonen. Du kan starte i appen først og deretter gå tilbake til agenten. Ikke erstatt en ventende godkjenningslenke med en annen innloggingslenke.

Arbeidsområderoller og plattformtillatelser gjelder fortsatt: en leser blir ikke redaktør fordi agenten har publiseringstilgang. Publiseringstilgang varer innenfor omfanget du gir; SosoAPI krever ikke ny nettlesergodkjenning for hvert innlegg. Fortell agenten når den skal stoppe for innholdsgjennomgang. Vanlig OAuth-oppsett krever ikke at du limer inn sosialt passord eller API-nøkkel i agenten.

Forventet resultat: Innlogging fullføres med riktig identitet, og agenten kan hente arbeidsområdene du autoriserte. Bruk feilsøkingen hvis feil nettleserprofil åpnes.

Velg tilgang for oppgaven
TilgangsvalgHva det brukes til
Les, opprett og redigerLes tilgjengelig kontoinformasjon og forbered arbeid.
Planlegg og publiserSend inn og administrer publiseringsarbeid innenfor valgt omfang.
Ekstra tillatelserAktiver bare ved et konkret behov. Vanlig publisering trenger ikke API-nøkkeladministrasjon.

3. Koble til agenten manuelt ved behov

Velg én tilkoblingsmetode. Hopp over dette avsnittet hvis agenten allerede har satt opp en fungerende tilkobling. For lokal MCP sjekker du Node.js og npx først. Node.js må være versjon 20 eller nyere.

node --version
npx --version

Lokal MCP: Claude Code eller Codex

Kjør bare kommandoen for klienten din: den første er for Claude Code, den andre for Codex. core-profilen dekker vanlig publisering. Profiler endrer hvilke verktøy som vises, ikke tillatelser. Behold en fungerende full-profiltilkobling hvis du allerede har en.

Koble til på nytt eller start på nytt hvis klienten ber om det, og kontroller så at SosoAPI-verktøy er tilgjengelige i den aktuelle samtalen. Første autentiserte kall starter nettleserinnlogging ved behov.

claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

Andre lokale MCP-klienter

For klienter som bruker mcpServers JSON, legger du denne oppføringen til eksisterende konfigurasjon og beholder andre servere. Andre formater skal få samme kommando, argumenter og miljøvariabel via klientens egne MCP-innstillinger.

{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}

Driftet MCP: kompatible nettlesere eller eksterne klienter

I klientens innstillinger for egendefinerte koblinger eller remote MCP legger du til en tilkobling kalt SosoAPI med server-URL-en nedenfor. Velg OAuth med automatisk klientregistrering når det tilbys. Logg inn på SosoAPI, velg tillatte arbeidsområder og handlinger, gå tilbake til samtalen og aktiver tilkoblingen hvis klienten krever det. Be agenten kontrollere autoriserte kontoer.

Bruk https://sosoapi.ai for en ny driftet tilkobling. Det eldre endepunktet https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp støttes fortsatt. Behold en fungerende lokal eller driftet tilkobling; du trenger ikke erstatte den bare for å endre URL-en.

Du trenger ikke lime inn API-nøkkel, klient-ID eller klienthemmelighet. Egne MCP-apper i ChatGPT avhenger av klientens plan, utviklermodus og administratorinnstillinger. Dette beskriver en egendefinert tilkobling, ikke en oppføring i appkatalogen. Driftet MCP kan ikke lese lokale filer; bruk import fra offentlig URL eller lokal MCP for lokale filopplastinger.

https://sosoapi.ai

Valgfri innloggingskontroll i terminalen

For en lokal tilkobling kjører du auth status først. Kjør auth login bare hvis den viser at du ikke er logget inn. Fullfør nettleserflyten og sjekk status igjen. Token skrives ikke ut. Dette sjekker lokal CLI-autentisering, ikke innloggingen til en separat driftet kobling.

npx -y sosoapi auth status
npx -y sosoapi auth login

4. Koble til din sosiale konto

Åpne kontotilkobling, eller bruk den lokale kommandoen nedenfor. Erstatt threads med instagram, facebook, youtube eller x ved behov. Dette åpner tilkoblingsflyten; det publiserer ikke innhold.

Kontroller organisasjonen og arbeidsområdet som vises. Velg plattform, logg inn via dens autorisasjonsside og velg nøyaktig konto, Page eller kanal. Fullfør samtykke og eventuell bekreftelse av kontovalg når du kommer tilbake. Be deretter agenten oppdatere tilkoblede kontoer for ønsket arbeidsområde.

Gjenbruk en eksisterende, frisk tilkobling. Hvis den tilhører en annen organisasjon eller et annet arbeidsområde, avklar valget i appen; vanlig oppsett skal ikke koble den fra eller flytte den. Forventet resultat: riktig konto vises i ønsket arbeidsområde med gjeldende tilkoblingshelse og funksjonsinformasjon. En vellykket tilbakekalling alene beviser ikke publiseringstillatelse.

Kontroller ønsket mål
MålHva du bør sjekke
ThreadsRiktig profil og tillatelse for ønsket tekst- eller medieformat.
InstagramEt støttet profesjonelt kontooppsett og publiseringstillatelse for ønsket format.
FacebookSiden du administrerer og tillatelsene som trengs for den.
YouTubeRiktig kanal, særlig når én Google-konto administrerer flere.
XKontoens tekst- eller videofunksjoner og organisasjonens gjenværende X-kreditter.
npx -y sosoapi connect threads

5. Bekreft tilgang uten å publisere

Lim følgende inn i den tilkoblede agentsamtalen.

Agenten kan bruke sosoapi_get_workspace_context og sosoapi_list_connected_accounts, gjenbruke kjent kontekst og sende valgt workspace_id eksplisitt. Kontoinitialisering kan opprette ditt første arbeidsområde; denne oppsettskontrollen oppretter ikke et sosialt innlegg.

Før du fortsetter, bekrefter du arbeidsområde og mål, din rolle og agentens tilgang samt målets støtte for foreslått format. Bruk feilsøking hvis en kontroll feiler. Å installere pakken på nytt løser ikke manglende plattformtillatelse.

Sjekk SosoAPI-oppsettet mitt uten å publisere eller planlegge noe.
Vis arbeidsområdene jeg kan bruke og de sosiale kontoene i arbeidsområdet jeg velger.
For kontoen jeg velger, vis plattform, kontonavn, tilkoblingshelse og publiseringsfunksjoner for formatet jeg foreslår.
Hvis flere arbeidsområder eller kontoer kan passe, spør meg hvilken du skal bruke.
Behold interne ID-er for verktøykall; ikke be meg finne eller dikte dem opp.

6. Forbered og godkjenn det første innlegget

Start med ett reelt innlegg og ett mål. Erstatt feltene i hakeparenteser i denne utkastprompten. Agenten skriver; SosoAPI gir tilkoblingen og publiseringsoperasjonene. Gjennomgå påstander, stavemåte, lenker og medier selv.

Bruk eksplisitt dato, lokal tid og IANA-tidssone for et fremtidig innlegg. Hvis sommertid gjør den lokale tiden tvetydig, velg hvilken forekomst du mener før innsending. Forventet resultat på dette stadiet: et nøyaktig utkast til gjennomgang, uten innsendt publiseringsforespørsel.

Hjelp meg å forberede én produktkunngjøring med SosoAPI.

Produkt: [public product name]
Bekreftede fakta: [what is available today]
Målgruppe: [who this helps]
Mål: [account label and platform]
Språk: [language]
Ønsket lokal dato og klokkeslett: [YYYY-MM-DD HH:mm]
Tidssone: [IANA timezone, for example Asia/Hong_Kong]
Medier: [none, a local file, or a public media URL]

Bruk bare faktaene jeg oppga. Kontroller målets formatkrav.
Vis nøyaktig utkast, medieinnhold, mål, dato, klokkeslett og tidssone til gjennomgang.
Ikke planlegg eller publiser ennå.

Godkjenn det nøyaktige innlegget før planlegging

Når alle detaljer er riktige, gir du en konkret instruksjon med prompten nedenfor. Dette oppretter en reell planlegging som kan publisere offentlig. Bruk innhold og en konto du faktisk vil publisere på. Umiddelbar publisering krever også en eksplisitt instruksjon etter gjennomgang av de samme detaljene.

Forventet resultat: en Scheduled Post-ID, riktig mål, godtatt tidspunkt og gjeldende status. En godtatt planlegging betyr ikke at leverandøren har publisert innlegget.

Planlegg det nøyaktige godkjente innlegget nedenfor til den navngitte kontoen på oppgitt dato, klokkeslett og tidssone.

[Lim inn endelig innhold, medieinnhold, mål, dato, klokkeslett og tidssone.]

Se først etter en eksisterende, samsvarende planlegging. Send innlegget én gang og les det lagrede resultatet tilbake. Returner ID, mål, godtatt tidspunkt og gjeldende status. Hvis resultatet er usikkert, kontroller den eksisterende forespørselen før du gjør noe annet.

7. Kontroller resultatet, planlegg på nytt eller kanseller

Be agenten lese samme Scheduled Post med sosoapi_get_scheduled_post. Du kan også åpne https://app.sosoapi.ai/scheduled-posts/<post-id> etter innlogging med en autorisert konto. Kontroller hvert mål separat når en forespørsel gjelder flere kontoer; noen kan lykkes mens andre trenger oppfølging.

Les gjeldende resultat for Scheduled Post [returned ID].
Vis mål, planlagt tidspunkt, gjeldende status og publiseringsresultat.
Hvis publisering er bekreftet, ta med den offentlige lenken når den finnes.
Ikke prøv igjen, planlegg på nytt eller opprett et nytt innlegg.
Forstå det lagrede resultatet
ResultatBetydningNeste trinn
PlanlagtGodtatt for et fremtidig tidspunkt.Behold ID-en og sjekk etter forfallstidspunktet.
Klargjøring, publisering eller avstemming pågårArbeid pågår, eller leverandørens endelige resultat er ukjent.Les samme innlegg senere; unngå en ny innsending.
PublisertLeverandørbasert dokumentasjon bekrefter publisering.Åpne den returnerte permanente lenken når den finnes.
Mislykket eller trenger oppfølgingEn konkret reparasjon eller tillatt handling er nødvendig.Les årsaken og tilgjengelige handlinger.
Må planlegges på nytt eller er utløptDen opprinnelige planleggingen kan ikke fortsette som forespurt.Les forklaringen og velg en tilgjengelig handling.
KansellertKansellering er bekreftet.Ikke forvent at denne planleggingen publiseres.

Administrer et ventende innlegg og kom tilbake senere

For å endre et ventende innlegg oppgir du ID og nye detaljer. Agenten må lese gjeldende versjon og tilgjengelige handlinger før støttet oppdatering eller kansellering. Om kansellering er mulig avhenger av leveringsstadiet og kan opphøre når levering starter. Å kansellere en planlegging fjerner ikke et innlegg som allerede er publisert hos leverandøren.

Etter å ha mottatt lagrede detaljer for en fremtidig planlegging kan du forlate samtalen og gå tilbake til samme innlegg senere. En lukket agentsamtale lover ikke å våkne eller varsle deg med mindre dette er konfigurert separat.

8. Legg til bilder eller video, og gjenbruk flyten

Få flyten for ett innlegg til å fungere før du forbereder en større bunke. Fortell agenten om mediene er en lokal fil, en offentlig URL eller en eksisterende SosoAPI-ressurs.

Lokale filer kan lastes opp med sosoapi_upload_asset i lokal MCP. Filen må ligge i en tillatt opplastingsmappe; verktøyet forklarer tillatte plasseringer hvis stien er utenfor området. Driftet MCP kan ikke lese filer på datamaskinen din.

For offentlige URL-er bruker du sosoapi_import_asset_url, og deretter sosoapi_get_asset_import_status med include_asset=true. Vent til ressursen er klar. For en eksisterende ressurs bekrefter du at den tilhører riktig arbeidsområde og er klar for valgt format.

En vanlig planleggingsforespørsel bruker registrert ressurs-ID sammen med ressursens kanoniske URL. En midlertidig forhåndsvisnings-URL eller den opprinnelige eksterne URL-en kan ikke erstatte dette. For den støttede flyten med én bilde-URL kombinerer sosoapi_post_image_url import og innsending. Dette er en publiseringsoperasjon: godkjenn hele innlegget først. Behold ID-en til et godtatt innlegg under behandling; ikke start en ny import for å fortsette.

X støtter et originalt TEXT-innlegg uten medier, eller VIDEO med nøyaktig én klar, registrert MP4-videoressurs, minst 0.5 sekunder lang og innenfor opplastingsgrensen på 500 MiB. Video krever bekreftet can_publish_video for den aktuelle kontoen; teksttilgang alene er ikke nok. En eldre tilkobling kan kreve din godkjenning for å koble til på nytt med videoopplastingstillatelse. Tekst, emneknagger og lenke må passe innenfor Xs vektede tekstgrense. Bilder, svar, sitater, republisering og trådpublisering støttes ikke. Godtatt opplasting eller videobehandling er ikke et publiseringsresultat.

Før innsending til X leser du sosoapi_get_x_usage med ønsket workspace_id og endelig tekst. Kvoten og kostnaden er adskilt fra vanlig plankvote. Ikke omgå en kredittgrense med gjentatte innsendinger; avklar en usikker publisering før ny sending.

Forbered en bunke til gjennomgang og les resultatene ærlig

Etter det første vellykkede innlegget kan du prøve produktlanseringsprompten nedenfor. Når du har godkjent den nøyaktige tabellen, kontrollerer du bunken mot planens grenser. Rapporter godtatte og avviste mål hver for seg, og behold identiteten til hvert godtatte innlegg.

Publiseringstilgang og analysetilgang kan være forskjellige. Hvis du senere ber om en resultatgjennomgang, skal utilgjengelige målinger rapporteres som utilgjengelige. Ikke finn på nullverdier eller anta at alle målinger kan leses fordi et innlegg er publisert.

Bruk det samme bekreftede oppsettet og lag sju produktkunngjøringsutkast, ett per dag, fra de offentlige faktaene jeg gir. Vis en gjennomgangstabell med utkast, mål, medieinnhold, lokal dato, klokkeslett og tidssone for hver rad. Behold alle sju som utkast til jeg godkjenner den nøyaktige tabellen.

9. Gjennomgang av CLI og API

Bruk denne valgfrie veien for eksplisitte forespørselsfiler eller en backend-integrasjon. Agentbrukere kan hoppe over den. Eksemplene bruker samme konto, arbeidsområde og publiseringstillatelser som MCP.

Undersøk først hjelpen og den innebygde kontrakten til den installerte pakken; kontraktinspeksjon krever ikke innlogging. Den viser operasjonene og skjemaene som fulgte med pakken. Bruk disse feltnavnene i stedet for en annen leverandørs forespørselsformat.

npx -y sosoapi --help
npx -y sosoapi api contract --summary
npx -y sosoapi api contract --route /studio-api/scheduled-posts/

CLI: send din første autentiserte kontekstforespørsel

Fullfør auth login. Lagre JSON-en nedenfor som workspaces.json i en teksteditor, og kjør deretter kommandoen. Bruk filer til forespørselskropper i stedet for å sette innhold inn i skallkommandoer.

CLI returnerer schema_version, http_status og body. Et vellykket svar inneholder body.active_workspace_id og body.workspaces. Velg ønsket arbeidsområde fra svaret; det aktive arbeidsområdet bestemmer ikke stilltiende målet for en ny oppgave. Første kall for en ny konto kan initialisere det første arbeidsområdet.

Kontroller http_status og body, ikke bare skallets avslutningskode. En kommando kan returnere en HTTP-feilkonvolutt uten at API-operasjonen lykkes.

{}
npx -y sosoapi api post /identity-api/workspace/list < workspaces.json

CLI: velg den tilkoblede sosiale kontoen

Lagre accounts.json med arbeidsområde-ID-en som ble returnert for kontoen din, og kjør kommandoen. Velg ønsket konto fra body.accounts. Kontoens SosoAPI-ID er social_account_id som brukes ved planlegging; et brukernavn eller en Page-ID fra leverandøren kan ikke erstatte den.

{
  "workspace_id": "<YOUR_WORKSPACE_ID>"
}
npx -y sosoapi api post /identity-api/user/social-accounts/list < accounts.json

CLI: planlegg ett godkjent Threads-tekstinnlegg

Dette er en forespørselsmal, ikke et innlegg klart til kjøring. Lagre post.json med en filredigerer og erstatt alle verdier i hakeparenteser med egne autoriserte verdier. Velg et fremtidig ISO-tidsstempel med eksplisitt UTC-avvik, eller Z for UTC. display_timezone er en IANA-tidssone for visning; den gjør ikke et tvetydig lokalt tidsstempel fullstendig.

Opprett en unik idempotency_key, for eksempel en UUID, og behold den sammen med den nøyaktige forespørselskroppen. Prøv en identisk forespørsel igjen med samme nøkkel; en forsinket respons er ingen grunn til å lage en ny nøkkel. Et endret innlegg er en annen forespørsel: kontroller det opprinnelige resultatet før du velger en ny identitet.

Kjør create-kommandoen etter å ha bekreftet innhold, konto, tidspunkt, tillatelser og gjeldende kvote. Dette planlegger et reelt innlegg. Ved godkjenning beholder du body.post.id og leser body.post.status, body.post.scheduled_at og body.post.destination. body.deduped viser om en eksisterende forespørsel ble gjenbrukt. Godkjenning er ikke leverandørbekreftet publisering.

{
  "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.json

CLI: les det lagrede innlegget og resultatet

Lagre post-status.json med returnert ID. Les body.post, body.delivery, body.actions og body.outcomes. Bekreft et publisert resultat før du rapporterer suksess. Hvis create-responsen gikk tapt, gjenfinner du den opprinnelige forespørselen med lagret identitet; ikke opprett en ny planlegging med ny nøkkel.

{
  "id": "<RETURNED_POST_ID>"
}
npx -y sosoapi api post /studio-api/scheduled-posts/get < post-status.json

CLI: kanseller bare når gjeldende resultat tillater det

Hvis siste lesing tillater kansellering og du vil kansellere, lagrer du cancel.json med returnert ID og gjeldende numeriske body.post.version. Eksemplets 1 er illustrerende: erstatt den med versjonen du nettopp leste. Kjør så kommandoen og bekreft resultatet.

Hvis versjonen er endret eller kansellering er utilgjengelig, leser du samme innlegg igjen og bruker de faktisk tilgjengelige handlingene. Ikke omgå en versjonskonflikt eller forveksle kansellering med sletting av et publisert innlegg.

{
  "id": "<RETURNED_POST_ID>",
  "expected_version": 1
}
npx -y sosoapi api post /studio-api/scheduled-posts/cancel < cancel.json

HTTP: kall fra din egen backend

For en serverintegrasjon oppretter du en API-nøkkel under Connection → API og lagrer hemmeligheten i serverens hemmelighetskonfigurasjon. Skjermen ber nå bare om navn; den har ingen valg for arbeidsområde eller funksjoner. En brukeropprettet nøkkel får som standard operate, publish og engage i alle arbeidsområder brukeren har tilgang til. Kontroller om myndigheten passer integrasjonen. API-kontrakten støtter nøkler med eksplisitt begrensede capabilities og workspace_ids.

Vanlig agentoppsett bruker OAuth og trenger ikke dette API-nøkkeltrinnet. I eksemplet er SOSOAPI_ACCESS_TOKEN en eksempelvariabel på serversiden som inneholder nøkkelen, ikke en SosoAPI CLI-innstilling. CLI-ens valgfrie variabel for personlig tilgangstoken er VICKY_API_KEY.

Bruk workspaces.json-filen ovenfor. Direkte HTTP returnerer endepunktets kropp uten CLI-ens http_status/body-konvolutt; les faktisk HTTP-status og JSON. Hold legitimasjon på backend og utenfor nettleserkode, prompter, skjermbilder og delte forespørselsfiler.

Å bygge sosial tilkobling inn i et produkt for egne kunder er en separat integrasjonsoppgave. Denne gjennomgangen for én konto beviser ikke at kundenes oppstartsflyt er klar.

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. Feilsøking

Bruk den faktiske feilen og tilkoblingen du undersøker. Utvidede tillatelser eller gjentatte innsendinger løser ikke alle feil.

Gjenopprett uten å miste den opprinnelige forespørselen
SymptomHva du bør sjekke eller gjøre
node eller npx er utilgjengeligInstaller en støttet Node.js-kjøretid for lokal MCP, eller bruk kompatibel driftet MCP.
npx sosoapi ser ut til å vente for alltidUten kommando starter stdio MCP-serveren og venter på klienten. Bruk --help for terminalveiledning.
Installert, men ingen verktøy i samtalenKoble den faktiske klienten til på nytt eller start den på nytt, og aktiver SosoAPI i den aktuelle samtalen.
Innlogging åpnes i feil nettleserprofilStopp din ventende lokale innlogging. Bekreft med --help at --no-open finnes, og kjør npx -y sosoapi auth login --no-open. Åpne den nye lenken i riktig profil og kontroller identiteten før samtykke. Ikke bruk samme lenke samtidig i to profiler.
Port 8789 er opptattUndersøk med lsof -nP -iTCP:8789 -sTCP:LISTEN. Stopp bare en lytter hvis den er din egen ventende innloggingsprosess.
E-postverifisering eller innlogging mislykkesLes den faktiske feilen og bruk tilbudt ny prøve. E-postinnlogging bruker bakgrunnsverifisering, så det finnes ingen CAPTCHA-avkrysningsboks å finne. Continue with Google er et annet alternativ.
401-responsKontroller innloggingen og legitimasjonens gyldighet for denne tilkoblingen. Lokal auth status sjekker ikke en driftet kobling.
403 eller manglende publiseringshandlingKontroller valgt arbeidsområde, rolle og tildelt funksjon. Be eieren om nødvendig tilgang når det er aktuelt.
Forventet sosial konto manglerKontroller identitet, arbeidsområde og kontovalget hos leverandøren. Fullfør eventuell ventende tilkoblingsbekreftelse.
Tilkoblet, men publisering er utilgjengeligLes den aktuelle kontoens funksjoner og plattformkrav. Koble til på nytt bare når nytt leverandørsamtykke faktisk kreves; videotilgang kan avvike fra teksttilgang.
Opplastingsstien er utenfor tillatte mapperBruk en tillatt mappe, eller konfigurer SOSOAPI_UPLOAD_ROOTS bevisst i det lokale MCP-miljøet.
Medieimport venter fortsattKontroller eksisterende import og jobb-ID. Rapporter kjørings- eller konfigurasjonsfeilen i stedet for å opprette dupliserte importer.
Kvote eller X-kreditter er brukt oppLes gjeldende kvote og velg en tillatt planleggings- eller planhandling. Gjentatte innsendinger fjerner ikke grensen.
Opprettingsforespørselen får tidsavbruddBehold forespørselsnøkkelen og en eventuell kjent ID for det godtatte innlegget. Les eller gjenfinn den opprinnelige forespørselen før du prøver igjen; en identisk ny innsending beholder nøkkelen.
Oppdatering eller kansellering gir versjonskonfliktLes samme innlegg igjen, sjekk tilgjengelige handlinger og bruk gjeldende versjon bare for den tiltenkte handlingen.
Skjema- eller versjonsfeilOppdater pakken MCP-klienten faktisk kjører, koble til på nytt og undersøk kontrakten. Flere tillatelser løser ikke skjemafeil.

Oppdater, trekk tilbake tilgang eller be om hjelp

Den første kommandoen nedenfor sjekker hjelpen for nyeste pakke uten å starte MCP-serveren. Hvis klienten låser en versjon i den lagrede kommandoen, oppdaterer du den kommandoen bevisst. En separat global installasjonsoppdatering oppdaterer ikke klientens låste kopi.

For å trekke tilbake en lokal enhet bruker du Connection → Agent eller auth logout nedenfor. For en driftet kobling trekker du tilbake den tilhørende autorisasjonen under Connection → Agent. API-nøkler administreres separat under Connection → API. Tilbaketrekking av agenttilgang kansellerer ikke godtatte planlegginger; administrer innleggene separat.

Hvis du trenger hjelp, oppgir du klient- og pakkeversjon, feilet trinn, vist feil og tidspunkt/tidssone. Del relevante forespørsels- eller innleggs-ID-er privat med støtte ved behov. Ikke send legitimasjon, autorisasjonslenker eller rålogger som kan inneholde token.

npx -y sosoapi@latest --help
npx -y sosoapi auth logout

Sjekkliste for fullført oppsett

Du kan fullføre tilkoblingsoppsettet uten å sende inn et innlegg. Hvis du publiserer, bruker du den separate resultatkontrollen for å bekrefte den første publiseringsflyten.

  • Klienten min kan bruke SosoAPI-verktøy, eller CLI/API kan sende en autorisert forespørsel.
  • Jeg har logget inn med riktig konto og valgt riktig arbeidsområde.
  • Min sosiale konto vises med funksjonene oppgaven trenger.
  • Jeg forstår om agenten min bare kan forberede arbeid eller også planlegge og publisere.
  • Jeg kan lage et utkast og gjennomgå nøyaktig mål, innhold og tidspunkt.
  • Hvis jeg har sendt inn et innlegg, har jeg beholdt ID-en og kan skille mellom godkjenning og bekreftet publisering.
  • Jeg vet hvordan jeg undersøker feil, administrerer en ventende planlegging og trekker tilbake tilgang.