Saltar al contenido
MODEL CONTEXT PROTOCOL

Conversa con tu negocio desde Claude

31 herramientas repartidas en dos servidores MCP. Pregunta por tus ventas, tus documentos tributarios y tu catálogo; analiza Meta y Google Ads con el margen real de tu ERP; y diseña un correo completo con tus productos y tu marca, y guárdalo, sin salir de la conversación.

Qué le puedes pedir

Incluida una pregunta que el servidor contesta que no puede responder. Esa también es información útil.

Marketing

«¿Qué creativo me está dando margen de verdad, no solo ROAS de plataforma?»

get_creative_performance cruza el gasto del anuncio con el margen ya cerrado del ERP, sin reembolsos.

Marketing

«¿Qué términos de búsqueda me están gastando sin convertir?»

get_search_terms trae los términos reales con sus métricas. De ahí salen las palabras a negativizar.

Marketing

«Diséñame el correo de la promoción de invierno con estos tres productos y guárdalo.»

search_email_catalog busca los productos reales, get_email_brand toma tus colores, preview_email_template muestra cómo queda y create_email_template lo guarda.

ERP

«¿Cuánto facturé el mes pasado y cuánto fueron notas de crédito?»

get_dte_stats resuelve el cruce de documentos y la resta de las notas de crédito.

ERP

«¿Qué productos no tienen costo cargado?»

get_product_stats devuelve los huecos de datos del catálogo.

ERP

«¿Cuál fue mi margen por producto en julio?»

El MCP del ERP responde que no puede calcularlo: requiere cruzar tablas y separar signos de devolución. Ese reporte se ve en Astrobit.

MCP del ERP

Tu operación comercial: ventas, documentos tributarios, catálogo y preparación de pedidos.

Se conecta desde Astrobit, en Configuración → MCP.

Reportes calculados en el servidor

El servidor hace el cálculo completo y devuelve el número correcto. Son las que conviene usar.

get_dte_stats

Documentos tributarios: facturado, notas de crédito y total declarado en un período, con los cruces y las restas ya resueltos.

get_preparation_stats

Volumen y costo de preparación de pedidos en un rango.

get_product_stats

Huecos de datos en el catálogo: productos sin costo, sin código de barras y similares.

Catálogo

Para encontrar e inspeccionar productos concretos.

search_products

Busca productos por texto.

get_product

Devuelve un producto con su detalle.

list_categories

Las categorías del catálogo.

list_custom_fields

Los campos personalizados que definió tu operación.

Consulta estructurada

Un constructor de consultas sobre una tabla a la vez. No es SQL libre.

list_tables

Qué tablas hay disponibles.

describe_table

Qué columnas tiene una tabla.

query_table

Filtra, ordena, agrupa y agrega sobre una sola tabla, hasta 1.000 filas.

get_query_guide

Las convenciones del negocio (plata, devoluciones, fechas, DTE) para que el modelo no invente el significado de una columna.

MCP de marketing

Tu publicidad y tus correos: Meta Ads, Google Ads y el diseño de plantillas de email.

Se conecta desde el módulo de Marketing, con tu correo autorizado.

Cuentas y frescura del dato

Antes de sacar conclusiones, saber de cuándo son los datos.

list_ad_accounts

Las cuentas de Meta y Google activas, con su moneda, zona horaria y estado del último sync.

get_sync_status

Cuándo fue el último sync correcto de cada cuenta y qué falló sin ser fatal. Sirve para no analizar datos viejos creyendo que están al día.

Rendimiento y creativos

Lo que se gastó, lo que rindió, y con qué pieza.

get_account_overview

Gasto, impresiones, clics, conversiones y valor del período, con CTR, CPC, CPM, CPA y ROAS derivados.

list_ads

Los anuncios con su creativo completo: el copy real, los titulares, la imagen en alta, el carrusel, el formato y el enlace público, junto con sus métricas del rango.

get_creative_performance

ROAS y POAS reales por creativo: cruza el gasto con el margen ya cerrado del ERP, excluyendo reembolsos y deduplicando por fuente. Es la diferencia entre el retorno que declara la plataforma y el que quedó en tu resultado.

get_campaign_detail

Una campaña por dentro: presupuesto, métricas del rango, conjuntos de anuncios y participación de impresiones.

Segmentación y diagnóstico

Dónde se está yendo la plata y por qué.

get_breakdowns

Rendimiento segmentado por edad, género, país, región, dispositivo, ubicación del anuncio, día de la semana u hora.

get_funnel_by_action

