SosoAPI-beállítási útmutató

Válassza ki a kiindulópontot

A SosoAPI a már használt ügynökének egy kapcsolatot ad közösségi fiókjaihoz. Az ügynök a tartalom írásában és ellenőrzésében segít; a SosoAPI a támogatott fiókműveleteket, ütemezést és közzétételi eredményeket kezeli. Ugyanazokat a bejegyzéseket az alkalmazásban is ellenőrizheti, vagy saját kódból használhatja az API-t.

Az útmutató egy személlyel és egy közösségi fiókkal kezdődik. Helyi vagy hosztolt MCP-klienst kapcsol, hozzáférést választ, fiókot ellenőriz, bejegyzést készít elő és hagy jóvá, majd leolvassa a valódi eredményt. A haladó útmutató CLI-t és HTTP API-t tárgyal. Maga a beállítás nem igényel tesztbejegyzést.

• Bízza a beállítást a Claude Code vagy Codex kliensre: 1. lépés
• MCP-kliens kézi beállítása: 3. lépés
• Terminál vagy háttérrendszer használata: 9. lépés
• Kapcsolat javítása: 10. lépés

Mielőtt elkezded

MCP-kompatibilis AI-kliens, SosoAPI-fiók és Ön által kezelhető közösségi fiók szükséges. A SosoAPI-fiókot a bejelentkezés megnyílásakor is létrehozhatja. Legyen egy valódi tartalmi elképzelése.

A helyi MCP-hez Node.js 20 vagy újabb, npm/npx és a választott AI-kliens kell. A hosztolt MCP távoli MCP-t, OAuth-t és automatikus kliensregisztrációt támogató klienst igényel; nem kell helyi Node.js-telepítés. A kliens funkciói a csomagtól és rendszergazdai beállításoktól függhetnek.

A SosoAPI az Instagram, Threads, Facebook Pages, YouTube és X platformokat kapcsolja össze. Olyan fiókot válasszon, amelynek típusa, engedélyei és bejegyzésformátuma illik a feladathoz. Egy jogosult Threads-fiók jó első, csak szöveges példa. Az Instagram és a YouTube támogatott közzétételi formátumaihoz megfelelő média kell. A platform jelenléte a kapcsolódási menüben nem jelenti, hogy minden fióknál minden művelet elérhető.

Beállításkor ellenőrizze a fiókspecifikus képességeket. Köteg ütemezése előtt az alkalmazásban olvassa le aktuális csomagját és kvótáját; az X külön Organization-kreditkerettel rendelkezik. Egy platform példája nem igazolja másik támogatását.

• Támogatott platformok
• Közzétételi lehetőségek és fiókkövetelmények

1. Adja át ügynökének a beállítási kérést

Illessze ezt meglévő Claude Code- vagy Codex-beszélgetésébe.

Az ügynök előbb keressen működő SosoAPI-kapcsolatot, és használja újra. Máskülönben kövesse a beállítás menetét, és jelezze, mikor kell böngészős bejelentkezés vagy kliensújraindítás. Elvárt eredmény: a SosoAPI-eszközök használhatók ebben a beszélgetésben. Egy telepítési üzenet önmagában nem bizonyíték. Folytassa bejelentkezéssel és fiókellenőrzéssel, vagy kézi beállításhoz használja a 3. lépést.

Állítsd be a SosoAPI-t a https://sosoapi.ai/setup.md alapján. Őrizd meg a jelenlegi tartalmamat és feladatomat. Kérésre bejelentkezem és jóváhagyom a hozzáférést. A beállítás során ne tegyél közzé semmit.

2. Jelentkezzen be, és válassza ki ügynöke hozzáférését

A kívánt fiókját használja: folytassa Google-fiókkal, vagy regisztráljon e-maillel, és fejezze be az ellenőrzést. Végezze el a megjelenített fiók- vagy Workspace-beállítást. Több Workspaces-tagságnál válassza a kívánt márkát vagy projektet. Jóváhagyás előtt ellenőrizze a kért Workspaces elemeket és műveleteket, majd térjen vissza ugyanabba a beszélgetésbe.

