MCP-szerver¶

Bekapcsolt MCP-szerverrel az Odoo-adatbázisod összekapcsolható olyan külső AI-alkalmazásokkal, amelyek a Model Context Protocolt beszélik, például a Claude-dal, a ChatGPT-vel vagy egy AI-képes kódszerkesztővel. Az alkalmazás ezután kereshet és olvashat abban az adatban, amelyet a felhasználója lát az Odoo-ban, és megerősítéssel módosításokat javasolhat, mégpedig abból az alkalmazásból, amelyet a személy amúgy is használ.

Megjegyzés

Ez az ellenkező irány az AI ‣ Konfiguráció ‣ Szolgáltatók ‣ MCP szerverek menüponthoz képest, ahol az Odoo más szerverek eszközeit hívja (lásd: Konfiguráció). Itt az Odoo a szerver.

A szerver bekapcsolása¶

Telepítsd az AI MCP Gateway modult (és a portálfelhasználókhoz az AI MCP Gateway - Portal modult).
Nyisd meg az AI ‣ Konfiguráció ‣ Beállítások oldalt, keresd meg az MCP szerver blokkot, és kapcsold be. A beállítás alapértelmezés szerint ki van kapcsolva.
Másold ki a címet az MCP szerver URL mezőből. Ez az Odoo címed, utána /mcp, és ezt illeszted be az AI-alkalmazásba.

Fontos

Az AI-alkalmazások bejelentkezési süti nélkül hívják a szervert, ezért az Odoo-nak pusztán a gazdagépnévből ki kell választania ezt az adatbázist. Ha a szerver több adatbázist szolgál ki, állítsd be a dbfilter beállítását úgy, hogy ez a gazdagépnév csak ezt az adatbázist válassza ki (például ^%d$ aldomainenként egy adatbázissal), vagy egyetlen adatbázist szolgálj ki. Ha ez nem teljesül, a beállítások oldal figyelmeztetést mutat, az alkalmazások pedig „404 Not Found” választ kapnak.

AI-alkalmazás csatlakoztatása¶

Az AI-alkalmazásban adj hozzá egy egyéni összekötőt vagy MCP-szervert, és illeszd be a szerver URL-jét.
Az alkalmazás megnyit egy Odoo-bejelentkezési oldalt. Jelentkezz be a saját fiókoddal. Csak az AI: Felhasználó csoportba tartozó belső felhasználók csatlakozhatnak, és a csoporttagságot minden kérésnél újra ellenőrzi a rendszer.
Egy hozzájárulási oldal megmondja, melyik alkalmazás szeretne csatlakozni, mire lesz képes (Csak olvasás vagy Olvasás és módosítások javaslása), és mely eszközöket használhatja. Kattints az Engedélyezés vagy a Tiltás gombra. A hozzájárulást a rendszer minden csatlakozáskor megkérdezi.

A háttérben a kapcsolat OAuth 2.1-et használ PKCE-vel. A hozzáférési tokenek rövid életűek, a frissítő tokenek minden használatkor cserélődnek; csak a hash-ek tárolódnak. A szkriptelt kliensek alternatívaként Odoo API-kulcsot is használhatnak bearer tokenként, ha az Odoo API-kulcsok elfogadása be van kapcsolva.

Csatlakoztatott alkalmazások és lecsatlakoztatás¶

Minden felhasználó a saját kapcsolatait a Beállításaim oldalán, a Csatlakoztatott AI-alkalmazások lapon látja, a csatlakozás és az utolsó használat dátumával. A Lecsatlakoztatás azonnal érvényesül.

Az adminisztrátorok az összes kapcsolatot az AI ‣ Konfiguráció ‣ MCP szerver ‣ Csatlakoztatott AI-alkalmazások menüben (Hozzáférés visszavonása gombbal), a regisztrált alkalmazásokat pedig az AI ‣ Konfiguráció ‣ MCP szerver ‣ AI-alkalmazások menüben látják. Egy frissítő token visszavonása az egész kapcsolatot visszavonja.

