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

Kanonikus URL: https://sosoapi.ai/hu/docs/installation

Kapcsold az ügynöködet a SosoAPI-hoz helyi csomaggal vagy hosztolt MCP-vel. Az útmutató a telepítést, kapcsolatellenőrzést és frissítést ismerteti.

## 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.

npm-terjesztések

| Csomag | Cél | Parancs |

| --- | --- | --- |

| sosoapi | Kanonikus CLI és MCP-szerver | npx -y sosoapi --help |

| @sosoapi/cli | A sosoapi pontos verziójához kötött alias | npx -y @sosoapi/cli --help |

| sosoapi-cli | A sosoapi pontos verziójához kötött alias | npx -y sosoapi-cli --help |

| sosoapi-mcp | A sosoapi pontos verziójához kötött alias | npx -y sosoapi-mcp --help |

- [sosoapi](https://www.npmjs.com/package/sosoapi)

- [@sosoapi/cli](https://www.npmjs.com/package/@sosoapi/cli)

- [sosoapi-cli](https://www.npmjs.com/package/sosoapi-cli)

- [sosoapi-mcp](https://www.npmjs.com/package/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](https://sosoapi.ai/hu/docs/mcp)

## 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](https://sosoapi.ai/hu/docs/authentication)

## 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](https://sosoapi.ai/hu/docs/troubleshooting)