Őrizze meg az ügynöktől kapott bejelentkezési linket, hogy a böngésző visszatérhessen a függő engedélyezéshez. Először az alkalmazásban is kezdhet, majd visszatérhet az ügynökhöz. Ne cserélje másik bejelentkezési linkre a függő jóváhagyási linket.

A Workspace-szerepkörök és platformengedélyek továbbra is érvényesek: a megtekintő nem lesz szerkesztő az ügynök közzétételi hozzáférésétől. A közzétételi hozzáférés a megadott körben folyamatos; a SosoAPI nem kér bejegyzésenként új böngészős jóváhagyást. Mondja meg az ügynöknek, mikor várjon tartalomellenőrzésre. A szokásos OAuth-beállításhoz nem kell közösségi jelszót vagy API-kulcsot az ügynökbe illeszteni.

Elvárt eredmény: a bejelentkezés a kívánt személyazonossággal befejeződik, és az ügynök lekérheti az engedélyezett Workspaces elemeket. Rossz böngészőprofil esetén használja a hibaelhárítást.

• Kezdje a SosoAPI alkalmazásban

3. Szükség esetén csatlakoztassa kézzel az ügynökét

Válasszon egy kapcsolódási módot. Hagyja ki ezt a részt, ha az ügynök már működő kapcsolatot állított be. Helyi MCP-hez először ellenőrizze a Node.js és npx meglétét. A Node.js 20-as vagy újabb verziója kell.

node --version
npx --version

Helyi MCP: Claude Code vagy Codex

Csak saját kliense parancsát futtassa: az első a Claude Code, a második a Codex számára való. A core profil a mindennapi közzétételt fedi le. A profilok a látható eszközöket módosítják, engedélyt nem adnak. Ha már van működő full-profile kapcsolata, tartsa meg.

A kliens kérésére csatlakozzon vagy indítsa újra, majd ellenőrizze, hogy a SosoAPI-eszközök elérhetők-e az aktuális beszélgetésben. Az első hitelesített hívás szükség esetén böngészős bejelentkezést indít.

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

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

Más helyi MCP-kliensek

mcpServers JSON-t használó kliensnél ezt a bejegyzést adja a meglévő konfigurációhoz, és őrizze meg a többi szervert. Más konfigurációs formátumokban ugyanazt a parancsot, argumentumokat és környezeti változót adja meg a kliens saját MCP-beállításain keresztül.

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

• Telepítési hivatkozás és csomagválasztás

Hosztolt MCP: kompatibilis böngészős vagy távoli kliensek

A kliens egyéni csatlakozó- vagy távoli MCP-beállításaiban az alábbi szerver-URL-lel adjon hozzá SosoAPI nevű kapcsolatot. Válassza az OAuth automatikus kliensregisztrációját, ha felkínálják. Jelentkezzen be a SosoAPI-ba, válasszon engedélyezett Workspaces elemeket és műveleteket, térjen vissza a beszélgetésbe, és szükség esetén kapcsolja be a kapcsolatot. Kérje az ügynöktől az engedélyezett fiókok ellenőrzését.

Új hosztolt kapcsolathoz használja a https://sosoapi.ai címet. A régi https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp végpont továbbra is támogatott. Őrizze meg a működő helyi vagy hosztolt kapcsolatot; nem kell csak az URL módosításáért lecserélnie.

Nem kell API-kulcsot, kliensazonosítót vagy kliens-titkot beilleszteni. A ChatGPT egyéni MCP-alkalmazásai a kliens csomagjától, fejlesztői módjától és rendszergazdai beállításaitól függnek. Az útmutató egyéni kapcsolatot, nem alkalmazáskönyvtári bejegyzést ír le. A hosztolt MCP nem olvas helyi fájlokat; nyilvános URL-importot vagy helyi feltöltéshez helyi MCP-t használjon.

https://sosoapi.ai

• Egyéni OAuth-kliensregisztráció és tokenútmutató

Opcionális terminálos bejelentkezés-ellenőrzés

