Ugrás a fő tartalomhoz
Was this helpful?

MCP Hosztok Csatlakoztatása

Ez az oldal gyakorlati csatlakozási mintákat mutat be a PrimeCal MCP-hez a May.B.Late demófelhasználóval.

Az oldalon lévő összes mintakimenet feltételezi, hogy mayblate felhasználóként csatlakoztál.

Csatlakozási módok​

A PrimeCal mindkét általános MCP átviteli stílust támogatja:

  • Streamable HTTP a https://<your-primecal>/api/mcp címre
  • STDIO a PrimeCal MCP stdio belépési szkriptjén keresztül

Hoszt-példányonként egy agens API kulcsot használj.

PrimeCal Cloud megjegyzés:

  • Frontend alkalmazás: https://app.primecal.eu
  • MCP/backend végpont: https://api.primecal.eu/api/mcp
  • Ne irányítsd a távoli MCP hosztokat a https://app.primecal.eu/api/mcp címre; az a hoszt az SPA keretét szolgálja ki, nem a backend API-t.
  • Ha a frontend az Azure Static Web Apps Free csomagján fut, az /api/* nem csatolható azon a frontend hosztán keresztül. Közvetlenül a backend hosztot használd, amíg az SWA-t Standard csomagra nem frissítik.

Chrome MCP (HTTP)​

Ezt akkor használd, ha a Chrome MCP kiterjesztésed/brid-ed támogatja a távoli HTTP MCP szervereket.

Mielőtt generálnád a hoszt konfigurációt a PrimeCal-ban, válaszd ki a hoszthoz legjobban illő legszűkebb jogosultsági csoportot:

  • Minimális füstteszteléshez és csak kontextus-alapú asszisztensekhez
  • Csak olvasható (teljes) naptárak, feladatok, foglalások és automatizálási állapot biztonságos böngészéséhez
  • Működési olvasás/írás csak akkor, ha a hosztnak tervezési adatokat kell létrehoznia vagy frissítenie
  1. Nyisd meg a Chrome MCP hoszt beállításait.
  2. Adj hozzá egy primecal nevű szervert.
  3. Állítsd a végpont URL-jét https://<your-primecal>/api/mcp értékre.
  4. Add hozzá a Authorization: Agent ag_sk_<token> fejlécet.
  5. Mentsd el és csatlakozz újra.
  6. Futtasd a tools/list parancsot, majd hívd meg a primecal_calendars_list eszközt.

Példa JSON blokk, amelyet sok Chrome MCP eszköz használ:

{
  "name": "primecal",
  "transport": "http",
  "url": "https://primecal.example.com/api/mcp",
  "headers": {
    "Authorization": "Agent ag_sk_your_token_here"
  }
}

Ha a kiterjesztésed eltérő mezőnevet használ (endpoint, serverUrl, authHeaders), tartsd meg ugyanazokat az értékeket, de rendeld hozzá az adott felhasználói felület mezőihez.

A PrimeCal egy nem érzékeny permissionGroup megjegyzést is küldhet a generált konfigurációban. Ezt kizárólag operátori metaadatként kezeld. A hosztnak továbbra is a PrimeCal által visszaadott, explicit hatókörű MCP képességekre kell támaszkodnia.

Claude Desktop (STDIO)​

Ezt akkor használd, ha helyi, asztali MCP-t szeretnél PrimeCal backend hozzáféréssel.

Előfeltételek:

  • PrimeCal backend függőségek telepítve
  • backend lefordítva (npm --prefix backend-nestjs run build)
  • érvényes PRIMECAL_MCP_AGENT_KEY

Példa claude_desktop_config.json bejegyzés:

{
  "mcpServers": {
    "primecal": {
      "command": "node",
      "args": [
        "/absolute/path/to/primecal_app1/backend-nestjs/dist/src/mcp-server/bin/primecal-mcp-stdio.js"
      ],
      "env": {
        "PRIMECAL_MCP_AGENT_KEY": "ag_sk_your_token_here",
        "DATABASE_URL": "postgres://...",
        "JWT_SECRET": "..."
      }
    }
  }
}

Fejlesztési alternatíva (build nélkül):

{
  "mcpServers": {
    "primecal": {
      "command": "npx",
      "args": [
        "ts-node",
        "-r",
        "tsconfig-paths/register",
        "src/mcp-server/bin/primecal-mcp-stdio.ts"
      ],
      "cwd": "/absolute/path/to/primecal_app1/backend-nestjs",
      "env": {
        "PRIMECAL_MCP_AGENT_KEY": "ag_sk_your_token_here"
      }
    }
  }
}

VS Code vagy Cursor​

A legtöbb VS Code/Cursor MCP integráció szintén elfogad HTTP MCP szerver definíciókat.

Ugyanazokat az értékeket használd, mint Chrome esetén:

  • URL: https://<your-primecal>/api/mcp
  • Auth fejléc: Authorization: Agent ag_sk_<token>

A Claude Code ugyanazt a távoli HTTP átviteli formátumot használja:

{
  "primecal": {
    "type": "http",
    "url": "https://api.primecal.eu/api/mcp",
    "headers": {
      "Authorization": "Agent ag_sk_your_token_here"
    }
  }
}

Kezdd az ellenőrzést a következőkkel:

  1. tools/list
  2. primecal_profile_get
  3. primecal_context_snapshot

Ellenőrzési lista (May.B.Late)​

Csatlakozás után ellenőrizd:

  • A primecal_profile_get visszaadja az timezone: Europe/Budapest értéket.
  • A primecal_calendars_list tartalmazza a Work, Personal, Side projects naptárakat.
  • A primecal_tasks_list visszaadja a beültetett feladatokat.
  • A tools/list megfelel a kiválasztott jogosultsági csoportnak. Például egy Csak olvasható (teljes) hoszt nem láthat létrehozó, frissítő, törlő vagy csak triggerként funkcionáló eszközöket.

Képernyőkép rögzítése​

Megismételhető képernyőképekhez (agens felhasználói felület, Chrome hoszt konfiguráció, eszközhívás kimenete, profil oldal) használd:

Ebben a tároló állapotban a PrimeCal felhasználói felület képernyőképei már be vannak csomagolva a docs/assets/agents/ könyvtárba. A Chrome hosztspecifikus képernyőképeket pontos rögzítési lépésekkel és célfájlnevekkel dokumentálja a runbook.