AI asszisztens (MCP)

A CongPlan összeköthető egy AI asszisztenssel az MCP-felületen (Model Context Protocol) keresztül. Ez lehetővé teszi, hogy tervezési kérdéseket tegyél fel egyszerű nyelven, vagy bejegyzéseket diktálj, ahelyett hogy menükön kattintanál végig. Az asszisztens ugyanazokat az adatokat olvassa és írja, mint az alkalmazás, így minden művelet ugyanazokon a jogosultsági ellenőrzéseken, ütközésvizsgálatokon és naplózáson megy keresztül.

Nyílt szabvány

Az MCP egy nyílt szabvány, így a kapcsolat bármely MCP-képes asszisztenssel működik. A CongPlan gyülekezetenként egy MCP-végpontot biztosít, és OAuth 2.1-et használ a jogosultság-ellenőrzéshez. Ha a klienses megoldásod támogatja az OAuth-ot, csupán a végpont URL-jével kapcsolódhatsz, és a CongPlanen keresztül jelentkezel be — token nem szükséges. Személyes hozzáférési tokenre csak akkor van szükség, ha a kliens nem támogatja az OAuth-ot, vagy ha statikus, hosszú élettartamú hitelesítő adatra van szükséged.

Mielőtt elkezdenéd

Az MCP-hozzáférés alapértelmezetten ki van kapcsolva. Két lépés szükséges, mielőtt használatba vennéd:

1. Egy adminisztrátor engedélyezi az MCP-felületet a gyülekezet számára (az adminisztrátori beállításokban).
2. Egy adminisztrátor hozzáférést ad neked, hogy csatlakoztathass egy asszisztenst — akár OAuth-bejelentkezéssel, akár egy személyes token létrehozásával. Ha még nincs hozzáférésed, kérheted azt az MCP képernyőn.

Az asszisztensed csatlakoztatása

A CongPlan MCP-végpontja https://my.congplan.app/api/mcp.

Claude.ai / Claude Desktop

1. Nyisd meg a Claude-fiókod beállításait (a csomagodtól függően Settings vagy Customize néven), és keresd meg a Connectors > Add custom connector menüpontot.
2. Illeszd be az alábbi végpont URL-t. A Claude böngészőt nyit a CongPlanen keresztüli bejelentkezéshez, és automatikusan befejezi az OAuth-kapcsolatot — token nem szükséges.

https://my.congplan.app/api/mcp

Claude Code CLI

# OAuth (recommended): opens a browser to log in to CongPlan
claude mcp add --transport http congplan https://my.congplan.app/api/mcp

# Personal access token (fallback for non-interactive/CI use)
claude mcp add --transport http congplan https://my.congplan.app/api/mcp \
  --header "Authorization: Bearer cpm_your_token_here"

ChatGPT (egyéni connector)

1. A ChatGPT-ben nyisd meg a Settings menüt, és keresd meg a Connectors pontot (a pontos elnevezés a csomagtól vagy az alkalmazás verziójától függően eltérhet); válaszd egy új connector hozzáadását vagy létrehozását.
2. Illeszd be a végpont URL-t, és fejezd be az OAuth-bejelentkezést. Token nem szükséges — a ChatGPT connectorai közvetlenül támogatják az OAuth-ot.

Általános mcp.json (Cursor, Windsurf stb.)

Azok a kliensek, amelyek az MCP-szerverlistájukat egy mcp.json fájlból olvassák, mindkét kapcsolattípust támogatják — használj OAuth-ot, ha a kliens támogatja, egyébként bearer tokent:

{
  "mcpServers": {
    "congplan-oauth": {
      "url": "https://my.congplan.app/api/mcp"
    },
    "congplan-token": {
      "url": "https://my.congplan.app/api/mcp",
      "headers": {
        "Authorization": "Bearer cpm_your_token_here"
      }
    }
  }
}

Kérd meg az asszisztensedet, hogy állítsa be magát

Sok asszisztens képes önmaga beállítani a kapcsolatot, ha beillesztesz egy rövid utasítást:

Add the CongPlan MCP server at https://my.congplan.app/api/mcp using OAuth.
If OAuth isn't supported, ask me for a personal access token and use it as an
Authorization: Bearer header instead.

Személyes hozzáférési tokenek

Csak akkor van szükséged tokenre, ha a klienses megoldásod nem tud OAuth-ot használni, vagy hosszú élettartamú hitelesítő adatra van szükséged.

Amint van hozzáférésed, hozz létre egy személyes tokent a fiókbeállításaidban:

1. Nyisd meg az Én > Integrációk oldalt.
2. Válaszd a Token létrehozása lehetőséget.
3. Adj a tokennek egy nevet, válaszd ki a használható hatóköröket (scopes), és adj meg egy lejáratot (legfeljebb 90 nap).
4. Másold ki azonnal a tokent — csak egyszer jelenik meg, és később nem kérhető le újra.

