Conecta Cursor y VS Code a tu sistema de facturación con MCP

Si eres desarrollador y trabajas con facturación electrónica, tu editor puede convertirse en un asistente que conoce tu cuenta de AZUR. Con el servidor MCP, Cursor, VS Code o Windsurf pueden consultar clientes, productos y comprobantes mientras programas.

Por qué conectar tu editor

• Datos reales al alcance: pregunta por un cliente o un comprobante sin cambiar de ventana.
• Pruebas más rápidas: prepara borradores en el ambiente de pruebas para validar tu integración.
• Menos errores: verifica códigos de productos, identificaciones y estados antes de escribir código.

Paso 1: crea una credencial de pruebas

En AZUR: menú de usuario → Credenciales API. Para desarrollo usa siempre una credencial azur_test_, que trabaja en el ambiente de pruebas del SRI.

Paso 2: configura el servidor MCP

En Cursor, VS Code o Windsurf agrega este bloque a la configuración de servidores MCP:

{
  "mcpServers": {
    "azur": {
      "url": "https://azur.com.ec/mcp",
      "headers": { "Authorization": "Bearer azur_test_..." }
    }
  }
}

Reinicia el editor y verás las herramientas de AZUR disponibles para el asistente.

Paso 3: úsalo mientras programas

Algunos ejemplos de lo que puedes pedir:

• «Busca el producto con código PR-001 y dime su precio y stock.»
• «Muéstrame el último comprobante que emití y su estado.»
• «Prepara un borrador de factura de prueba para el consumidor final.»

Combínalo con la API y los SDK

El MCP es ideal para explorar; para tu integración en producción usa la API o los SDK oficiales:

• PHP: composer require azur/sdk
• JavaScript/TypeScript: npm install @azur.com.ec/sdk

La referencia completa está generada desde el OpenAPI, así que puedes importarla en Postman o pedirle a tu editor que te ayude con un endpoint concreto.

Buenas prácticas

• No compartas credenciales en repositorios: guárdalas en variables de entorno.
• Usa permisos mínimos y revoca las credenciales de desarrollo que ya no uses.
• El envío al SRI está desactivado por defecto en el MCP: deja esa acción a tu código probado o a una persona.

Encuentra todas las opciones de conexión en la guía del servidor MCP.

¿Listo para integrar? Crea tu cuenta gratis y empieza con una credencial de pruebas.