Mely eszközök érhetők el¶

A szerver nem adja át mindazt, amire az asszisztens képes. Egy engedélyezett eszközlistát kínál, amelyekről tudható, hogy tiszteletben tartják a megerősítést, a felhasználó saját képességei szerint szűrve:

Olvasás és keresés: rekordok keresése, olvasása, csoportosítása és összesítése, mezők leírása, modellek dokumentációjának keresése, a környezet olvasása, az engedélyezett műveletek és készségek felsorolása és egy készség használata, dátumok számítása, mellékletek olvasása, menük felsorolása, keresés a memóriában, weboldalak keresése és lekérése (ha a Web access képesség be van kapcsolva).
Módosítás (csak ha az Írás, Törlés vagy Üzleti műveletek képesség be van kapcsolva): rekordok létrehozása, módosítása és törlése, engedélyezett üzleti művelet hívása, fájl lekérése egy mezőbe.

Nem érhető el, bármilyenek is a képességek: emlékek mentése vagy elfelejtése, automatizálások létrehozása vagy futtatása, nézetek, mezők vagy modellek módosítása, képek generálása és a weboldalépítő eszközök. A csak olvasási hozzáférésű token csak az olvasási eszközöket látja. Minden eszközhívás a felhasználó nevében fut, ugyanazokkal a hozzáférési szabályokkal, szabályzat-ellenőrzésekkel és naplózással, mint az Odoo-n belüli asszisztens.

AI-alkalmazások által kért módosítások¶

Alapértelmezés szerint az Mindig kérjen megerősítést érvényes: minden kapcsolatnak saját beszélgetése van („MCP: az alkalmazás neve”), és minden létrehozás, módosítás, törlés vagy művelet javaslattá válik, amelyet az AI panelben hagysz jóvá (lásd: Az AI panel). Az alternatíva, a Az AI írási beállításait követi, ehelyett a globális írási módot használja. Minden eszközhívás MCP-hívásként bekerül az AI naplójába, és beleszámít a sebességkorlátokba.

A viselkedést a AI-alkalmazások által kért módosítások beállításban választhatod ki.

Alkalmazások regisztrálása¶

Kétféleképpen engedhetsz be egy alkalmazást.

Te regisztrálod az AI ‣ Konfiguráció ‣ MCP szerver ‣ AI-alkalmazások menüben: a hozzájárulási oldalon megjelenő Alkalmazás neve és az engedélyezett Átirányítási URI-k megadásával. Használd a Titkos kulcs generálása gombot bizalmas alkalmazáshoz (a titkos kulcs csak egyszer jelenik meg), vagy a Nyilvánossá tétel (csak PKCE) gombot olyan alkalmazásokhoz, amelyek nem tudnak titkot őrizni.
Vagy bekapcsolod a Dinamikus kliensregisztráció engedélyezése beállítást, és az alkalmazások maguktól regisztrálnak. Ez alapértelmezés szerint ki van kapcsolva. A felhasználók továbbra is bejelentkeznek és minden kapcsolatot jóváhagynak, de a regisztráció korlátozott:
- hálózati címenként (Regisztrációk címenként és óránként, alapértelmezés szerint 10). Ezen felül az alkalmazás a „Too many app registrations from this address” üzenetet kapja;
- egy alkalmazás legfeljebb 10 átirányítási URI-t regisztrálhat, egyenként legfeljebb 2048 karakter hosszút, legfeljebb 16 KB méretű kérésben;
- minden átirányítási URI-nek meg kell felelnie az egyik Engedélyezett átirányítási URI-minták mintának (lásd alább);
- legfeljebb 1000 önregisztrált alkalmazást fogad el a rendszer (ai_mcp_gateway.dcr_max_clients rendszerparaméter). Azok az alkalmazások, amelyek soha nem csatlakoztak, és régebbiek az alábbi takarítási időnél, nem számítanak; és
- az az alkalmazás, amely magától regisztrált, és soha nem csatlakozott, 72 óra után törlődik egy ütemezett feladat által (ai_mcp_gateway.dcr_unused_client_hours rendszerparaméter).
Az engedélyezési oldal előtt felismert engedélyezési hibát nem küldi vissza egy önregisztrált alkalmazásnak: egy hibaoldalon mutatja meg neked, hogy egy átnézetlen alkalmazás ne használhassa a szervert arra, hogy máshová irányítson át. A jóváhagyási oldal után a saját Tiltás döntésed mindig visszakerül az alkalmazáshoz, ahogy a protokoll elvárja. Az általad regisztrált alkalmazások a hibákat a szokásos módon kapják.