Helyi kapcsolathoz előbb futtassa az auth status parancsot. Csak ha nem bejelentkezett állapotot jelez, futtassa az auth login parancsot. Fejezze be a böngészős folyamatot, majd ellenőrizze újra az állapotot. A tokenek nem jelennek meg. Ez a helyi CLI-hitelesítést ellenőrzi, nem külön hosztolt csatlakozó belépését.

npx -y sosoapi auth status

npx -y sosoapi auth login

4. Csatlakoztassa közösségi fiókját

Nyissa meg a Fiókok csatlakoztatása felületet, vagy használja az alábbi helyi parancsot. Szükség szerint a threads helyére instagram, facebook, youtube vagy x kerüljön. Ez a kapcsolódási folyamatot nyitja meg; tartalmat nem tesz közzé.

Ellenőrizze a megjelenített Organization és Workspace értékét. Válasszon platformot, jelentkezzen be annak engedélyezési oldalán, és válassza ki a pontos fiókot, Page elemet vagy csatornát. Visszatéréskor fejezze be a hozzájárulást és a fiókválasztás megerősítését. Ezután kérje az ügynököt a kívánt Workspace kapcsolt fiókjainak frissítésére.

Használjon meglévő, egészséges kapcsolatot. Ha másik Organization vagy Workspace tulajdona, az alkalmazásban tisztázza a választást; a szokásos beállítás ne bontsa és ne mozgassa át. Elvárt eredmény: a megfelelő fiók a kívánt Workspace alatt jelenik meg aktuális állapot- és képességadatokkal. A sikeres callback önmagában nem bizonyít közzétételi engedélyt.

npx -y sosoapi connect threads

• Fiókok csatlakoztatása

5. Hozzáférés ellenőrzése közzététel nélkül

Illessze a következőt a kapcsolt ügynök beszélgetésébe.

Az ügynök használhatja a sosoapi_get_workspace_context és sosoapi_list_connected_accounts eszközt, újrahasználhatja az ismert környezetet, és kifejezetten átadhatja a választott workspace_id értéket. A fiók inicializálása létrehozhatja első Workspace elemét; ez a beállításellenőrzés nem hoz létre közösségi bejegyzést.

Folytatás előtt erősítse meg a Workspace elemet és célt, szerepkörét és ügynökhozzáférését, valamint a cél formátumtámogatását. Sikertelen ellenőrzésnél használja a hibaelhárítást. A csomag újratelepítése nem pótol hiányzó platformengedélyt.

Ellenőrizze a SosoAPI-beállításomat közzététel és ütemezés nélkül.
Mutassa meg a használható Workspaces elemeket és a választott Workspace közösségi fiókjait.
A választott fióknál mutassa meg a platformot, a fiók címkéjét, a kapcsolat állapotát és a javasolt formátum közzétételi lehetőségeit.
Ha több Workspaces vagy fiók is megfelelhet, kérdezze meg, melyiket használja.
A belső azonosítókat tartsa meg az eszközhívásokhoz; ne kérje, hogy megkeressem vagy kitaláljam őket.

6. Készítse elő és hagyja jóvá első bejegyzését

Egy valódi bejegyzéssel és egy céllal kezdjen. Cserélje ki a piszkozatkérés szögletes zárójeles mezőit. Az ügynök ír; a SosoAPI a kapcsolatot és közzétételi műveleteket biztosítja. Az állításokat, helyesírást, linkeket és médiát Ön ellenőrizze.

Jövőbeli bejegyzéshez adjon meg egyértelmű dátumot, helyi időt és IANA-időzónát. Ha a nyári időszámítás kétértelművé teszi a helyi időt, beküldés előtt válassza ki a kívánt előfordulást. Ebben a szakaszban elvárt eredmény: pontos piszkozat ellenőrzésre, közzétételi kérés beküldése nélkül.

Segítsen egy termékbejelentést előkészíteni a SosoAPI segítségével.