El embudo que declara la plataforma: cada tipo de acción con su cantidad y su valor.

get_search_terms

Los términos que la gente escribió realmente en Google y dispararon tus anuncios. Es donde aparecen las palabras que gastan y no convierten.

get_keywords_quality

Las palabras clave con su nivel de calidad y sus componentes, para encontrar las que gastan mucho con calidad baja.

get_impression_share

Cuánto del mercado disponible estás capturando y por qué pierdes el resto: presupuesto o relevancia. Decide si subir el gasto o mejorar el anuncio.

get_geo

Rendimiento por país y región.

Plantillas de email

Acá está lo único que el MCP escribe. Todo el resto de las herramientas solo lee.

get_email_template_schema

El contrato completo de diseño: los tipos de bloque disponibles con todas sus propiedades. Es lo que el modelo lee antes de diseñar.

get_email_brand

Tu identidad de marca guardada —colores, logo, tipografía— para que el diseño salga en tu línea.

search_email_catalog

Busca productos reales de tu catálogo por SKU o nombre, para que el correo lleve productos que existen y no inventados.

list_email_templates

Tus plantillas con su nombre, asunto, cantidad de bloques y última edición.

get_email_template

Una plantilla completa, con sus advertencias.

preview_email_template

Valida y renderiza un diseño SIN guardarlo, con el mismo motor que usa el envío real. Lo que ves acá es lo que llegaría.

create_email_templateescribe

Crea una plantilla nueva con el diseño completo, bloques y estilos. No pisa nada existente.

update_email_templateescribe

Modifica una plantilla existente. Exige la marca de tiempo de la versión que leyó y falla si alguien la editó mientras tanto, así dos personas no se pisan el trabajo.

Dónde están los límites

Los límites son parte del producto. Un servidor que promete responder todo termina inventando la mitad.

Hoy lo único que escribe son plantillas de email

Y lo hace por una lista blanca de funciones, no construyendo instrucciones a la base de datos. Todo lo demás —ventas, documentos tributarios, stock, campañas, presupuestos— es de consulta. Si hoy un asistente te dice que emitió un documento, cambió un precio o subió un presupuesto por MCP, no lo hizo. Lo que viene está más abajo.

El MCP del ERP es de solo lectura

Se conecta con un usuario de base de datos que solo puede leer, y encima hay un proxy que bloquea escrituras. Hoy no existe ninguna herramienta de escritura en ese servidor.

Cada conexión ve una sola cuenta

La credencial está atada a tu base. Ni una consulta ni una escritura pueden salir a los datos de otro cliente: la cuenta viaja en la credencial, no en lo que pide el modelo, así que pedir la de otro no es siquiera expresable.

La consulta genérica del ERP no es SQL libre

Trabaja sobre una tabla a la vez. No cruza tablas, no evalúa expresiones y no agrupa por día ni por mes. Es a propósito: una consulta que el servidor no puede responder bien es mejor que un número inventado que parece correcto.

Ventas netas y margen no salen por consulta genérica

Esas fórmulas necesitan cruzar tablas, separar signos de devolución y agrupar por fecha local. El servidor lo dice en sus propias instrucciones, para que el modelo conteste que no puede en vez de sumar una columna y llamarle ventas netas.

Toda escritura queda registrada

Cada plantilla creada o modificada por MCP se anota con la herramienta usada y qué se tocó.

En camino

Nada de esto está disponible todavía, y por eso va en su propia sección en vez de mezclado con lo de arriba. Está publicado porque “¿esto va a poder hacer más?” es una pregunta legítima antes de conectar nada. Sin fechas: cuando esté, se avisa.

Emisión conversacional

todavía no

Pedirle a Claude que emita el documento que corresponde, en vez de entrar a emitirlo. Hoy la emisión se hace desde Astrobit, o desde tu propio sistema por API.

Asesor contable

todavía no

Clasificar los documentos recibidos, mapear proveedores y categorías a cuentas contables, y leer el estado de resultados desde la conversación, con las convenciones del negocio cargadas para que el modelo no invente el tratamiento de un documento.

El criterio para lo que escriba en el futuro

todavía no

El modelo prepara el borrador y una persona lo aplica en la aplicación. No escritura autónoma sobre el libro contable: un asiento mal puesto por un modelo, en un libro que alimenta el F29, no es un error que se arregle con deshacer.

Cómo se conecta