További beállítások az MCP szerver blokkban: Tokenek élettartama (a hozzáférési token percei és a frissítő token napjai) és Engedélyezett böngésző-originek a böngészőalapú alkalmazásokhoz.

Átirányítási URI szabályok¶

Azt, hogy az AI-alkalmazás hová küldhet vissza a bejelentkezés után, az Engedélyezett átirányítási URI-minták korlátozza. Minden átirányítási URI-nek, akár te adod meg, akár egy alkalmazás regisztrálja, meg kell felelnie az egyik mintának (szóközzel vagy vesszővel elválasztva). A minta alakja scheme://host[:port][/path]:

a gazdagép (host) szó szerinti név, * bármely gazdagéphez, vagy *.example.com pontosan egy további címkéhez az example.com előtt (a.example.com, nem a.b.example.com);
a port szám vagy * bármely porthoz. Port nélkül a cím nem nevezhet meg portot (a séma alapértelmezett portját kivéve);
az útvonal (path) üres (bármely útvonal), rögzített útvonal (pontos egyezés), vagy /*-ra végződik (az az útvonal és minden alatta lévő);
semmi más nem helyettesítő karakter, és a * soha nem terjed át egy / jelen.

Például a https://claude.ai/api/* csak az ez alatti útvonalon lévő címeket engedi. Az alapértelmezett minták bármely https:// címet elfogadnak, valamint a helyi loopback címeket (127.0.0.1, localhost és [::1]), amelyeket az asztali eszközök használnak.

A mintáktól függetlenül egy átirányítási URI-nek abszolútnak kell lennie, nem tartalmazhat töredéket (fragment) vagy felhasználói adatot, nem használhatja a javascript, data, file vagy vbscript sémákat, és sima http csak loopback címekhez engedélyezett. A pontszegmenseket vagy szóközt tartalmazó URI-k soha nem egyeznek. Amikor egy alkalmazás egy URI-ra kéri a visszairányítást, annak pontosan meg kell egyeznie egy regisztrálttal; csak egy regisztrált loopback http cím portja különbözhet.

Portálfelhasználók¶

A portálmodullal és a A portálfelhasználók csatlakoztathatnak AI-alkalmazásokat beállítással (alapértelmezés szerint kikapcsolva) a portálfelhasználók is csatlakoztathatnak AI-alkalmazásokat a portál „AI-alkalmazásaim” oldaláról. Csak a keresési, olvasási és csoportosítási eszközöket kapják, csak olvasásra, és csak azokra a modellekre, amelyekre van kifejezett olvasást engedélyező szabály egy olyan AI-hozzáférési csoportban, amelynek tagjai. Erre a célra egy kiszállított, üres Portálfelhasználók (MCP) csoport van az összes portálfelhasználóhoz rendelve. Az Odoo saját portáljogosultságai továbbra is érvényesek alatta.

Korlátok¶

A szerver állapotmentes, és egyedi kérésekre válaszol: nincs adatfolyam, nincsenek szerver által kezdeményezett üzenetek, nincsenek erőforrások vagy promptok.
Az alkalmazásokat regisztráció azonosítja (a tiéd vagy dinamikus), nem URL-alapú kliensazonosító dokumentum.
Az archivált, az AI-csoportból eltávolított vagy kitiltott felhasználó a következő kérésnél elveszíti a hozzáférését.