Agente de IA · MCP

Agente de IA y MCP: configura Marta conversando

Conecta Claude o ChatGPT a tu programa de loyalty con un clic. El Agente Marta habla italiano con el operador y usa herramientas MCP seguras para leer paneles, ventas y rendimiento de promociones, preparar campañas y aplicar cambios solo después de una confirmación explícita.

El servidor MCP es nativo en Marta API: sin middleware opacos, tokens revocables y auditoría completa. No es MARTAIA: el Agente opera en la plataforma desde Claude, ChatGPT y otros clientes MCP.
Agente Marta con un borrador a la espera de confirmación explícita.

MCP Server nativo

Sin middleware opacos: el protocolo MCP vive dentro de Marta API

El Agente Marta se conecta a través del MCP Server nativo (POST /mcp, Streamable HTTP / JSON-RPC). Autenticación Bearer con token de conector marta_conn_*, nombre del servidor marta-agent, tipo de dispositivo de auditoría AI_CONNECTOR.

Para Claude Desktop hay un puente stdio opcional. Desde el admin descargas el skill pack y el OpenAPI filtrado para las Actions de ChatGPT. Haz un smoke test de MCP sin salir de Ajustes → Agente de IA.

MCP dentro de Marta API, con un token revocable.

Conectores y canales

Un token, dos scopes, tres formas de conectar Claude y ChatGPT

Da Ajustes → Agente de IA creas el conector. Elige el scope read (solo lectura) o read_write (lectura + mutaciones con dry-run). El token en claro se ve una sola vez: en la base de datos queda el hash SHA-256. Puedes revocarlo en cualquier momento.

Instalación guiada para Claude Desktop (Mac y Windows) y guías para ChatGPT Plugin o Custom GPT. Otros clientes MCP compatibles con Streamable HTTP o con el puente stdio.

Claude Desktop · Mac stdio bridge
Instalador guiado desde Terminal. Gatekeeper bloquea los archivos .command descargados.
Claude Desktop · Windows .cmd
Instalador .cmd + snippet JSON de MCP para desarrolladores.
ChatGPT Plugin HTTP directo
Plus/Pro con modo desarrollador. MCP Streamable HTTP nativo.
Custom GPT · Business / Edu OpenAPI
Actions en /ai/openapi-agent.json + skill zip.
Seguridad operativa

Ninguna escritura sin snapshot, dry-run y confirmación explícita

El flujo es obligatorio: primero el contexto, luego los números, luego el borrador. Las mutaciones empiezan con dryRun=true. El apply exige dryRun=false e confirm=true. Unas 30 mutaciones/hora por conector. Rutas bloqueadas incluso con invoke_rest: conectores de IA, OAuth, contraseñas, /mcp. Cada escritura queda en la auditoría con origin mcp o actions.

Herramientas MCP

Lectura, borradores y escrituras con los mismos permisos del operador

Las herramientas de lectura cubren snapshot, KPI, ventas, clientes sin PII, rendimiento de promociones y la base de conocimiento. Con scope read_write el agente actualiza ajustes, wallets y niveles, crea promociones en estado INACTIVE y solo cambia ACTIVE / INACTIVE.

invoke_rest es el puente hacia la REST de admin: las mismas ACL del operador, sin MARTAIA en v1 y sin rutas de seguridad.

get_program_snapshot
Detalle, wallets, niveles, promociones, KPI
read
query_sales / query_customers
Ventas y clientes agregados, sin PII
read
draft_promotion
Entrada en italiano → workflowConfig
write
create_promotion
Estado por defecto INACTIVE
write
upsert_wallet / upsert_tier
Crea o actualiza wallets y categorías
write
invoke_rest
GET/POST/PUT en la REST de admin, ACL del operador
bridge

Dos capas de IA

Agente Marta no es MARTAIA: uno habla desde Claude, el otro vive en Admin

MARTAIA es la inteligencia dentro de Admin: Analyst, Promo Generator, Config AI. El Agente Marta opera en la plataforma desde clientes externos, con tokens dedicados, scope y dry-run. El mismo programa, dos formas de trabajar — y una distinción buscada: el agente v1 no llama a MARTAIA.

¿Quieres la IA dentro del back office? Ve a Marta AI — MARTAIA.

Agente Marta (MCP)MARTAIA
DóndeClaude, ChatGPT, clientes MCPDentro de Admin
Qué haceConfigura programa, promociones, wallets y RESTAnalyst SQL, Promo AI, Config AI
AuthToken marta_conn_*Sesión de operador
EscriturasDry-run + confirmación obligatoriaDirectas desde el contexto de Admin
Dos capas de IA distintas. El agente v1 no llama a MARTAIA.

MCP nativo, tokens revocables,
escrituras solo después de confirmar

MCP Server

Endpoint nativo POST /mcp. Streamable HTTP, JSON-RPC, server name marta-agent. Sin proxy de terceros.

NATIVO

Scope y tokens

Read o read_write. Token visible una sola vez, hash en la base de datos, revocación inmediata y permiso IAM ai_connectors.

CONECTORES

Dry-run

Cada mutación se simula antes. Apply solo con dryRun=false y confirm=true. Unas 30 aplicaciones por hora.

SEGURIDAD

Claude y ChatGPT

Desktop en Mac/Windows, Plugin MCP y Custom GPT Business/Edu. Skill zip y OpenAPI descargables desde el admin.

CANALES
Todas las características

Agente de IA y MCP: configura Marta conversando

MCP Server nativo (POST /mcp) con autenticación Bearer y auditoría AI_CONNECTOR.
Conectores con scope de lectura o de lectura/escritura, token de un solo uso y revocación inmediata.
Dry-run y confirmación obligatorios en cada mutación, con un tope de unas 30 aplicaciones por hora.
Herramientas dedicadas: snapshot, informes, borrador de promoción, wallet, nivel y cambio de estado de la promoción.
Puente REST invoke_rest con los mismos permisos del operador y las rutas de seguridad bloqueadas.
Instalación guiada para Claude Desktop (Mac/Windows) y guías de ChatGPT Plugin / Custom GPT.
Skill y OpenAPI del agente, descargables desde el admin, más un smoke test de MCP en la app.
Sin PII en las consultas de clientes y ninguna llamada a MARTAIA desde el agente v1.

Conecta Claude y ChatGPT a tu programa

Solicita una demo y vemos juntos el token, el dry-run y un borrador de promoción con Agente Marta — en el mismo programa que usarás en producción.