AI Agensek (MCP) – Áttekintés
A PrimeCal szabványoknak megfelelő Model Context Protocol (MCP) szervert tartalmaz, amelyen keresztül az AI eszközök naptárakat, feladatokat, automatizálásokat, profilkontextust és vállalati foglalási adatokat olvashatnak és frissíthetnek – egyetlen integrációs felületen keresztül.
- MCP specifikáció: modelcontextprotocol.io/docs/getting-started/intro
- PrimeCal streamable HTTP végpont:
POST/GET/DELETE /api/mcp - PrimeCal STDIO belépési pont asztali hosztokhoz:
backend-nestjs/src/mcp-server/bin/primecal-mcp-stdio.ts
PrimeCal Cloud esetén használd a https://api.primecal.eu/api/mcp URL-t távoli MCP URL-ként.
A https://app.primecal.eu hoszt a frontend alkalmazás keretét szolgálja ki.
Az Azure Static Web Apps Free csomagban a csatolt /api/* backend nem érhető el a frontend hosztján keresztül, így a frontend hoszt nem használható MCP origóként.
Mit ad a PrimeCal MCP?
- Eszközök (Tools) a következőkhöz:
- naptáresemények és személycsoportok
- feladatok, címkék és emlékeztetők
- automatizálási szabályok és audit pillanatképek
- profil- és kontextuspillanatképek
- szervezetek, erőforrástípusok, erőforrások, elérhetőség és foglalások
- Erőforrások (Resources) csak olvasható kontextuscsomagokhoz:
primecal://current-contextprimecal://automation-summary
- Részletes adattartalmak, hogy a hosztok teljes kontextust kapjanak, ne csak azonosítókat.
A PrimeCal nem teszi elérhetővé a Stripe titkokat, a Checkout létrehozását vagy a webhook kezelést MCP-n keresztül a jelenlegi foglalási verzióban.
Elérhetőség és biztonság
A PrimeCal MCP alapvető képesség.
- Nincs feature flag az MCP bekapcsolásához.
- Az MCP minden esetben elérhető, ha a PrimeCal érvényes MCP konfigurációval fut.
- A biztonságot a következők garantálják:
- agensprofilok
- hatókörrel korlátozott jogosultságok
- agens API kulcsok
- szervezeti és erőforrástípus-hatókörök a foglalási eszközökhöz
Vállalati foglalási támogatás
A foglalástudatos MCP agensek képesek:
- listázni az elérhető szervezeteket
- biztonságosan váltani az aktív szervezetet
- listázni az erőforrástípusokat és konkrét erőforrásokat
- kiszámítani az elérhetőséget foglalási és blokkoló naptár logikával
- nem fizetéses foglalási folyamatokat létrehozni, ahol az engedélyezett jogosultságok ezt lehetővé teszik
A PrimeCal a fizetési határt külön tartja. Ha egy foglalás Stripe fizetést igényel, az MCP nem hozza létre és nem fejezi be azt a fizetési folyamatot az agens számára.
Kanonikus demófelhasználó: May.B.Late
Az ebben a szekcióban lévő összes útmutató a May.B.Late nevű mintafelhasználót alkalmazza.
Elvárt beültetett profil:
- Felhasználónév:
mayblate - Naptárak:
Work,Personal,Side projects - Feladatcímkék és feladatok már léteznek
- Legalább egy engedélyezett automatizálási szabály
- Profilbeállítások MCP demókhoz hangolva (időzóna, időformátum, téma)
Lásd: Agens konfigurálása a PrimeCal-ban, MCP hosztok csatlakoztatása és Vállalati foglalási eszközök MCP-hez a teljes folyamathoz.
Valódi felhasználói felület referencia
