SosoAPI telepítése: csomagok, kliensek és távoli MCP

Melyik npm-csomagot telepítsem?

Új beállításhoz telepítsd a sosoapi csomagot. A @sosoapi/cli, sosoapi-cli és sosoapi-mcp aliasok a sosoapi azonos, pontos verzióját telepítik. Ugyanazokat a CLI- és MCP-eszközöket futtatják, ezért egy csomag elég.

A helyi MCP Node.js 20 vagy újabb verziót és npm/npx programot igényel. A hosztolt MCP-hez nem kell helyi csomag. Telepítés vagy kapcsolódás után jelentkezz be a fiókhozzáférés engedélyezéséhez.

• sosoapi
• @sosoapi/cli
• sosoapi-cli
• sosoapi-mcp

Helyi MCP-kliens csatlakoztatása

Az alábbi parancsokkal adj hozzá core profilú kapcsolatot. Ha a SosoAPI már kapcsolódik és működik, tartsd meg azt. Az argumentum nélküli sosoapi a stdio MCP-szervert indítja; a stdin bemeneten várja a klienst.

Claude Desktop, Cursor vagy más stdio kliens esetén az alábbi JSON-t az MCP-beállításokba illeszd. A beállítások helye és jóváhagyási lépések kliensenként eltérnek. Szükség esetén indítsd vagy kapcsold újra a klienst, majd ellenőrizd a SosoAPI-eszközök elérhetőségét a beszélgetésedben.

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

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

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

• MCP-eszközreferencia

Távoli MCP csatlakoztatása OAuth-tal

Távoli MCP-t, OAuth-ot és dinamikus kliensregisztrációt támogató kliensben add meg az alábbi URL-t. Jelentkezz be böngészőn át, és válaszd ki az engedélyezett munkaterületeket és műveleteket. Nem kell API-kulcsot, kliensazonosítót vagy kliens-titkosértéket beillesztened. HTTP-n át nyilvános URL importálásával adhatsz médiát; a helyi fájlfeltöltéshez helyi MCP-szerver szükséges.

A ChatGPT egyéni alkalmazásai és a Claude távoli csatlakozói a csomagodtól és a kliens csatlakozóbeállításaitól függenek. Ez az útmutató egyéni kapcsolatot állít be; nem alkalmazáskatalógus-bejegyzést ír le.

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

• Hitelesítés és engedélyek

Beállítás ellenőrzése közzététel nélkül

Ellenőrizd a hitelesítés állapotát, és szükség esetén jelentkezz be. Olvasd el a munkaterület-kontextust és az összekapcsolt fiókokat, majd erősítsd meg, hogy a kapott fiók és munkaterület a kívánt. Ez bejegyzés beküldése nélkül igazolja a hozzáférést; a közzététel továbbra is a fiók engedélyeitől függ.

A beállítás befejezéséhez nem kell tesztbejegyzést közzétenned. Folytasd az eredeti feladatot a meglévő tartalommal. A felhasználó elvégzi a szolgáltatói hozzájárulást, és minden kért írás előtt ellenőrzi a célhelyet, tartalmat és időpontot.

npx sosoapi auth status

npx sosoapi api contract --route /identity-api/workspace/list --summary

Verzió frissítése vagy rögzítése

Futtasd az npx -y sosoapi@latest --help parancsot az aktuális CLI letöltéséhez, majd indítsd újra az MCP-klienst. Ha a kliens mentett parancsot használ, a kívánt verziót az args értékében add meg. Az aliasok a pontos sosoapi-verziójukhoz kötődnek; egy külön globális telepítés frissítése ezeket nem frissíti.

Verzióeltérési hibánál hasonlítsd össze a telepített szerződést a szükséges művelettel. Frissítsd a csomagot a ténylegesen használt MCP-kliensparancsban, kapcsolódj újra, és próbáld újra a műveletet. A sémaeltérés nem igényel új hitelesítő adatot vagy szélesebb hozzáférést.

npx -y sosoapi@latest --help

npx sosoapi api contract --summary

• Hibaelhárítás