El Model Context Protocol (MCP) es el estándar abierto que permite a modelos de IA como Claude interactuar con sistemas externos de forma segura y estructurada. gigstack implementa un servidor MCP que expone todas sus capacidades de facturación, cobranza y consultas fiscales. Esto significa que puedes configurar qué puede y qué no puede hacer Claude con tu cuenta. El resultado: control granular sobre las operaciones permitidas.
¿Qué es MCP y por qué importa?
MCP (Model Context Protocol) es un protocolo creado por Anthropic que estandariza cómo los modelos de IA se conectan con herramientas externas. En lugar de que cada integración sea custom, MCP define un formato universal. gigstack implementa este protocolo, lo que significa que Claude puede operar tu facturación de forma nativa, sin APIs intermedias ni código custom.
Capacidades del MCP de gigstack
- create_invoice: Emitir facturas CFDI 4.0 con todos los datos fiscales
- list_invoices: Consultar facturas emitidas con filtros por fecha, cliente, estatus
- get_invoice: Obtener detalles completos de una factura específica
- cancel_invoice: Cancelar facturas ante el SAT con motivo
- create_customer: Dar de alta clientes con validación de RFC
- validate_rfc: Verificar RFC y obtener datos fiscales del SAT
- get_balance: Consultar ingresos facturados por período
- send_reminder: Enviar recordatorios de pago a clientes
- create_payment_complement: Emitir complementos de pago
Instalación y configuración
- Instala Claude Desktop desde claude.ai/download
- Obtén tu API Key de gigstack desde el dashboard > Configuración > API
- Abre la configuración de Claude Desktop (Settings > Developer > MCP Servers)
- Agrega el servidor de gigstack con tu API Key
- Reinicia Claude Desktop para activar la conexión
- Prueba con: "¿Cuántas facturas emití este mes?"
Configuración del servidor MCP
En tu archivo de configuración de Claude Desktop (claude_desktop_config.json), agrega:
{
"mcpServers": {
"gigstack": {
"command": "npx",
"args": ["@gigstack/mcp-server"],
"env": {
"GIGSTACK_API_KEY": "tu_api_key_aquí"
}
}
}
}
Esto le dice a Claude cómo conectarse con gigstack.
Ejemplos de uso en conversación
Emitir una factura
"Emite una factura por $8,500 pesos a mi cliente Acme Corp (RFC ACO850101XYZ) por servicios de consultoría de abril" Claude usa el tool create_invoice, valida el RFC, genera el CFDI 4.0 y te devuelve el UUID y link al PDF.
Consultar ingresos
"¿Cuánto he facturado en el primer trimestre de 2026?" Claude consulta las facturas del período y te da el total desglosado por mes, con comparativa vs año anterior si está disponible.
Gestionar cobranza
"Envía un recordatorio amable a todos los clientes con facturas vencidas hace más de 7 días" Claude identifica las facturas, genera mensajes personalizados y los envía. Te reporta cuántos se enviaron.
Seguridad y mejores prácticas
El MCP de gigstack opera con los mismos permisos que tu API Key. Puedes crear keys con permisos limitados (solo lectura, solo ciertos montos, etc.) para controlar qué puede hacer Claude. Todas las operaciones quedan registradas en el log de actividad de tu cuenta. Nunca compartas tu API Key y rótala periódicamente.
Preguntas Frecuentes
¿El MCP funciona con Claude gratuito?
El MCP requiere Claude Desktop o Claude Code, que están disponibles en planes Pro y Team. La conexión con gigstack funciona con cualquier plan de gigstack que incluya acceso a API.
¿Qué pasa si Claude comete un error al facturar?
Claude siempre te muestra qué va a hacer antes de ejecutar operaciones sensibles. Puedes configurar que pida confirmación para montos mayores a cierto umbral. Si hay un error, puedes cancelar la factura desde el dashboard o pedirle a Claude que lo haga.
¿Puedo usar el MCP en mis propias aplicaciones?
Sí. El servidor MCP de gigstack es open source y puedes integrarlo en cualquier aplicación que soporte el protocolo MCP. También puedes usar la API REST directamente para integraciones custom.
¿El MCP consume requests de mi plan de gigstack?
Sí, cada operación que Claude ejecuta cuenta como un request de API normal. Consultas simples consumen 1 request, facturación consume los mismos requests que vía dashboard o API directa.
Da el Siguiente Paso
La facturación automática no es el futuro, es el presente. Conecta gigstack ahora y cumple con el SAT sin esfuerzo.
Blogs que te pueden gustar