Használd a tokent a választott MCP-képes asszisztensben, hogy összekösd azt a gyülekezeteddel.

Hatókörök (Scopes)

A hatókörök (scopes) pontosan meghatározzák, mit tehet meg egy token. Területenként olvasásra és írásra vannak felosztva, például:

• Olvasás — gyülekezeti profil, hírnökök, szántóföldi csoportok, összejövetelek, feladatok (beleértve a technikai feladatokat), szántóföldi összejövetelek, teendők, közterületi tanúskodás, kimenő nyilvános előadások és (érzékeny adatként) távollétek.
• Írás — teendők, szántóföldi összejövetelek, feladatok, összejövetelek, közterületi tanúskodás, valamint a saját átadási kérelmeid vagy feliratkozásaid.

Csak azokat a hatóköröket add meg, amelyekre ténylegesen szükséged van. Egy token bármikor visszavonható.

Név alapú kérések

Amikor megkéred az asszisztenst, hogy megnevezett hírnökökkel kapcsolatban tegyen valamit, például „rögzíts egy távollétet Lindának és Timnek”, először fel kell oldania ezeket a neveket a CongPlan belső hírnök-azonosítóira. Add meg a Hírnökök olvasása hatókört a hozzáillő írási hatókörrel együtt, például a Távollétek írása hatókörrel, hogy az asszisztens megkereshesse azokat a személyeket, akiket módosítania kell.

Ha a hírnök-olvasási hatókör hiányzik, az asszisztens nem tudja biztonságosan megtalálni a megfelelő személyt. Ilyenkor meg kell kérnie téged, hogy add hozzá ezt a hatókört, vagy add meg a pontos azonosítókat. Ha egy név hiányzik, vagy több hírnökre is illik, tisztázást kell kérnie ahelyett, hogy találgatna.

Példakérések

Amit mondasz, az asszisztenstől függ, de a tipikus kérések így néznek ki:

• „Ki van beosztva a jövő heti heti összejövetelen?”
• „Mely részek nincsenek még beosztva a július 14-i hétvégi összejövetelen?”
• „Milyen összejövetelek vannak tervezve a jövő héten?”
• „Írd be Miller testvért előadóként a július 14-i nyilvános előadásra.”
• „Hozz létre egy teendőt: ellenőrizni a mikrofonokat a szombati hétvégi összejövetelre.”
• „Mutasd meg az e heti összes szántóföldi összejövetelt vezetővel és találkozási hellyel.”
• „Kinek van mikrofon- vagy hang-/videószolgálata ezen a hétvégén?”
• „Melyik előadónknak van kimenő nyilvános előadása a jövő hónapban?”
• „Hozd létre a hétvégi összejövetelt augusztus 16-ra.”

Az asszisztens javasolja a műveletet; a mentés ugyanazokon az utakon történik, mint egy kézi bejegyzésnél, beleértve a jogosultsági és ütközésellenőrzést is. Ha megkéred, hogy hozzon létre egy új összejövetelt, a CongPlan automatikusan alkalmazza a megfelelő programsablont — ugyanazt, amelyet kézi létrehozáskor is kapnál —, így az összejövetel nem indul üresen. Ha nincs illeszkedő sablon (vagy kifejezetten üres összejövetelt kérsz), akkor program nélkül jön létre.

Alapértelmezetten anonimizálva

Az MCP-felület a hírnökök belső azonosítóit adja át az asszisztensednek, nem a neveket. A tervezés, a statisztikák és a jogosultsági ellenőrzések mind ezeken az azonosítókon futnak. Amikor az asszisztens a terhelés kiegyenlítése érdekében megnézi, ki kapott beosztást a közelmúltban, ezt a történetet anonimizáltan értékeli ki, anélkül hogy látná, kik is ezek a személyek.

A nevek csak a legvégén oldódnak fel, a neked megjelenő válasz számára, és csak azoknál a keveseknél, akiket a válasz ténylegesen megemlít. Ez a keresés egy külön lépés, amelyhez a Hírnökök olvasása hatókör szükséges, és semmi mást nem ad vissza, csak a lekérdezett azonosítókhoz tartozó megjelenítendő neveket, teljes lista és további részletek nélkül. Enélkül a hatókör nélkül az asszisztens továbbra is az azonosítókkal dolgozik, csak nem tud hozzájuk nevet rendelni.

Jogosultságok és biztonság

• Az asszisztens csak azt teheti meg, amit a te szerepköröd és az OAuth- vagy token-hatóköreid engednek — ugyanazok a gyülekezeti elkülönítési és jogosultsági szabályok érvényesek, mint az alkalmazásban.
• Minden művelet rögzítésre kerül a naplóban (audit log).
• A tokenek személyesek. Kezeld úgy egy tokent, mint egy jelszót, és vond vissza, ha már nincs rá szükség.

Kapcsolódó

• Jogosultságok
• Teendők