El del ERP

  1. 1En Astrobit, Configuración → MCP → Conectar. No hay que pedirlo por correo ni esperar a nadie.
  2. 2Se crea un usuario de solo lectura sobre tu base y se genera la clave. Se muestra una sola vez: cópiala en ese momento.
  3. 3Agregas el conector en Claude con la URL que aparece en el panel y esa clave.

El de marketing

  1. 1Tu correo tiene que estar en la lista de autorizados. Es el correo con el que entras a Marketing, no tu cuenta de Claude.
  2. 2Autorizas la conexión desde Claude. Cada conexión es independiente: puedes tener varias y revocarlas una por una.
  3. 3El permiso de escribir plantillas se otorga por correo y es opcional. Sin él, el conector solo lee.

Si cambias los permisos de una conexión ya activa, hay que quitar y volver a agregar el conector en Claude: el cliente pide la lista de herramientas una sola vez, al conectarse, y la guarda. Reconectar es lo que la refresca.

Preguntas frecuentes

¿Qué es un servidor MCP?

MCP (Model Context Protocol) es un estándar abierto para que un modelo de lenguaje trabaje contra un sistema externo con herramientas tipadas, en vez de acceso libre. Astrobit expone dos: uno sobre tu ERP y otro sobre tu marketing.

¿Por qué son dos conexiones y no una?

Porque son dos bases de datos y dos permisos distintos. El del ERP lo conectas desde Astrobit y ve tu operación comercial. El de marketing lo conectas desde el módulo de Marketing y ve tus cuentas de Meta y Google y tus plantillas de correo. Puedes tener las dos activas en el mismo Claude.

¿Puede el modelo cambiar algo en mi negocio?

Solo puede crear y modificar plantillas de email, y únicamente si le diste ese permiso al conectar. Nada más escribe: ni ventas, ni documentos tributarios, ni stock, ni campañas, ni presupuestos de publicidad.

¿De verdad puede diseñar un correo completo?

Sí, y es el caso donde más se nota. Lee el contrato de diseño y tu identidad de marca, busca los productos reales de tu catálogo por SKU para no inventar ninguno, arma los bloques, te muestra el resultado renderizado con el mismo motor del envío real, y recién ahí lo guarda si le dices que sí.

¿Va a poder emitir documentos conversando?

Está en camino, pero hoy no. La emisión se hace desde Astrobit o desde tu propio sistema por API. El criterio de diseño para las escrituras que vengan es que el modelo prepare el borrador y una persona lo aplique en la aplicación, no que escriba solo sobre el libro contable.

¿Y si dos personas editan la misma plantilla?

No se pisan. Para modificar una plantilla hay que entregar la marca de tiempo de la versión que se leyó; si alguien la editó mientras tanto, la operación falla en vez de sobrescribir el trabajo del otro.

¿Con qué clientes funciona?

Con cualquier cliente que implemente MCP. Hoy se usa desde Claude en el navegador, la aplicación de escritorio y Claude Code.

¿Quién puede conectar el MCP de marketing?

Solo los correos que estén en la lista de autorizados, y es el correo con el que entras a Marketing, no tu cuenta de Claude. Cada correo tiene sus propios permisos, y bajo cada uno se ven sus conexiones de Claude activas, que se pueden revocar una por una.

¿Cómo se revoca el acceso al MCP del ERP?

Desde Configuración → MCP, con Desconectar. Pide confirmación y revoca la clave vigente. También está Regenerar clave, que emite una nueva y deja la anterior sin efecto. El panel muestra el identificador de la clave, cuándo se creó y cuándo se usó por última vez.

¿Qué pasa con mis datos cuando los consulto por MCP?

Del lado de Astrobit: la conexión ve solo tu propia base y no sale de ahí; Astrobit no empuja tus datos a ninguna parte, es tu cliente MCP el que consulta. Del lado del cliente: lo que ocurra con la respuesta una vez que llega a Claude, o al cliente que uses, se rige por los términos de ese proveedor.

¿Queda registro de las consultas y por cuánto tiempo?

Las escrituras de plantillas quedan auditadas con la herramienta usada y qué se tocó, y cada credencial guarda la fecha de su último uso, visible en el panel. La política de retención de los registros del servidor todavía no está publicada: si necesitas ese detalle por cumplimiento, escríbenos y te la entregamos por escrito.

Si lo que buscas es escribir en el ERP desde tu propio sistema —crear órdenes, emitir documentos, leer reportes—, eso es la API, no el MCP.

Conecta Claude a tu operación

Crea tu cuenta y activa el MCP desde Configuración, o agenda una reunión y lo vemos con tus datos y tus campañas.