Termék: [nyilvános terméknév]
Igazolt tények: [ami ma elérhető]
Célközönség: [kinek segít]
Cél: [fiókcímke és platform]
Nyelv: [nyelv]
Kívánt helyi dátum és idő: [YYYY-MM-DD HH:mm]
Időzóna: [IANA-időzóna, például Asia/Hong_Kong]
Média: [nincs, helyi fájl vagy nyilvános média-URL]

Csak az általam megadott tényeket használja. Ellenőrizze a cél formátumkövetelményeit.
Mutassa meg ellenőrzésre a pontos piszkozatot, médiát, célt, dátumot, időpontot és időzónát.
Még ne ütemezzen és ne tegyen közzé.

Ütemezés előtt hagyja jóvá a pontos bejegyzést

Ha minden adat helyes, adjon konkrét utasítást az alábbi kéréssel. Ez valódi, nyilvánosan közzétehető ütemezést hoz létre. Olyan tartalmat és fiókot használjon, amellyel tényleg közzétenne. Az azonnali közzétételhez is kifejezett utasítás kell ugyanazon adatok átnézése után.

Elvárt eredmény: Scheduled Post-azonosító, kívánt cél, elfogadott időpont és aktuális állapot. Az elfogadott ütemezés nem jelenti, hogy a szolgáltató már közzétette.

Ütemezze az alábbi pontosan jóváhagyott bejegyzést a megnevezett fiókra, a megadott dátumra, időre és időzónára.

[Illessze be a végleges tartalmat, médiát, célt, dátumot, időpontot és időzónát.]

Előbb keressen meglévő, egyező ütemezést. Egyszer küldje be a bejegyzést, és olvassa vissza a mentett eredményt. Adja vissza az azonosítót, célt, elfogadott időpontot és aktuális állapotot. Bizonytalan eredménynél más művelet előtt ellenőrizze a meglévő kérést.

7. Eredmény ellenőrzése, átütemezés vagy törlés

Kérje meg az ügynököt, hogy ugyanazt a Scheduled Post elemet olvassa le a sosoapi_get_scheduled_post eszközzel. Jogosult fiókkal bejelentkezve a https://app.sosoapi.ai/scheduled-posts/<post-id> címet is megnyithatja. Több célfióknál minden célt külön ellenőrizzen; egyesek sikerülhetnek, mások figyelmet igényelhetnek.

Olvassa le a Scheduled Post [visszaadott azonosító] aktuális eredményét.
Mutassa meg a célt, az ütemezett időpontot, a jelenlegi állapotot és a közzététel eredményét.
Megerősített közzétételnél adja meg az élő hivatkozást, ha elérhető.
Ne próbálja újra, ne ütemezze át, és ne hozzon létre másik bejegyzést.

Függő bejegyzés kezelése és későbbi visszatérés

Függő bejegyzés módosításához adja meg az azonosítóját és az új részleteket. Támogatott frissítés vagy törlés előtt az ügynöknek le kell olvasnia az aktuális verziót és elérhető műveleteket. A törlés a kézbesítési szakasztól függ, és a kézbesítés megkezdése után elérhetetlenné válhat. Az ütemezés törlése nem távolít el már közzétett szolgáltatói bejegyzést.

Jövőbeli ütemezés mentett adatainak átvétele után elhagyhatja a beszélgetést, és később ugyanahhoz a bejegyzéshez térhet vissza. A bezárt ügynökbeszélgetés nem ígér önálló felébredést vagy értesítést, hacsak azt külön nem állították be.

8. Képek vagy videó hozzáadása, majd a folyamat újrahasználata

Nagyobb köteg előtt működjön az egybejegyzéses folyamat. Mondja el az ügynöknek, hogy a média helyi fájl, nyilvános URL vagy meglévő SosoAPI-médiaelem.

Helyi fájlok: a helyi MCP használhatja a sosoapi_upload_asset eszközt. A fájlnak engedélyezett feltöltési mappában kell lennie; határon túli útvonalnál az eszköz ismerteti az engedélyezett helyeket. A hosztolt MCP nem olvashat fájlokat az Ön számítógépén.

