# Konfigurera SosoAPI för personen som använder denna assistent

Använd personens befintliga assistent och behåll ursprunglig uppgift, innehåll och
mediehänvisningar i denna konversation. Använd en SosoAPI MCP för deras anslutna
sociala konton. Återanvänd en befintlig anslutning eller välj lokal eller värdbaserad åtkomst
nedan. Konfiguration publicerar inget inlägg. Personen loggar in och väljer vad som ska
auktorisera i sin webbläsare. Ange aldrig deras inloggningsuppgifter och godkänn inte samtycke
åt dem. Free kräver inget kort.

## 1. Anslut denna assistent

Kontrollera först aktuell värd och dess befintliga SosoAPI-konfiguration. Återanvänd en
fungerande anslutning; logga inte ut, skriv inte över konfiguration och skapa inte ytterligare en
anslutning bara för att denna guide öppnades igen.

För ett lokalt shell kontrollerar du att Node.js 20 eller senare och npx finns. Använd en
befintlig stödd körmiljö. Om den saknas, förklara förutsättningen med enkelt
språk; gör inte privilegierade eller globala systemändringar automatiskt.

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

När servern har registrerats kontrollerar du att du kan anropa dess verktyg i denna
konversationen. Om värden behöver återanslutning eller omstart, tala om för personen vilken
åtgärd att utföra. Vänta tills verktygen fungerar innan du säger att anslutningen är klar.

Nya anslutningar använder den befintliga core-profilen med 28 verktyg för vanlig publicering,
medier, kommentarer och insikter. En fungerande full-profilanslutning bör återanvändas.
Om en begärd administrationsåtgärd saknas, förklara att full-profilen
är tillgängligt; att dölja ett verktyg ger eller återkallar ingen behörighet.

För en ren webbläsarklient, som ChatGPT med stöd för egna MCP-appar, lägg till denna
fjärr-MCP-URL och välj OAuth med automatisk klientregistrering:

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

Ingen API-nyckel, klient-ID eller klienthemlighet behöver klistras in. Personen loggar in
i SosoAPI och väljer sina arbetsytor/åtgärder. Egna ChatGPT-appar beror på
dess abonnemang och tillgång till utvecklarläge. Återanvänd en fungerande lokal eller fjärransluten
anslutning om en redan är konfigurerad.

X stöder egna textinlägg och länkar. Varje organisation delar 10 Free-X-krediter
en gång, eller 100 per Pro-faktureringsperiod. Ren text kostar 1; ett inlägg som innehåller en URL
kostar 10. Läs `sosoapi_get_x_usage` med workspace_id innan du planerar X-användning.
Ingen automatisk överförbrukningsavgift tas ut; en osäker publicering behåller sin kredit
reservation och måste stämmas av före en ny sändning.

## 2. Logga in utan API-nyckel

Första autentiserade MCP-anropet öppnar befintlig webbläsarinloggning och agentens
samtyckesflöde. Personen kan använda Google eller registrera sig och verifiera sin e-post.
Låt dem välja arbetsyta och om assistenten endast får förbereda
innehåll eller även schemalägga och publicera. Be dem inte kopiera inloggningsuppgifter.
Publiceringssamtycke gäller löpande inom valt omfång, inte en obligatorisk
godkännandeskärm för varje inlägg. Håll nyckelhantering avstängd för vanlig publicering.

Registrering och inloggning via e-post använder säkerhetsverifiering i bakgrunden, utan en
kryssruta som personen ska lösa. Om verifieringen misslyckas, redovisa det faktiska
felet och använd den tillgängliga återförsöksåtgärden; be inte personen hitta eller klicka på
en CAPTCHA-ruta. Det befintliga alternativet **Fortsätt med Google** finns också
om personen vill använda Google; Google kan kräva en egen identitetskontroll.
Låt personen välja sitt konto och godkänna åtkomst.
Behåll aktuell inloggnings-/godkännandelänk och dess returdestination; ersätt inte
den med en fristående registrerings-URL och byt inte tyst till en befintlig underhållares identitet.
Ett inloggningsfel bevisar inte att alla inloggningsmetoder är otillgängliga.

Pausa endast steget som behöver personens identitet eller samtycke. Medan personen
slutför det, gör klart installationskontrollerna och förbered det ursprungliga utkastet utan att
hitta på ett konto eller en arbetsyta. Förklara vad som redan är klart och den enda
åtgärd som behövs härnäst. Efter inloggning, läs autentiserad kontext igen och återuppta
samma uppgift. Inaktivera inte CAPTCHA, använd inte administratörs-API:er för registrering, be inte om token,
eller hävda att kontot/anslutningen är klart innan det faktiska flödet slutförs.

Om MCP-verktygen behöver att värden laddas om finns lokal CLI också tillgänglig för denna
assistent. Kör `npx -y sosoapi auth status` först; använd
`npx -y sosoapi auth login` endast när inloggning behövs. Läs aldrig
uppgiftsfil eller skriv ut token. Om inloggningen öppnar fel webbläsarprofil, stoppa
den väntande inloggningen innan du startar en ny `npx -y sosoapi auth login --no-open`.
Personen öppnar den nya utskrivna länken i avsedd profil och kontrollerar
inloggad identitet före godkännande. Kör aldrig två profiler samtidigt på samma länk.
Använd `--help` först för att bekräfta att återställningsflaggan finns i installerad CLI;
om den saknas, förklara versionsbegränsningen i stället för att hitta på en fungerande flagga.
CLI kan granska sina inbyggda kontrakt:

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

