App Maker include un server MCP remote în bridge-ul său de API, componenta care publică și endpoint-urile REST. Administratorii decid ce operațiuni de business pot apela clienții AI, iar fiecare apel rulează o regulă App Maker la fel ca un endpoint API.
Cum funcționează
Model Context Protocol (MCP) este un mod standard prin care aplicațiile expun instrumente către agenți AI. Un client AI se conectează la adresa MCP a portalului, listează instrumentele disponibile și le apelează. Serverul folosește transportul Streamable HTTP, este stateless și returnează răspunsuri JSON.
- Clientul AI trimite apelul unui instrument, cu argumentele lui.
- Bridge-ul validează argumentele pe baza schemei de parametri a instrumentului.
- Bridge-ul rulează modulul și regula instrumentului în App Maker Engine.
- Rezultatul regulii se întoarce la AI ca text: o valoare precum
true, un șir de caractere sau JSON formatat.
Erorile de validare se întorc la AI ca rezultate de eroare, astfel încât acesta să corecteze argumentele și să reîncerce. Erorile din engine sunt jurnalizate, iar AI-ul primește doar un mesaj generic.
Definirea instrumentelor
Instrumentele se definesc în portalul intern, în Management conținut › Endpoints › MCP. Fiecare instrument are un comutator de activare, astfel încât clienților AI li se oferă doar instrumentele activate de un administrator.
| Câmp | Rol |
|---|---|
| Nume tehnic | Numele instrumentului văzut de AI: litere, cifre, underscore și cratimă, maximum 64 de caractere |
| Titlu afișat | Un nume ușor de citit pentru instrument |
| Descriere | Ce face instrumentul, transmis către AI |
| Descrierea rezultatului | Ce returnează instrumentul, transmis către AI împreună cu descrierea |
| Modul și regulă | Modulul și regula App Maker care rulează la apelarea instrumentului |
| Scope | Opțional; limitează instrumentul la token-urile care au acest scope |
| Indicator read-only | Le arată clienților AI că instrumentul nu modifică date |
| Parametri | Tipizați și imbricabili, fiecare cu descrierea lui; bridge-ul construiește din ei o schemă JSON |
Setările MCP conțin și numele afișat al serverului și instrucțiunile serverului, pe care clienții AI le primesc la conectare.
Conectarea clienților AI
Clienții se conectează prin OAuth 2.1 sau cu un token static.
| Metodă | Destinată pentru | Acces |
|---|---|---|
| OAuth 2.1 cu contul MCP | Aplicații AI precum claude.ai, ChatGPT, Claude Code și Cursor | Toate instrumentele activate |
| Token static | Scripturi și agenți | Instrumentele activate al căror scope este inclus în token |
OAuth 2.1
Administratorul setează întâi în portal un cont MCP dedicat (nume de utilizator și parolă). Parola este stocată ca hash. Aplicațiile AI au nevoie apoi doar de adresa serverului.
- Un apel fără token primește
401, cu trimitere la metadatele resursei protejate (RFC 9728). - Clientul citește metadatele serverului de autorizare (RFC 8414).
- Clientul se înregistrează prin înregistrare dinamică (RFC 7591), ca client public cu PKCE sau cu secret de client.
- Fluxul authorization code cu PKCE (S256) deschide o pagină de autentificare servită de bridge. Pagina arată ce aplicație cere acces și unde va reveni.
- Autentificarea cu contul MCP emite un cod de unică folosință, pe care clientul îl schimbă pe token-uri.
Token-urile de acces sunt JWT legate de resursa MCP. Token-urile de reîmprospătare sunt opace, stocate ca hash și rotite la fiecare utilizare. Încercările de autentificare sunt limitate pe adresă IP, iar pagina de autentificare nu poate fi încorporată în alt site.
Token-uri statice
Token-urile statice se generează în portal și sunt afișate o singură dată. Sunt stocate ca hash SHA-256, pot avea dată de expirare și pot fi revocate. Un instrument cu scope obligatoriu este vizibil doar token-urilor care au acel scope.
Exemplu de înregistrare în Claude Code:
claude mcp add --transport http appmaker https://<your-portal>/bridge/mcp --header "Authorization: Bearer mcp_..."Exemplu de configurare a clientului:
{ "mcpServers": { "appmaker": { "url": "https://<your-portal>/bridge/mcp", "headers": { "Authorization": "Bearer mcp_..." } } } }Aplicații conectate și revocare
Aplicațiile conectate prin OAuth sunt listate în portal, la MCP › Acces. Un administrator poate revoca oricare dintre ele, iar revocarea are efect în câteva secunde. Schimbarea parolei contului MCP deconectează toate aplicațiile conectate.
Jurnalizare
Fiecare apel de instrument este jurnalizat cu instrumentul, metoda MCP și apelantul: aplicația OAuth sau numele token-ului. Apelurile sunt transmise și în consola live din portal.
Acces la configurație pentru clienții AI
Serverul MCP descris aici expune operațiuni de business ale aplicațiilor construite cu App Maker. AppMaker Assistant are propriul server MCP, care le oferă clienților AI acces read-only la configurația unui domeniu. Acesta este descris în pagina App Maker Assistant.