Nyilvános URL-ek: használja a sosoapi_import_asset_url, majd a sosoapi_get_asset_import_status eszközt include_asset=true mellett. Várja meg, amíg a médiaelem kész. Meglévő elemnél ellenőrizze, hogy a kívánt Workspace tulajdona-e, és kész-e a választott formátumhoz.

A szokásos ütemezési kérés a regisztrált médiaelem-azonosítót és annak kanonikus URL-jét együtt használja. Ideiglenes előnézeti URL vagy az eredeti külső forrás URL-je nem helyettesíti ezeket. A támogatott, egyetlen kép-URL-es folyamatban a sosoapi_post_image_url egyesíti az importálást és a beküldést. Ez közzétételi művelet: előbb hagyja jóvá a teljes bejegyzést. Feldolgozás közben őrizze meg az elfogadott bejegyzés azonosítóját; ne indítson új importálást a folytatáshoz.

Az X eredeti, média nélküli TEXT Post bejegyzést, vagy pontosan egy kész, regisztrált MP4-videóval VIDEO formátumot támogat, legalább 0.5 másodperces hosszal és az 500 MiB feltöltési korláton belül. Videóhoz a pontos fiók igazolt can_publish_video engedélye kell; a szöveghozzáférés nem elég. Régebbi kapcsolatnál jóvá kell hagynia a videófeltöltési engedélyes újracsatlakozást. Minden szövegnek, hashtagnek és linknek bele kell férnie az X súlyozott szövegkorlátjába. Fényképek, válaszok, idézetek, újramegosztások és bejegyzésláncok nem támogatottak. A feltöltés vagy videófeldolgozás elfogadása nem közzétett eredmény.

X-beküldés előtt olvassa le a sosoapi_get_x_usage eredményét a kívánt workspace_id és végleges szöveg mellett. Kerete és költsége különbözik az általános csomagkvótától. Ne kerülje meg ismételt beküldéssel a kreditkorlátot; másik küldés előtt egyeztesse a bizonytalan közzétételt.

Ellenőrzött köteg előkészítése és a teljesítmény őszinte leolvasása

Első sikeres bejegyzése után próbálja ki az alábbi termékindítási kérést. A pontos táblázat jóváhagyása után ellenőrizze a köteget a csomagkorlátokhoz képest. Külön jelezze az elfogadott és elutasított célokat, és őrizze meg minden elfogadott bejegyzés azonosságát.

A közzétételi és elemzési hozzáférés eltérhet. Későbbi teljesítményértékelésnél a nem elérhető mutatókat nem elérhetőként kell jelezni. Ne találjon ki nullákat, és ne következtesse, hogy egy közzétett bejegyzés miatt minden mutató olvasható.

Ugyanazzal az igazolt beállítással készítsen hét termékbejelentési piszkozatot, naponta egyet, az általam megadott nyilvános tényekből. Mutasson ellenőrző táblázatot soronként piszkozattal, céllal, médiával, helyi dátummal, időponttal és időzónával. Mind a hét maradjon piszkozat a pontos táblázat jóváhagyásáig.

9. CLI- és API-útmutató

Ezt az opcionális utat kifejezett kérésfájlokhoz vagy háttérrendszeri integrációhoz használja. Az ügynökhasználók kihagyhatják. A példák ugyanazt a fiókot, Workspace elemet és közzétételi engedélyeket használják, mint az MCP.

Előbb ellenőrizze a telepített csomag súgóját és beágyazott szerződését; ehhez nem kell bejelentkezés. A csomaggal szállított műveleteket és sémákat mutatja. Ezeket a mezőneveket használja, ne más szolgáltató kérésformátumát.

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

CLI: az első hitelesített környezetkérés elküldése

Fejezze be az auth login lépést. Szövegszerkesztővel mentse a lenti JSON-t tartalmazó workspaces.json fájlt, majd futtassa a parancsot. A kéréstörzseket fájlokban adja meg ahelyett, hogy tartalmat illesztene a shellparancsokba.

A CLI schema_version, http_status és body mezőket ad vissza. Sikeres válaszban body.active_workspace_id és body.workspaces található. A válaszból válassza ki a kívánt Workspace elemet; az aktív Workspace nem dönt észrevétlenül új feladat céljáról. Új fiók első hívása inicializálhatja első Workspace elemét.

