MCP Szerver

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 dolgozhass a fiókodban — taníthatod az AI ügynöködet, tudásbázis cikkeket írhatsz, kampány e-mail vázlatokat készíthetsz, kezelheted a beszélgetéseket és a ticketeket, és még sok mást, mindezt természetes nyelven.

Ugyanez a szerver hajtja a Vexet, az irányítópultba épített asszisztenst is, így egy külső AI alkalmazás és a Vex pontosan ugyanazokra képes.

Hogyan működik a hitelesítés

A Yaplet MCP szervere két hitelesítési módszert támogat. Mindkettőnél te döntöd el, mennyit tehet az AI.

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. Ezen az oldalon azt is kiválasztod:

• Mely területeken dolgozhat az alkalmazás — területenként egy jelölőnégyzet (widgetek, beszélgetések, ticketek, hírlevél, munkafolyamatok és így tovább). Csak azokat a területeket kínálja fel, amelyeket a jogosultságaid megengednek.
• Mit tehet az alkalmazás — a három hozzáférési szint egyikét (a bejelentkezési oldal angol nyelvű, ezért zárójelben az ott látható feliratot is megadjuk):

Az alkalmazás mindent a te nevedben, a te jogosultságaiddal tesz. Ha felfüggesztesz egy csapattagot, minden általa csatlakoztatott alkalmazás azonnal leáll, és újra működik, amint visszakapcsolod őt.

Az oldal azt is megmutatja, melyik alkalmazás szeretne csatlakozni, és hová kerülsz vissza a jóváhagyás után. A Yaplet nem ellenőrizte az alkalmazást, ezért csak akkor folytasd, ha a csatlakozást te magad indítottad. Ha a linkben ismeretlen alkalmazás vagy olyan visszatérési cím szerepel, amelyet az alkalmazás nem regisztrált, az oldal ehelyett ezt mutatja: This sign-in link is not valid, és nincs mit jóváhagyni.

API kulcs

Azon kliensekhez, amelyek nem támogatják az OAuth átirányítást (mint a Cursor vagy az Antigravity), API kulccsal is hitelesíthetsz. Generálj egyet a Beállítások → Szervezeti beállítások → API oldalon az irányítópulton, kapcsold be ott az AI hozzáférés (MCP) beállítását, majd add meg a kulcsot 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.

{
    "mcpServers": {
        "yaplet": {
            "command": "npx",
            "args": ["-y", "mcp-remote", "https://yaplet.com/api/mcp"]
        }
    }
}

{
    "mcpServers": {
        "yaplet": {
            "command": "npx",
            "args": ["-y", "mcp-remote", "https://yaplet.com/api/mcp", "--header", "Authorization:Bearer yAPI_your-api-key-here"]
        }
    }
}

claude mcp add --transport http yaplet https://yaplet.com/api/mcp

{
    "mcpServers": {
        "yaplet": {
            "type": "http",
            "url": "https://yaplet.com/api/mcp"
        }
    }
}

{
    "mcpServers": {
        "yaplet": {
            "type": "http",
            "url": "https://yaplet.com/api/mcp",
            "headers": {
                "Authorization": "Bearer yAPI_your-api-key-here"
            }
        }
    }
}

{
    "servers": {
        "yaplet": {
            "type": "http",
            "url": "https://yaplet.com/api/mcp"
        }
    }
}

{
    "servers": {
        "yaplet": {
            "type": "http",
            "url": "https://yaplet.com/api/mcp",
            "headers": {
                "Authorization": "Bearer yAPI_your-api-key-here"
            }
        }
    }
}

{
    "mcpServers": {
        "yaplet": {
            "url": "https://yaplet.com/api/mcp"
        }
    }
}

{
    "mcpServers": {
        "yaplet": {
            "url": "https://yaplet.com/api/mcp",
            "headers": {
                "Authorization": "Bearer yAPI_your-api-key-here"
            }
        }
    }
}

{
    "mcpServers": {
        "yaplet": {
            "serverUrl": "https://yaplet.com/api/mcp"
        }
    }
}

{
    "mcpServers": {
        "yaplet": {
            "serverUrl": "https://yaplet.com/api/mcp",
            "headers": {
                "Authorization": "Bearer yAPI_your-api-key-here"
            }
        }
    }
}

Hogyan dolgozik az AI a Yapletben

Az AI alkalmazásod kilenc eszközt lát. Nincs szüksége funkciónként külön eszközre: megkeresi a szükséges műveletet, aztán lefuttatja.

A find_actions mögött nagyjából 135 kis művelet áll, mindegyik egy olyan dolog, amit egy mondatban kérnél — Update ticket, Clock in, Write article with AI (a műveletek neve minden nyelven angol). Mindegyiknek van egy azonosítója, például tickets.update, és mindegyik a három fajta egyike, amelyek a három hozzáférési szintnek felelnek meg:

