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 — chatbotokat hozhatsz létre, 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 > API Beállítások menüpontban 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 20 eszközt tesz elérhetővé, nyolc kategóriába szervezve. Minden kategória egy jogosultsághoz kapcsolódik, amely egyenként engedélyezhető vagy letiltható.
Adathozzáférés
Böngéssz és vizsgálj bármilyen erőforrást a szervezetedben — widgetek, chatbotok, beszélgetések, névjegyek és még sok más.
Widget eszközök
Hozz létre és konfigurálj chat widgeteket, generálj telepítési kódot, és kapcsolj össze erőforrásokat, mint chatbotok és tudásbázisok.
Chatbot eszközök
Állíts be AI chatbotokat, adj hozzá tudás dokumentumokat, és diagnosztizálj válasz problémákat.
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-jal, 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.
Hírlevél eszközök
Hozz létre e-mail kampányokat AI tartalommal, építs automatizálási munkafolyamatokat, és ellenőrizd az e-mail teljesítményt.
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.
Összekapcsolás
Végül összekapcsolja az erőforrásokat — chatbotot widgethez kapcsol, cikket kategóriához rendel, vagy tartalmat tesz közzé.
Példa: Ha azt kéred: „Hozz létre egy Szupport Bot nevű chatbotot, és kapcsold a fő widgetemhez", automatikusan listázza a widgeteket, létrehozza a chatbotot, és összekapcsolja — 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.