A http_status és body értékét ellenőrizze, ne csak a shell kilépési kódját. Egy parancs HTTP-hibaborítékot is visszaadhat sikeres API-művelet nélkül.

{}

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

CLI: a kapcsolt közösségi fiók kiválasztása

Mentse az accounts.json fájlt a fiókjához visszaadott Workspace-azonosítóval, majd futtassa a parancsot. A body.accounts mezőből válassza ki a kívánt fiókot. A SosoAPI-fiókazonosító az ütemezéshez használt social_account_id; a felhasználónév vagy szolgáltatói Page-azonosító nem helyettesíti.

{
  "workspace_id": "<YOUR_WORKSPACE_ID>"
}

npx -y sosoapi api post /identity-api/user/social-accounts/list < accounts.json

CLI: egy jóváhagyott Threads-szöveg ütemezése

Ez kéréssablon, nem azonnal futtatható bejegyzés. Fájlszerkesztővel mentse a post.json fájlt, és minden szögletes zárójeles értéket cseréljen saját, engedélyezett értékére. Válasszon jövőbeli ISO-időbélyeget kifejezett UTC-eltolással, vagy Z értéket az UTC-hez. A display_timezone megjelenítési IANA-időzóna; nem tesz teljessé egy kétértelmű helyi időbélyeget.

Hozzon létre egyedi idempotency_key értéket, például UUID-t, és őrizze meg a kérés pontos törzsével együtt. Azonos kérést ugyanazzal a kulccsal próbáljon újra; a késő válasz nem indok új kulcsra. A módosított bejegyzés másik kérés: új azonosító választása előtt ellenőrizze az eredeti eredményt.

A tartalom, fiók, időpont, jogosultságok és aktuális kvóta megerősítése után futtassa a létrehozási parancsot. Ez valódi bejegyzést ütemez. Elfogadáskor őrizze meg a body.post.id értékét, és olvassa le a body.post.status, body.post.scheduled_at és body.post.destination mezőket. A body.deduped jelzi, ha egy meglévő kérést használt újra. Az elfogadás nem szolgáltató által megerősített közzététel.

