MCP Szerver
Kapcsold össze kedvenc AI eszközeidet — Claude Desktop, VS Code, Cursor, Windsurf, Claude Code és még több — a Yaplethez a Model Context Protocol segítségével. Kezeld az egész fiókodat természetes párbeszéden keresztül.
Mi az MCP?
A Model Context Protocol (MCP) egy nyílt szabvány, amely lehetővé teszi az AI asszisztenseknek, hogy külső szolgáltatásokhoz csatlakozzanak és azok eszközeit használják. A Yaplet MCP szervert biztosít, hogy bármilyen MCP-kompatibilis kliensből kezeld a fiókodat — taníthatod az AI ügynöködet, tudásbázis cikkeket írhatsz, kampány e-maileket küldhetsz, kezelheted a beszélgetéseket és még sok mást, mindezt természetes nyelven.
Hogyan működik a hitelesítés
A Yaplet MCP szervere két hitelesítési módszert támogat:
OAuth 2.0 (Böngészős bejelentkezés)
Az alapértelmezett módszer. Csak add hozzá a szerver URL-t a kliensedhez — csatlakozáskor a böngésződ megnyit egy bejelentkezési oldalt, ahol bejelentkezhetsz a Yaplet-fiókodba, kiválaszthatod a szervezetedet, és jóváhagyhatod a hozzáférést. Minden műveletet a személyes felhasználói fiókodhoz kötnek, és kiválaszthatod, melyik eszköz kategóriákhoz adod meg a hozzáférést.
API kulcs
Azon kliensekhez, amelyek nem támogatják az OAuth átirányítást (mint a Cursor vagy az Antigravity), a szervezeted API kulcsával is hitelesíthetsz. Generálj egyet a Beállítások → Szervezeti beállítások → API oldalon az irányítópulton, majd add meg Bearer tokenként az MCP konfigurációd Authorization fejlécében.
Beállítási útmutatók
A Yaplet MCP szervere a következő címen érhető el:
https://yaplet.com/api/mcp
A Streamable HTTP transzportot használja — az aktuális MCP szabvány. Válaszd ki a kliensedet az alábbi beállítási utasításokhoz.
A Claude Desktop a Connectors funkcióján keresztül támogatja a távoli MCP szervereket automatikus böngészős bejelentkezéssel.
Beállítások megnyitása
A Claude Desktopban menj a Beállítások > Connectors menüpontba.
Új connector hozzáadása
Kattints az Add Connector gombra, és konfiguráld:
- Név: Yaplet
- URL:
https://yaplet.com/api/mcp
Bejelentkezés
A böngésződ automatikusan megnyílik. Jelentkezz be a Yaplet-fiókoddal, válaszd ki a szervezetedet, és hagyd jóvá a hozzáférést. Ennyi — nincs szükség API kulcsra.
Kezdd el használni
Nyiss egy új beszélgetést, és látni fogod a Yaplet eszközeit. Írd be például: „Listázd a widgetjeimet” a kapcsolat ellenőrzéséhez.
mcp-remote hidat használhatod alternatívaként. Add hozzá ezt a claude_desktop_config.json fájlhoz:{
"mcpServers": {
"yaplet": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://yaplet.com/api/mcp"]
}
}
}
Az mcp-remote megnyit egy böngészőablakot a bejelentkezéshez.
{
"mcpServers": {
"yaplet": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://yaplet.com/api/mcp", "--header", "Authorization:Bearer yAPI_your-api-key-here"]
}
}
}
Konfigurációs fájl helye:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
A Claude Code natívan támogatja a távoli MCP szervereket. Csak add hozzá az URL-t, és a hitelesítést a böngésződön keresztül kezeli.
A lehetőség: CLI parancs
Futtasd ezt a terminálon:
claude mcp add --transport http yaplet https://yaplet.com/api/mcp
Az eszközök első használatakor a böngésződ megnyílik a bejelentkezéshez és a hozzáférés jóváhagyásához.
B lehetőség: Projekt konfigurációs fájl
Hozd létre vagy szerkeszd a .mcp.json fájlt a projekt gyökerében:
{
"mcpServers": {
"yaplet": {
"type": "http",
"url": "https://yaplet.com/api/mcp"
}
}
}
C lehetőség: API kulcs
Ha a böngészős bejelentkezés nem működik, használj API kulcsot. Hozd létre vagy szerkeszd a .mcp.json fájlt a projekt gyökerében:
{
"mcpServers": {
"yaplet": {
"type": "http",
"url": "https://yaplet.com/api/mcp",
"headers": {
"Authorization": "Bearer yAPI_your-api-key-here"
}
}
}
}
Ellenőrzés
Írd be /mcp-t a Claude Code chat panelben a csatlakoztatott szerverek megtekintéséhez, és ellenőrizd, hogy a Yaplet szerepel-e.
A VS Code támogatja az MCP szervereket a GitHub Copilot Agent módjához.
MCP beállítások megnyitása
Nyisd meg a Command Palette-t (Ctrl+Shift+P / Cmd+Shift+P), és futtasd az MCP: Open User Configuration parancsot.
Alternatívaként hozd létre vagy szerkeszd a .vscode/mcp.json fájlt a munkaterületen a projekt-hatókörű konfigurációhoz.
Yaplet hozzáadása
Add ezt a mcp.json fájlhoz:
{
"servers": {
"yaplet": {
"type": "http",
"url": "https://yaplet.com/api/mcp"
}
}
}
Az eszközök első használatakor a böngésződ megnyílik a bejelentkezéshez és a hozzáférés jóváhagyásához.
headers mezőt:{
"servers": {
"yaplet": {
"type": "http",
"url": "https://yaplet.com/api/mcp",
"headers": {
"Authorization": "Bearer yAPI_your-api-key-here"
}
}
}
}
Váltás Agent módra
A Copilot Chatben váltj Agent módra (kattints a mód legördülőre a chat panel tetején). Az MCP eszközök csak Agent módban érhetők el.
Kezdd el használni
Kérdezz a Copilottól valamit, például: „Listázd a Yaplet chatbotjaimat”, és az MCP eszközöket fogja használni.
A Cursor beépített MCP támogatással rendelkezik, globális és projekt-szintű konfigurációval.
MCP beállítások megnyitása
Nyisd meg a Command Palette-t (Ctrl+Shift+P / Cmd+Shift+P), és válaszd a View: Open MCP Settings lehetőséget. Vagy menj a Beállítások > Features > MCP Servers menüpontba.
Yaplet hozzáadása
Hozd létre vagy szerkeszd a .cursor/mcp.json fájlt a projekt gyökerében (vagy ~/.cursor/mcp.json globális hozzáféréshez):
{
"mcpServers": {
"yaplet": {
"url": "https://yaplet.com/api/mcp"
}
}
}
Az eszközök első használatakor a böngésződ megnyílik a bejelentkezéshez és a hozzáférés jóváhagyásához.
{
"mcpServers": {
"yaplet": {
"url": "https://yaplet.com/api/mcp",
"headers": {
"Authorization": "Bearer yAPI_your-api-key-here"
}
}
}
}
Cursor újraindítása
Indítsd újra teljesen a szerkesztőt az új szerver betöltéséhez.
Ellenőrzés
Ellenőrizd a Beállítások > Features > MCP Servers menüpontban, hogy a Yaplet csatlakoztatottként jelenik-e meg.
A Windsurf az MCP szervereket a Cascade AI panelen keresztül támogatja.
MCP konfiguráció megnyitása
Kattints az MCPs ikonra a Cascade panel jobb felső sarkában, és válaszd a Configure lehetőséget. Ez közvetlenül megnyitja a konfigurációs fájlt.
Alternatívaként szerkeszd kézzel a fájlt:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
Yaplet hozzáadása
{
"mcpServers": {
"yaplet": {
"serverUrl": "https://yaplet.com/api/mcp"
}
}
}
Az első csatlakozáskor a böngésződ megnyílik a bejelentkezéshez és a hozzáférés jóváhagyásához.
headers mezőt:{
"mcpServers": {
"yaplet": {
"serverUrl": "https://yaplet.com/api/mcp",
"headers": {
"Authorization": "Bearer yAPI_your-api-key-here"
}
}
}
}
Windsurf újraindítása
Indítsd újra a szerkesztőt az új szerverhez való csatlakozáshoz.
Ellenőrzés
Nyisd meg a Cascade panelt, és ellenőrizd az MCPs ikont, hogy a Yaplet csatlakoztatva van-e.
https://yaplet.com/api/mcp címre — a kliens automatikusan kezeli az OAuth bejelentkezést. Ha a kliens nem támogatja az OAuth átirányítást, add meg az API kulcsodat Bearer tokenként az Authorization fejlécben.Elérhető eszközök
Az MCP szerver 32 eszközt tesz elérhetővé, tíz kategóriába szervezve. Minden kategória ahhoz az irányítópulti funkció jogosultsághoz kapcsolódik, amely szabályozza — így egy kategória csak akkor jelenik meg, ha az adott jogosultságod megvan.
Adathozzáférés
Böngéssz és vizsgálj bármilyen erőforrást a szervezetedben — widgetek, chatbotok, beszélgetések, kontaktok és még sok más.
Widget eszközök
Hozz létre és konfigurálj chat widgeteket, és generáld a telepítési kódjukat. A Márkák és chat widgetek jogosultság szabályozza.
Chatbot eszközök
Konfiguráld a márka AI ügynökét, adj hozzá tudásdokumentumokat, és diagnosztizálj válaszproblémákat. A beállításokat és a diagnosztikát a Vex AI, a tudásdokumentumokat a Tartalomforrások jogosultság szabályozza.
Termék eszközök
Kösd be a katalógusokat, ahonnan a termékeid érkeznek, és kezeld a kötelező érvényű szabályokat, amiket az AI-nak követnie kell, amikor róluk beszél. A Tartalomforrások jogosultság szabályozza.
Segítség eszközök
Kezeld a tudásbázisokat (HTML cikkek) és dokumentációs portálokat (Markdown oldalak). Hozz létre tartalmat AI-val, szervezd kategóriákba, és ellenőrizd a közzétételt.
Beszélgetés eszközök
Olvasd a chat üzeneteket, keress a beszélgetésekben, rendelj chateket ügyintézőkhöz, és küldj válaszokat vagy privát megjegyzéseket.
Jegy eszközök
Kezeld a táblák jegyeit — hozz létre újakat, mozgasd őket oszlopok és táblák között, rendeld hozzá valakihez, címkézd, priorizáld, írj belső megjegyzést, küldj e-mailt a bejelentőnek, archiválj és törölj.
Hírlevél eszközök
Készíts e-mail kampány vázlatokat AI tartalommal, építs e-mail automatizálásokat, kezeld a feliratkozókat, és ellenőrizd az e-mail teljesítményt.
Elköteleződés eszközök
Készíts banner-, felmérés-, termékbemutató-, chat üzenet- és hírvázlatokat célzási szabályokkal.
Hogyan működnek együtt az eszközök
A legtöbb feladat több, egymást követő eszközt igényel. Ezt nem kell kézzel összehangolnod — csak írd le, mit szeretnél, és az AI elvégzi a többit.
Felfedezés
Az AI a meglévő erőforrások listázásával kezd (list_records), hogy azonosítókat találjon és megértse, mi van már beállítva.
Vizsgálat
Szükség esetén lekéri egy adott erőforrás teljes részleteit (get_record) az aktuális konfiguráció ellenőrzéséhez.
Cselekvés
A megfelelő kezelő eszközt használja az erőforrások létrehozásához, frissítéséhez vagy konfigurálásához. Minden kezelő eszköz ugyanazt a mintát követi: hagyd el az id-t létrehozáshoz, add meg az id-t frissítéshez.
Elrendezés
Végül a helyükre teszi a darabokat — cikket kategóriához rendel, ticketet oszlopba mozgat, vagy közzétesz egy súgócikket.
Példa: Ha azt kéred: „Adj hozzá egy dokumentumot a visszatérítési szabályzatunkról az AI ügynököm tudásához, és írj róla egy súgócikket is”, automatikusan megkeresi az AI ügynököd, megírja és indexeli a dokumentumot, majd megírja és közzéteszi a cikket — mindezt egyetlen promptból.
Adatvédelem és biztonság
- Minden kérés hitelesített és a szervezetedre hatáskörű.
- Az OAuth tokenek a bejelentkezéskor jóváhagyott jogosultságokra vannak korlátozva. A műveletek a személyes felhasználói fiókodhoz köthetők.
- Az API kulcsos kapcsolatok szervezet tulajdonosként működnek, hozzáféréssel az összes engedélyezett Copilot eszköz kategóriához — kategóriánkénti hatáskör-korlátozás nélkül.
- A külső hívók (OAuth) nem láthatják a privát ügyintézői megjegyzéseket a beszélgetésekben. Az API kulcsos hívóknak teljes hozzáférésük van, beleértve a privát megjegyzéseket is.
- Minden műveletet naplóznak, és a hitelesített felhasználóhoz köthetők.