MCP-szerver

MCP-kliens beállítása

A kapcsolat két módja, a kész beállítási blokk helye, és a leggyakoribb csatlakozási hibák.

A beállítás lépései

1
Készíts MCP-kulcsot
A Postyban, a Beállítások → Fejlesztőknek oldalon. A kulcs psty_mcp_ előtaggal kezdődik, és a létrehozáskor látszik egyszer.
2
Másold ki a kész beállítási blokkot
Ugyanazon az oldalon kész blokkokat találsz a leggyakoribb kliensekhez, a kulccsal együtt.
3
Illeszd be a kliens beállításaiba
Minden kliens máshol tartja a konfigurációját; a blokk tartalma viszont ugyanaz.
4
Indítsd újra a klienst
A legtöbb kliens csak indításkor olvassa be a konfigurációt.

A beállítás alakja

A legtöbb kliens ugyanazt a JSON-alakot használja. A lényeg a cím és a fejléc:

{
  "mcpServers": {
    "posty": {
      "type": "http",
      "url": "https://api.posty.hu/mcp",
      "headers": {
        "Authorization": "Bearer psty_mcp_a_kulcsod"
      }
    }
  }
}

Itt van Bearer előtag

Az MCP-kulcs Bearer előtaggal megy, a REST API-kulcs viszont önmagában a fejléc értéke. Ez a két hely, ahol könnyű elrontani.

Ha a kliensed OAuth-tal csatlakozik, és nem tárol kulcsot, a cím https://api.posty.hu/mcp-oauth, fejléc nélkül: a kliens maga intézi az engedélykérést.

Kliensenként

Kliens	Hol állítod be
Claude és Claude Code	A kliens saját MCP-beállításaiban. Kész blokk a Beállítások → Fejlesztőknek oldalon.
ChatGPT	A csatlakoztatók, illetve az alkalmazásbeállítások alatt.
Gemini CLI	A `~/.gemini/settings.json` fájl `mcpServers` kulcsa alatt, a címmel a `httpUrl` mezőben. A webes és mobilos Gemini-alkalmazás nem tud távoli MCP-szervert felvenni.
Egyéb MCP-kliens	Bármelyik, ami streamable HTTP átvitelt támogat, a fenti alakkal működik.

Kliensenkénti, lépésről lépésre leírást az AI-ügynökök oldal ad, terminálképekkel együtt.

Ellenőrzés

A legegyszerűbb próba: kérdezd meg az ügynöködtől, milyen csatornáid vannak. Ha felsorolja őket, a kapcsolat és a jogosultság is rendben van.

Ha a kliensed listázza az elérhető eszközöket, tíz eszközt kell látnod; a listát az Eszközreferencia oldal tartalmazza.

Ha nem csatlakozik

Tünet	Ok	Megoldás
401, vagy „nem sikerült hitelesíteni”	REST-kulcsot másoltál be MCP-kulcs helyett.	Készíts `psty_mcp_` kezdetű kulcsot a Beállítások → Fejlesztőknek oldalon.
401 helyes kulccsal	Hiányzik a `Bearer` előtag.	A fejléc értéke `Bearer psty_mcp_…` legyen.
403, „a csomag nem tartalmazza”	Az MCP a Pro csomagtól érhető el.	Lásd a Csomagok oldalt.
A kliens nem látja a szervert	Nem indult újra, vagy rossz fájlba került a beállítás.	Indítsd újra a klienst, és ellenőrizd, hogy a JSON érvényes-e.
Az ügynök nem lát csatornát	A kulcs másik munkaterülethez tartozik, vagy nincs bekötött csatorna.	Ellenőrizd a Csatornák oldalt, és hogy melyik munkaterületen készült a kulcs.

Hiányzik valami erről az oldalról? Írj a [email protected] címre, vagy használd a Segítség oldal űrlapját.