Syntaxen för CLI-anrop är `sosoapi api post </allowlisted-route> < request.json`.
Skriv JSON med ditt filverktyg; infoga inte användarinnehåll i shell
kommandon. Läs http_status och svarskroppen, inte bara processens avslutnings
kod. Ett API-fel är inte framgång. Använd endast rutter och scheman från det
inbyggt kontrakt; hitta inte på namn och kringgå inte en saknad funktion.

## 3. Anslut personens eget sociala konto

Hämta autentiserad organisation och arbetsyta från SosoAPI-kontexten.
Gissa aldrig identifierare och byt inte tyst till en annan arbetsyta. Om
det finns mer än ett lämpligt varumärke, fråga vilket personen avser.

Använd en befintlig anslutning när den är frisk. Kör annars
`npx -y sosoapi connect <platform>` (instagram, threads, facebook, youtube eller x)
eller ge personen https://app.sosoapi.ai/connect. De slutför leverantörens
samtycke och granska det exakta kontot i webbläsaren. När de återvänder,
läs konton och publiceringsfunktioner igen. En återkoppling från anslutningen är inte
bevis för att publicering är tillåten. Återanvänd det ursprungliga utkastet; be inte
personen kopiera en intern identifierare eller återskapa sitt innehåll.

## 4. Slutför den ursprungliga publiceringsuppgiften

Använd personens befintliga begäran eller fråga vad personen vill marknadsföra. Gör inte
hitta på ett testinlägg. Visa exakt destinationskonto, innehåll, medier och
lokalt datum/tid före första inskickningen. Bekräfta tidszonen när den är
okänt. Läs aktuella kontofunktionsuppgifter; ett personligt Instagram-konto eller saknade
leverantörsbehörigheter kan kräva en stödd kontotyp eller återanslutning.

X godtar endast egna textinlägg och länkar; håll media tomt. X-medier, svar,
citat, återpubliceringar och trådpublicering stöds inte.

För destinationer som stöder medier registrerar du dem före schemaläggning: använd sosoapi_upload_asset för en lokal fil
inom dess tillåtna mappar; för en extern URL använder du sosoapi_import_asset_url
och kontrollera sosoapi_get_asset_import_status med include_asset=true tills
avgränsade importen är klar. Den färdiga asset.id blir media.asset_id och
asset.asset_url blir media.url; inget separat get_asset-anrop krävs.
Behåll samma importidentitet, följ vägledning för nya försök och stoppa vid ett slutligt
misslyckande. En lyckad begäran bevisar inte att avkodning/import är klar.
Om förloppet stannar, läs sosoapi_job_status med importens job_id innan
vänta igen. Ett väntande jobb kan redan ha ett körningsfel. Ett tjänste
konfigurationsfel behöver operatörens uppmärksamhet, inte en ny import, en ny social
anslutning eller behörighet från personen. Redovisa hindret utan att hävda
bilden är klar.
Använd returnerat registrerat mediefils-ID och kanonisk medie-URL tillsammans. Gör aldrig
schemalägg den ursprungliga externa URL:en eller en tillfällig förhandsvisnings-URL som ersättning.
Återanvänd en befintlig färdig mediefil först efter att ha kontrollerat dess arbetsyta och identitet.

Använd sosoapi_get_scheduled_post_eligibility när en rådgivande förhandsvisning är till hjälp;
det är valfritt och ersätter inte kanonisk validering vid skapande/körning.
Använd den kanoniska Scheduled Post
verktyg. Ett inlägg är en destination. Återanvänd samma idempotency_key vid nya försök
av exakt samma begäran; ett ändrat utkast är en ny begäran. Efter en timeout,
läs det befintliga inlägget innan du gör något mer. Skicka aldrig blint om en
osäker leverantörsskrivning. Uppdateringar, avbrytande och uttryckliga nya försök använder
aktuell version och serverns bedömning av tillåtna åtgärder.

Resultatet måste skilja mellan:

- Schemalagt: accepterat för angiven tid; ännu inte publicerat.
- Pågår eller stäms av: slutresultatet är obekräftat; skicka inte om.
- Publicerat: ett leverantörsstyrkt slutresultat bekräftar exakt inlägg;
  returnera länken till det publicerade inlägget när den finns.
- Misslyckat eller kräver åtgärd: säg vad som är känt och nästa tillåtna åtgärd;
  anslut endast det berörda kontot igen när personen måste bevilja åtkomst på nytt.

Redovisa varje destination separat om det finns flera. Kalla inte hela uppgiften
lyckat när endast vissa plattformar lyckades. För en framtida schemaläggning returnerar du
inläggs-ID:n och accepterade tider; håll inte konversationen väntande till
förfallotiden och skapa ingen pollningsloop. Läs samma inlägg igen när du återvänder.
Personen kan också återbesöka exakt resultat på
https://app.sosoapi.ai/scheduled-posts/<post-id>, med det faktiska returnerade ID:t
av SosoAPI. Sidan kräver deras egen behöriga inloggning. För en egen
miljö, använd dess uttryckligt konfigurerade appursprung i stället.
Lova inte att väcka en stängd assistent eller skicka en framgångsavisering som
inte har konfigurerats och verifierats.

## Referenser

- Snabbstart för människor: https://app.sosoapi.ai/start
- Produktguide: https://sosoapi.ai/sv/docs/quickstart
- Stött omfång: Instagram, Threads, Facebook-sidor, YouTube och egna X-
  text/länkar. Format och behörigheter varierar mellan konton; andra plattformar är inte
  tillgängliga enbart för att personen begär dem.
