# Sett opp SosoAPI for personen som bruker denne assistenten

Bruk personens eksisterende assistent og behold opprinnelig oppgave, innhold og
mediereferanser i denne samtalen. Bruk én SosoAPI MCP for deres tilkoblede
kontoer i sosiale medier. Gjenbruk en eksisterende tilkobling, eller velg lokal eller vertet tilgang
nedenfor. Oppsettet publiserer ikke et innlegg. Personen logger inn og velger hva som skal
autorisere i nettleseren sin. Skriv aldri inn påloggingsopplysningene deres eller godkjenn samtykke
for dem. Free krever ikke kort.

## 1. Koble til denne assistenten

Kontroller først gjeldende vert og dens eksisterende SosoAPI-konfigurasjon. Gjenbruk en
fungerende tilkobling; ikke logg ut, overskriv konfigurasjon eller opprett en ny
tilkobling bare fordi veiledningen ble åpnet igjen.

For et lokalt shell, kontroller at Node.js 20 eller nyere og npx er tilgjengelige. Bruk en
eksisterende støttet kjøremiljø. Hvis det mangler, forklar forutsetningen på vanlig
språk; ikke gjør privilegerte eller globale systemendringer automatisk.

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
```

Etter serverregistrering, kontroller at du kan kalle verktøyene i denne
samtale. Hvis verten trenger ny tilkobling eller omstart, fortell personen hvilken
handling å utføre. Vent til verktøyene fungerer før du sier at tilkoblingen er klar.

Nye tilkoblinger bruker den eksisterende core-profilen med 28 verktøy for vanlig publisering,
medier, kommentarer og innsikt. En fungerende full-profiltilkobling bør gjenbrukes.
Hvis en ønsket administrasjonsoperasjon mangler, forklar at full-profilen
er tilgjengelig; skjuling av et verktøy gir eller tilbakekaller ingen tillatelse.

For en klient som bare bruker nettleseren, som ChatGPT med støtte for egendefinerte MCP-apper, legg til denne
ekstern MCP-URL og velg OAuth med automatisk klientregistrering:

`https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp`

Ingen API-nøkkel, klient-ID eller klienthemmelighet må limes inn. Personen logger inn
i SosoAPI og velger arbeidsområder/handlinger. Egendefinerte ChatGPT-apper avhenger av
abonnementet og tilgjengeligheten av utviklermodus. Gjenbruk en fungerende lokal eller ekstern
tilkobling hvis en allerede er konfigurert.

X støtter originaltekst og lenker. Hver organisasjon deler 10 Free X-kreditter
én gang, eller 100 per Pro-faktureringsperiode. Ren tekst koster 1; et innlegg med en URL
koster 10. Les `sosoapi_get_x_usage` med workspace_id før planlegging av X-bruk.
Ingen automatisk overforbruksavgift belastes; en usikker publisering holder på kreditten
reservasjon og må avstemmes før en ny sending.

## 2. Logg inn uten API-nøkkel

Det første autentiserte MCP-kallet åpner eksisterende nettleserinnlogging og agent-
samtykkeflyt. Personen kan bruke Google eller registrere og verifisere e-posten sin.
La dem velge arbeidsområde og om assistenten bare kan forberede
innhold eller også kan planlegge og publisere. Ikke be dem kopiere påloggingsopplysninger.
Publiseringssamtykke er vedvarende innenfor valgt omfang, ikke en obligatorisk
godkjenningsskjerm for hvert innlegg. Hold nøkkeladministrasjon av for vanlig publisering.

E-postregistrering og innlogging bruker sikkerhetsverifisering i bakgrunnen, uten
avmerkingsboksen personen må løse. Hvis verifiseringen mislykkes, oppgi den faktiske
feil og bruk tilgjengelig handling for nytt forsøk; ikke be personen finne eller klikke
en CAPTCHA-boks. Det eksisterende alternativet **Fortsett med Google** er også tilgjengelig
hvis personen vil bruke Google; Google kan kreve sin egen identitetskontroll.
La personen velge konto og godkjenne tilgang.
Behold gjeldende innloggings-/godkjenningslenke og returstedet; ikke erstatt
den med en ren registrerings-URL eller bytt i stillhet til en eksisterende vedlikeholderidentitet.
Én innloggingsfeil er ikke bevis på at alle innloggingsmetoder er utilgjengelige.

Sett bare trinnet som trenger personens identitet eller samtykke, på pause. Mens de
fullfører det, fullfør installasjonskontroller og forbered det opprinnelige utkastet uten
å finne på en konto eller et arbeidsområde. Forklar hva som allerede er klart, og den ene
neste nødvendige handling. Etter innlogging, les autentisert kontekst på nytt og fortsett
samme oppgave. Ikke deaktiver CAPTCHA, bruk administrator-API-er for registrering, be om tokener,
eller hevde at konto/tilkobling er klar før den faktiske flyten er fullført.

Hvis MCP-verktøyene trenger at verten lastes på nytt, er lokal CLI også tilgjengelig for denne
assistent. Kjør `npx -y sosoapi auth status` først; bruk
`npx -y sosoapi auth login` bare når innlogging er nødvendig. Les aldri
legitimasjonsfil eller skriv ut tokener. Hvis innlogging åpner feil nettleserprofil, stopp
den ventende innloggingen før du starter en ny `npx -y sosoapi auth login --no-open`.
Personen åpner den nye utskrevne lenken i ønsket profil og kontrollerer
den innloggede identiteten før du godkjenner. Bruk aldri to profiler samtidig på samme lenke.
Bruk `--help` først for å bekrefte at dette gjenopprettingsflagget finnes i installert CLI;
hvis det mangler, forklar versjonsbegrensningen fremfor å finne på et fungerende flagg.
CLI-et kan undersøke sine innebygde kontrakter:

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

Syntaksen for CLI-forespørsler er `sosoapi api post </allowlisted-route> < request.json`.
Skriv JSON-en med filverktøyet ditt; ikke sett brukerinnhold inn i shell-
kommandoer. Les http_status og svarinnholdet, ikke bare prosessens avslutnings-
kode. En API-feil er ikke suksess. Bruk bare ruter og skjemaer fra den
innebygd kontrakt; ikke finn på navn eller omgå en manglende funksjon.

## 3. Koble til personens egen sosiale konto

Finn autentisert organisasjon og arbeidsområde fra SosoAPI-kontekst.
Gjett aldri ID-er eller bytt arbeidsområde i stillhet. Hvis
det finnes mer enn én passende merkevare, spør hvilken personen mener.

Bruk en eksisterende tilkobling når den fungerer. Ellers kjør
`npx -y sosoapi connect <platform>` (instagram, threads, facebook, youtube eller x)
eller gi personen https://app.sosoapi.ai/connect. De fullfører leverandør-
samtykke og gjennomgå den nøyaktige kontoen i nettleseren. Etter at de kommer tilbake,
les kontoene og publiseringsfunksjonene på nytt. En tilkoblingscallback er ikke
bevis på at publisering er tillatt. Gjenbruk det opprinnelige utkastet; ikke be
personen om å kopiere en intern ID eller lage innholdet sitt på nytt.

## 4. Fullfør den opprinnelige innleggsoppgaven

Bruk personens eksisterende forespørsel eller spør hva de vil promotere. Ikke
finne på et testinnlegg. Vis nøyaktig målkonto, innhold, medier og
lokal dato/tid før første innsending. Bekreft tidssonen når den er
ukjent. Les gjeldende fakta om kontofunksjoner; en personlig Instagram-konto eller manglende
leverandørtillatelser kan kreve en støttet kontotype eller ny tilkobling.

X godtar bare originaltekst og lenker; hold media tom. X-medier, svar,
sitater, republiseringer og trådpublisering støttes ikke.

For mål som støtter medier, registrer dem før planlegging: bruk sosoapi_upload_asset for en lokal fil
innenfor tillatte mapper; bruk sosoapi_import_asset_url for en ekstern URL
og kontroller sosoapi_get_asset_import_status med include_asset=true til
avgrensede importen er klar. Den klare asset.id blir media.asset_id og
asset.asset_url blir media.url; et separat get_asset-kall er ikke nødvendig.
Behold samme importidentitet, følg råd for nye forsøk og stopp ved endelig
feil. En vellykket forespørsel beviser ikke at dekoding/import er fullført.
Hvis fremdriften stopper, les sosoapi_job_status med importens job_id før
du venter igjen. En ventende jobb kan allerede ha en kjøringsfeil. En tjeneste-
konfigurasjonsfeil krever operatørens oppfølging, ikke en ny import, en ny sosial
tilkobling eller tillatelse fra personen. Rapporter hindringen uten å hevde
bildet er klart.
Bruk returnert registrert ressurs-ID og kanonisk medie-URL sammen. Aldri
planlegge den opprinnelige eksterne URL-en eller en midlertidig forhåndsvisnings-URL som erstatning.
Gjenbruk en eksisterende klar ressurs først etter å ha kontrollert arbeidsområdet og identiteten.

Bruk sosoapi_get_scheduled_post_eligibility når en veiledende forhåndsvisning er nyttig;
den er valgfri og erstatter ikke kanonisk opprettings-/kjøringsvalidering.
Bruk det kanoniske planlagte innlegget
verktøy. Ett innlegg er ett mål. Gjenbruk samme idempotency_key ved nye forsøk
av nøyaktig samme forespørsel; et endret utkast er en ny forespørsel. Etter tidsavbrudd,
les det eksisterende innlegget før du gjør noe mer. Send aldri blindt på nytt en
usikker skriveoperasjon hos leverandøren. Oppdateringer, avbryting og eksplisitte nye forsøk bruker
gjeldende versjon og serverens handlingskvalifikasjon.

Resultatet må skille mellom:

- Planlagt: akseptert for oppgitt tidspunkt; ennå ikke publisert.
- Pågår eller avstemmes: det endelige resultatet er ubekreftet; ikke send på nytt.
- Publisert: et leverandørbekreftet endelig resultat bekrefter det nøyaktige innlegget;
  returner publiseringslenken når den er tilgjengelig.
- Mislykket eller krever oppfølging: si hva som er kjent og neste tillatte handling;
  koble bare til den berørte kontoen igjen når personen må gi tilgang på nytt.

Rapporter hvert mål separat ved flere mål. Ikke kall hele oppgaven
vellykket når bare noen plattformer lyktes. For en fremtidig publiseringsplan, returner
innleggs-ID-ene og aksepterte tidspunkter; ikke la samtalen vente til
forfallstidspunktet eller opprett en spørreløkke. Ved retur, les de samme innleggene igjen.
Personen kan også se det nøyaktige resultatet igjen på
https://app.sosoapi.ai/scheduled-posts/<post-id>, med den faktiske returnerte ID-en
av SosoAPI. Den siden krever deres egen autoriserte innlogging. For et egendefinert
miljø, bruk den eksplisitt konfigurerte app-opprinnelsen i stedet.
Ikke lov å vekke en lukket assistent eller sende et suksessvarsel som
er ikke konfigurert og verifisert.

## Referanser

- Hurtigstart for mennesker: https://app.sosoapi.ai/start
- Produktveiledning: https://sosoapi.ai/nb/docs/quickstart
- Støttet omfang: Instagram, Threads, Facebook-sider, YouTube og X-original-
  tekst/lenker. Formater og tillatelser varierer etter konto; andre plattformer er ikke
  tilgjengelige bare fordi personen ber om dem.
