Introducción — Getting Started

Bienvenido a la documentación oficial del API REST de MGPanel. Esta guía te permite integrar tu cuenta con aplicaciones externas, automatizaciones o agentes de IA.

¿Qué es MGPanel?

MGPanel es una plataforma SaaS multi-tenant para crear y administrar sitios web con CRM integrado: clientes, facturas, presupuestos, campañas, formularios, blog y más.

Requisitos previos

Cuenta activa en MGPanel.

Acceso de administrador a la cuenta.

Una API Key válida.

Obtener tu API Key

Inicia sesión en el panel de MGPanel.

Ve a Configuración → API Keys.

Crea una nueva clave o usa una existente.

Guarda la clave de forma segura — no se vuelve a mostrar completa.

Autenticación

Todos los endpoints requieren tres headers en cada request:

Header	Valor	Descripción
`Authorization`	`Bearer <tu_api_key>`	Token de API
`X-Account-Nick`	`mi-cuenta`	Nick único de tu cuenta
`Content-Type`	`application/json`	Obligatorio en requests con body

Ejemplo con cURL

Multi-tenancy

MGPanel usa una base de datos compartida con aislamiento por cuenta. El header X-Account-Nick determina sobre qué cuenta operan todos los endpoints. Nunca mezcles credenciales de distintas cuentas en la misma sesión.

Entornos

Entorno	Base URL	Uso
Producción	`https://app.mgpanel.co`	Integraciones en vivo

Formato de respuestas

Éxito

{
  "success": true,
  "message": "Operación completada",
  "client_id": "507f1f77bcf86cd799439011"
}

Error

{
  "success": false,
  "message": "Descripción legible del error",
  "code": "CLIENT_NOT_FOUND"
}

Los campos en respuestas y request bodies usan snake_case (client_id, invoice_id, modified_at).

Códigos HTTP y errores comunes

HTTP	code	Cuándo
400	`INVALID_BODY`	Faltan campos requeridos
400	`INVALID_<CAMPO>`	Formato inválido
403	`PROTECTED_<RECURSO>`	Recurso del sistema no editable
404	`<RECURSO>_NOT_FOUND`	Recurso no existe
409	`<CAMPO>_CONFLICT`	Valor duplicado
500	—	Error interno (puede incluir `error`)

Áreas del API

Carpeta	Descripción
Platform/Goals	Objetivos, categorías y logros
Platform/Source	Resumen de contexto del negocio
Platform/Account	Datos de la cuenta y usuarios
Website/Web Editor	Páginas, secciones y config del sitio
CRM/	Clientes, facturas, presupuestos, deals, campañas, listas, formularios
Blog/Articles	Artículos del blog

Integración con agentes IA (MCP)

Si usas Claude, Cursor, Gemini o ChatGPT, MGPanel expone un servidor MCP con ~70 herramientas que delegan al mismo API REST. Consulta la página MCP Server para conectar tu cuenta.

Soporte

Email: soporte@mgpanel.co

Web: https://mgpanel.co

Introducción — Getting Started

¿Qué es MGPanel?#

Requisitos previos#

Obtener tu API Key#

Autenticación#

Ejemplo con cURL#

Multi-tenancy#

Entornos#

Formato de respuestas#

Éxito#

Error#

Códigos HTTP y errores comunes#

Áreas del API#

Integración con agentes IA (MCP)#

Soporte#