Agente AI · MCP

Agente AI e MCP: configura Marta conversando

Collega Claude o ChatGPT al tuo programma fedeltà con un click. L'Agente Marta parla italiano con l'operatore e usa tool MCP sicure per leggere dashboard, vendite e performance promo, bozzare campagne e applicare modifiche solo dopo conferma esplicita.

Il server MCP è nativo in Marta API: niente middleware opachi, token revocabili e audit completo. Non è MARTAIA: l'Agente opera sulla piattaforma da Claude, ChatGPT e altri client MCP.
Richiedi una demo Vedi il flusso sicuro
Agente Marta con una bozza in attesa di conferma esplicita.
Visa Shopify Power BI OneSignal KPM Meta AWS

MCP Server nativo

Niente middleware opachi: il protocollo MCP vive dentro Marta API

L'Agente Marta si collega tramite il MCP Server nativo (POST /mcp, Streamable HTTP / JSON-RPC). Autenticazione Bearer con token connettore marta_conn_*, server name marta-agent, device type di audit AI_CONNECTOR.

Per Claude Desktop è disponibile un ponte stdio opzionale. Dall'admin si scaricano lo skill pack e l'OpenAPI filtrato per Actions ChatGPT. Smoke test MCP senza uscire da Impostazioni → Agente AI.

MCP dentro Marta API, con un token revocabile.

Connettori e canali

Un token, due scope, tre modi per collegare Claude e ChatGPT

Da Impostazioni → Agente AI crei il connettore. Scegli lo scope read (sola lettura) o read_write (lettura + mutazioni con dry-run). Il token in chiaro si vede una sola volta: in database resta l'hash SHA-256. Revoca in qualsiasi momento.

Installazione guidata per Claude Desktop (Mac e Windows) e guide per ChatGPT Plugin o Custom GPT. Altri client MCP compatibili con Streamable HTTP o ponte stdio.

Claude Desktop · Mac stdio bridge
Installatore guidato da Terminale. Gatekeeper blocca i file .command scaricati.
Claude Desktop · Windows .cmd
Installatore .cmd + snippet JSON MCP per sviluppatori.
ChatGPT Plugin HTTP diretto
Plus/Pro con Modalità sviluppatore. MCP Streamable HTTP nativo.
Custom GPT · Business / Edu OpenAPI
Actions su /ai/openapi-agent.json + skill zip.
Sicurezza operativa

Nessuna scrittura senza snapshot, dry-run e conferma esplicita

Il flusso è obbligatorio: prima il contesto, poi i numeri, poi la bozza. Le mutazioni partono con dryRun=true. L'apply richiede dryRun=false e confirm=true. Circa 30 mutazioni/ora per connettore. Percorsi bloccati anche con invoke_rest: connettori AI, OAuth, password, /mcp. Ogni scrittura è in audit con origin mcp o actions.

Tool MCP

Lettura, bozze e scritture con gli stessi permessi dell'operatore

Le tool di lettura coprono snapshot, KPI, vendite, clienti senza PII, performance promo e knowledge base. Con scope read_write l'agente aggiorna impostazioni, wallet e tier, crea promo in stato INACTIVE e cambia solo ACTIVE / INACTIVE.

invoke_rest è il ponte sulla REST admin: stesse ACL dell'operatore, niente MARTAIA in v1, niente path di sicurezza.

get_program_snapshot
Dettaglio, wallet, tier, promo, KPI
read
query_sales / query_customers
Vendite e clienti aggregati, senza PII
read
draft_promotion
Input in italiano → workflowConfig
write
create_promotion
Status default INACTIVE
write
upsert_wallet / upsert_tier
Crea o aggiorna wallet e categorie
write
invoke_rest
GET/POST/PUT sulla REST admin, ACL operatore
bridge

Due layer AI

Agente Marta non è MARTAIA: uno parla da Claude, l'altro vive in Admin

MARTAIA è l'intelligenza in-admin: Analyst, Promo Generator, Config AI. L'Agente Marta opera sulla piattaforma da client esterni, con token dedicati, scope e dry-run. Stesso programma, due modi di lavorare — e una distinzione voluta: l'agente v1 non chiama MARTAIA.

Vuoi l'AI dentro il backoffice? Vai su Marta AI — MARTAIA.

Agente Marta (MCP)MARTAIA
DoveClaude, ChatGPT, client MCPDentro Admin
Cosa faConfigura programma, promo, wallet, RESTAnalyst SQL, Promo AI, Config AI
AuthToken marta_conn_*Sessione operatore
ScrittureDry-run + conferma obbligatoriaDirette dal contesto Admin
Due layer AI distinti. L'agente v1 non chiama MARTAIA.

MCP nativo, token revocabili,
scritture solo dopo conferma

MCP Server

Endpoint nativo POST /mcp. Streamable HTTP, JSON-RPC, server name marta-agent. Niente proxy di terze parti.

NATIVO

Scope e token

Read o read_write. Token visibile una sola volta, hash in DB, revoca immediata e permesso IAM ai_connectors.

CONNETTORI

Dry-run

Ogni mutazione è simulata prima. Apply solo con dryRun=false e confirm=true. Circa 30 apply/ora.

SICUREZZA

Claude e ChatGPT

Desktop Mac/Windows, Plugin MCP e Custom GPT Business/Edu. Skill zip e OpenAPI scaricabili dall'admin.

CANALI
Tutte le caratteristiche

Agente AI e MCP: configura Marta conversando

MCP Server nativo (POST /mcp) con autenticazione Bearer e audit AI_CONNECTOR.
Connettori con scope lettura o lettura/scrittura, token monouso e revoca immediata.
Dry-run e conferma obbligatori su ogni mutazione, con tetto di circa 30 apply/ora.
Tool dedicate: snapshot, report, draft promo, wallet, tier e cambio stato promo.
Ponte REST invoke_rest con gli stessi permessi dell'operatore e path di sicurezza bloccati.
Installazione guidata per Claude Desktop (Mac/Windows) e guide ChatGPT Plugin / Custom GPT.
Skill e OpenAPI agente scaricabili dall'admin, più smoke test MCP in-app.
Niente PII sulle query clienti e nessuna chiamata a MARTAIA dall'agente v1.

Collega Claude e ChatGPT al tuo programma

Richiedi una demo e vediamo insieme token, dry-run e una bozza promo via Agente Marta — sullo stesso programma che userai in produzione.