Az az alkalmazás, amely a művelethez szükségesnél alacsonyabb szinten csatlakozott, meg sem kapja a hozzá tartozó futtató eszközt, és a find_actions megmondja neki, melyik szint hiányzik. Egyes műveletek AI-jal írnak szöveget; ezeknél jelöljük, hogy AI krediteket használnak.

Műveletek területenként

Minden oldal felsorolja a terület összes műveletét, hogy mit csinálnak, és mit nem tehet ott egy AI.

Hogyan fut le egy feladat

Semmit nem kell levezényelned — írd le, mit szeretnél, és az AI végigviszi.

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 egy súgócikket ugyanerről”, az AI megkeresi az AI ügynöködet, hozzáadja és indexeli a dokumentumot, majd megírja és közzéteszi a cikket — mindezt egyetlen kérésből.

Amit egy AI soha nem tehet meg

Néhány dolog minden kapcsolatban emberi kézben marad — a Vexben, a böngészős bejelentkezéseknél és az API kulcsoknál egyaránt. Az AI elmagyarázhatja ezeket, és a megfelelő irányítópult-oldalra irányíthat, de nem végezheti el őket, akkor sem, ha kéred:

• Pénz: a csomagod, a kiegészítők, a bankkártya, a kreditfeltöltés, a telefonszámok, a dedikált IP. A szervezet tulajdonosaként csatlakoztatott AI elolvashatja a kreditegyenleget és a jelenlegi csomagot, de bármelyik módosítása emberi kézben marad.
• Hozzáférés: csapattagok, meghívások, jogosultságok, a tagok órabére, API kulcsok, integrációk.
• A fiók: adatexport, a fiók törlése, az adatfeldolgozási megállapodás aláírása.
• E-mail a feliratkozóidnak és nyilvános bejegyzések: egy AI soha nem küld el, nem ütemez és nem folytat kampányt, nem kapcsol be e-mail automatizációt, nem hagy jóvá Hírlevél Autopilot számot, nem kapcsolja ki egy autopilot Jóváhagyásom szükséges beállítását, és nem kapcsol be olyat, amely jóváhagyás nélkül küld, és soha nem tesz közzé közösségimédia-bejegyzést. Elkészíti a vázlatot, és megmondja, hol küldheted el vagy kapcsolhatod be.
• Chat munkafolyamat bekapcsolása: egy AI csak kikapcsolt munkafolyamatokat hoz létre és módosít. Egy munkafolyamatot kikapcsolhat, de soha nem kapcsol be, és egy bekapcsolt munkafolyamat módosítását elutasítjuk — az AI-nak előbb ki kell kapcsolnia, vagy le kell másolnia, és a másolatot módosítania. Egy munkafolyamatot te kapcsolsz be az irányítópulton. Egy AI elindíthat egy már bekapcsolt munkafolyamatot egy látogató beszélgetésében, de ezzel nem kapcsolja be mindenkinek.
• Az AI által választott címre küldött e-mail és egy látogató adatainak törlése: egy látogatónak vagy egy ticket bejelentőjének küldött e-mail csak az illető mentett címére megy, soha olyanra, amelyet egy AI választott vagy egy üzenetben olvasott. Egy látogató adatainak törlése a szervezet tulajdonosánál marad, a Beérkezettben.

A törlés is korlátozott: egyszerre egy, név szerint megadott elem, és az AI-nak meg kell ismételnie az elem pontos nevét, így egy rossz azonosítót elutasítunk. Munkafolyamatot csak kikapcsolt állapotban lehet törölni. Egy AI soha nem töröl tömegesen szűrő alapján, soha nem töröl márkát, widgetet, tudásbázist, dokumentációt vagy táblát, és soha nem töröl feliratkozót.

Adatvédelem és biztonság

• Minden kérés hitelesített, és egyetlen szervezetre korlátozódik.
• Minden kapcsolat egy személy nevében fut, és csak azt teheti, amit ennek a személynek a jogosultságai most megengednek az irányítópulton. Egy tag felfüggesztése azonnal leállítja neki a Vexet, az általa csatlakoztatott alkalmazásokat és az általa bekapcsolt API kulcsokat.
• Minden módosítás, törlés és küldés, amit egy AI végez, bekerül az Audit napló oldalra AI módosítás vagy AI törlés vagy küldés néven, a személlyel, a kapcsolattal (a Vexnél copilot, az alkalmazás neve vagy az API kulcs neve), a művelettel és az elemmel együtt. Az elküldött értékeket nem tároljuk ott. Az olvasásokat nem naplózzuk.
• A böngészős bejelentkezéssel csatlakozott alkalmazások nem látnak és nem írnak belső jegyzetet a beszélgetésekben; a Vex és az API kulcsos kapcsolatok igen.
• Azok az eredmények, amelyek kívülállók által írt szöveget tartalmaznak — például látogatói üzeneteket, kérdőívválaszokat vagy beolvasott weboldalakat —, azzal a megjegyzéssel jutnak el az AI-hoz, hogy ezek adatok, soha nem utasítások.