Servidor MCP

Antes de seguir leyendo

Esta página es distinta de las demás de la documentación, y conviene decirlo en la primera línea: el servidor MCP no está construido y tampoco está especificado. El contrato de la API y el de los webhooks están cerrados en el documento de arquitectura, campo a campo. Esto no. Lo que sigue es la intención de producto, y puede cambiar entera.

Si estás decidiendo si Payezz te sirve, decide sin contar con esto. Cuando exista, se publicará aquí con su contrato y con ejemplos que se puedan copiar.

Qué es MCP

MCP, por Model Context Protocol, es un protocolo abierto para que un asistente pueda usar herramientas y leer datos de un sistema externo de forma estructurada, en lugar de que alguien copie y pegue información en un chat.

Aplicado a una tienda de hosting, significa poder preguntar «cuántas facturas tengo vencidas» o pedir «crea un cupón del 20 % para el viernes negro» desde el asistente que ya usas, y que la acción ocurra de verdad en tu instancia, con su registro y sus permisos.

Cómo queremos que funcione

El servidor MCP no será un sistema paralelo. Se apoyará en la misma API y en los mismos permisos que ya usa tu panel, por una razón sencilla: dos caminos distintos hacia el mismo dato acaban discrepando, y en facturación una discrepancia es dinero mal contado.

• Tú eliges qué se expone. Herramienta por herramienta, no todo o nada. Un asistente puede leer tus ingresos sin poder tocar un precio.
• Lectura y escritura, separadas. Las de lectura podrán ejecutarse sin confirmación; las que cambian datos pedirán confirmación explícita, y las que mueven dinero exigirán además una acción tuya en el panel.
• Todo queda registrado. Cada llamada aparece en el registro de actividad con su origen, igual que una acción manual.
• Credencial propia y revocable. Con su alcance, su caducidad y un botón para cortarla, sin tocar el resto de tus integraciones.
• Nada de datos de terceros. Un asistente conectado a tu instancia ve tus datos, y solo los tuyos: el aislamiento por instancia sigue valiendo exactamente igual aquí.

Las herramientas que tenemos en mente

Sin nombres definitivos ni firma de parámetros, porque todavía no existen:

• Consultar ingresos, impagados y altas de un periodo, con desglose por producto.
• Buscar un cliente, un pedido, una factura o un servicio.
• Ver el estado de un servicio y su historial de renovaciones.
• Crear o modificar productos, precios y cupones.
• Redactar y programar un anuncio o una campaña.
• Revisar la comisión de Payezz cobrada y devengada, y la próxima liquidación.

Todo lo que implique cobrar, reembolsar o borrar quedará fuera de la primera versión. Esa línea es fácil de cruzar y difícil de deshacer.

Mientras tanto

Lo que sí va a existir antes es la API REST sobre los recursos de la instancia y los webhooks firmados. Con esas dos piezas se puede montar hoy una integración con el asistente que prefieras, sin esperar a que publiquemos el servidor.

Si el MCP es determinante para ti, dínoslo a hola@payezz.app: saber cuántos lo piden es lo que decide en qué orden se construyen las cosas.