{
  "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: a mentett bejegyzés és eredménye leolvasása

Mentse a post-status.json fájlt a visszaadott azonosítóval. Olvassa le a body.post, body.delivery, body.actions és body.outcomes mezőket. Siker jelentése előtt igazolja a közzétett eredményt. Elveszett létrehozási válasznál a mentett azonosítóval állítsa helyre az eredeti kérést; ne hozzon létre másik ütemezést új kulccsal.

{
  "id": "<RETURNED_POST_ID>"
}

npx -y sosoapi api post /studio-api/scheduled-posts/get < post-status.json

CLI: csak akkor töröljön, ha a jelenlegi eredmény engedi

Ha a legutóbbi olvasás engedi a törlést, és törölni kíván, mentse a cancel.json fájlt a visszaadott azonosítóval és az aktuális számszerű body.post.version értékkel. Az 1 csak szemléltető érték: cserélje az imént leolvasott verzióra. Ezután futtassa a parancsot, és erősítse meg az eredményt.

Ha a verzió változott vagy a törlés nem elérhető, olvassa le újra ugyanazt a bejegyzést, és a ténylegesen elérhető műveleteit használja. Ne kerülje meg a verzióütközést, és ne keverje össze az ütemezés törlését egy már közzétett bejegyzés eltávolításával.

{
  "id": "<RETURNED_POST_ID>",
  "expected_version": 1
}

npx -y sosoapi api post /studio-api/scheduled-posts/cancel < cancel.json

HTTP: hívás saját háttérrendszerből

Szerveroldali integrációhoz a Connection → API alatt hozzon létre API-kulcsot, és a titkot szervere titkos konfigurációjában tárolja. A jelenlegi képernyő nevet kér, Workspace- vagy képességválasztót nem kínál. A felhasználó által létrehozott kulcs alapból operate, publish és engage jogot kap a felhasználó által elérhető Workspaces elemekben. Ellenőrizze, hogy ez illik-e integrációjához. Az API-szerződés támogat kifejezetten korlátozott képességeket és workspace_ids értékeket hatókörös kulcshoz.

A szokásos ügynökbeállítás OAuth-t használ, ezért nem igényli ezt az API-kulcsos lépést. A példában a SOSOAPI_ACCESS_TOKEN a kulcsot tartalmazó szerveroldali példaváltozó, nem SosoAPI CLI-beállítás. A CLI opcionális személyes hozzáférésitoken-változója a VICKY_API_KEY.

Használja a fenti workspaces.json fájlt. A közvetlen HTTP a végpont törzsét adja vissza a CLI http_status/body borítéka nélkül; olvassa le a tényleges HTTP-állapotot és JSON-t. A hitelesítő adatokat tartsa a háttérrendszerben, ne böngészőkódban, kérésszövegben, képernyőképen vagy megosztott kérésfájlban.

A közösségi kapcsolódás beágyazása saját ügyfelei termékébe külön integrációs feladat. Ez az egyfiókos útmutató nem bizonyítja az ügyfélbeléptetési folyamat készségét.

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'

• API-kulcsok kezelése: Connection → API
• API-referencia
• API-kulcs létrehozása és kifejezett jogosultság
• Hitelesítés és engedélyek
• CLI-referencia

10. Hibaelhárítás

A tényleges hibát és a vizsgált kapcsolatot használja. A jogosultságok bővítése vagy ismételt beküldés nem javít minden hibát.

Frissítés, hozzáférés visszavonása vagy segítségkérés

Az első alábbi parancs a legfrissebb csomag súgóját ellenőrzi az MCP-szerver indítása nélkül. Ha a kliens mentett parancsa rögzít egy verziót, tudatosan azt a parancsot frissítse. Egy külön globális telepítés frissítése nem frissíti a kliens rögzített példányát.

Helyi eszköz visszavonásához használja a Connection → Agent felületet vagy az alábbi auth logout parancsot. Hosztolt csatlakozónál a megfelelő hosztolt engedélyezést vonja vissza a Connection → Agent alatt. Az API-kulcsok külön, a Connection → API alatt kezelhetők. Az ügynökhozzáférés visszavonása nem törli az elfogadott ütemezéseket; azokat a bejegyzéseket külön kezelje.

Segítséghez adja meg a klienst és csomagverziót, a hibás lépést, a megjelenített hibát és az időt/időzónát. Szükség esetén a releváns kérés- vagy bejegyzésazonosítókat privát módon ossza meg a támogatással. Ne küldjön hitelesítő adatot, engedélyezési linket vagy tokent tartalmazható nyers naplót.

npx -y sosoapi@latest --help

npx -y sosoapi auth logout

• Ügynökkliensek kezelése: Connection → Agent
• API-kulcsok kezelése: Connection → API
• Hibaelhárítási segédlet
• Kapcsolat a SosoAPI támogatásával

Beállítási ellenőrzőlista

A kapcsolatot bejegyzés beküldése nélkül is beállíthatja. Ha közzétesz, a külön eredményellenőrzéssel igazolja az első közzétételi folyamatot.

• A kliensem használhatja a SosoAPI-eszközöket, vagy a CLI/API-m engedélyezett kérést küldhet.
• A kívánt fiókkal jelentkeztem be, és a megfelelő Workspace elemet választottam.
• Közösségi fiókom megjelenik a feladathoz szükséges képességekkel.
• Értem, hogy ügynököm csak előkészíthet munkát, vagy ütemezhet és közzétehet is.
• El tudok készíteni egy piszkozatot, és át tudom nézni a pontos célt, tartalmat és időpontot.
• Ha beküldtem bejegyzést, megőriztem az azonosítóját, és meg tudom különböztetni az elfogadást a megerősített közzétételtől.
• Tudom, hogyan vizsgáljak ki hibát, kezeljek függő ütemezést és vonjak vissza hozzáférést.