El primer MCP de infraestructura fiscal en República Dominicana
El MCP de infraestructura fiscal en República Dominicana que ofrece Alanube es la primera solución de su categoría en el país. Integrar la API de facturación electrónica con la DGII toma más tiempo del que debería, y el cuello de botella casi nunca es técnico. La ausencia de un MCP de infraestructura fiscal en República Dominicana significaba que cada equipo tenía que aprender la lógica fiscal desde cero: qué tipo de e-CF corresponde a cada transacción, cuándo el resultado llega de forma síncrona, qué significa cada código de rechazo del gobierno. Sin un punto de entrada estandarizado, ese conocimiento se reconstruía proyecto a proyecto.
El MCP (Model Context Protocol) de infraestructura fiscal de Alanube para República Dominicana resuelve exactamente eso: expone la API de facturación electrónica de Alanube como un conjunto de herramientas que cualquier agente de IA puede invocar desde el IDE. En lugar de leer documentación y construir payloads a mano, el developer describe la operación en lenguaje natural y el agente resuelve la lógica de construcción, validación y seguimiento.
Índice de contenidos
- Por qué la integración fiscal toma días, no horas
- Qué expone el MCP: herramientas, recursos y flujo del developer
- Prerrequisitos antes de conectar el agente
- Cómo probar la emisión de un e-CF desde el IDE
- Síncrono vs. asíncrono: la tabla que define la lógica de seguimiento
- Errores frecuentes al conectar el MCP y cómo resolverlos
- Compatible con Claude, Cursor, VS Code y más
Por qué la integración fiscal toma días, no horas
El problema no es la conectividad HTTP. Es que la DGII tiene diez tipos de e-CF activos, cada uno con su propio esquema de campos obligatorios, su comportamiento de respuesta y sus códigos de error específicos. Un developer que llega por primera vez a esta API dedica entre uno y tres días solo a entender esa lógica antes de lograr el primer comprobante aceptado en el Ambiente Piloto.
El MCP de infraestructura fiscal de Alanube traslada ese aprendizaje al agente. El desarrollador no necesita memorizar qué campos exige un e-CF 31 versus un 32, ni saber de antemano si la respuesta será síncrona o asíncrona: el agente consulta el catálogo, construye el payload correcto y gestiona el ciclo de vida del documento.
Qué expone el MCP: herramientas, recursos y flujo del developer
El MCP expone tres capas que cubren el ciclo completo de integración con la API de Alanube:
- Herramientas (tools): 30 acciones concretas — emitir un documento, validar el payload antes de enviarlo a la DGII, consultar el estado de un e-CF, diagnosticar un rechazo o explorar qué endpoints están disponibles.
- Recursos (resources): el catálogo completo de los 10 tipos de e-CF activos en República Dominicana, con sus esquemas de campos, estados del ciclo de vida y códigos de respuesta del gobierno, en un formato que el modelo consulta directamente.
- Flujo del developer: el contrato de integración — cómo conectar el cliente MCP, cómo autenticarse con el token existente de la API de Alanube, y qué herramienta usar en cada paso.
| Capa | Qué resuelve en la integración |
|---|---|
| Herramientas (tools) | Emisión, validación de payload, consulta de estado, diagnóstico de errores DGII |
| Recursos (resources) | Catálogo de los 10 tipos de e-CF, esquemas de campos, códigos de respuesta del gobierno |
| Flujo del developer | Conexión, autenticación con token existente, selección de herramienta por caso de uso |
Prerrequisitos antes de conectar el agente
- Token activo de la API de Alanube — el mismo que ya se usa para la API REST, sin credenciales adicionales.
- Acceso al Sandbox del MCP — disponible sin contrato previo, se solicita directamente al equipo de Alanube.
- Un cliente compatible con el protocolo MCP instalado: Claude Desktop, Cursor, Continue, VS Code, Windsurf o Zed.
- Claridad sobre qué tipo de e-CF emite la integración con mayor frecuencia, para anticipar si el flujo será síncrono o asíncrono desde el primer test.
Cómo probar la emisión de un e-CF desde el IDE
Con el MCP conectado al cliente, el developer describe la operación en lenguaje natural. No construye el payload manualmente:
Emite una Factura de Consumo (32) por una camisa negra
talla L, DOP$1.000 + ITBIS 18%El agente identifica issue_and_track_rd_document como la herramienta adecuada, construye el payload con documentTypeCode: "32", lo valida contra el esquema de la DGII antes de enviarlo, y devuelve el resultado de la API:
{
"ok": true,
"documentTypeCode": "32",
"flowMode": "sync",
"legalStatus": "ACCEPTED",
"documentNumber": "E320000000005",
"assetUrls": {
"xml": "https://...",
"pdf": "https://..."
}
}💡 Con Alanube: el MCP accede a la misma API REST v1.0-DOM que cualquier integración directa usa hoy. No es una capa separada de infraestructura — es la misma API expuesta como herramientas para que el agente la invoque durante el desarrollo.
Cuando el tipo de e-CF se procesa de forma asíncrona — como la Factura de Crédito Fiscal (31) — la primera respuesta no trae el resultado legal final sino una referencia de seguimiento:
{
"ok": true,
"documentTypeCode": "31",
"flowMode": "async",
"finalLegalOutcomeReached": false,
"trackingReference": {
"flow": "rd.fiscal-credit-invoice-31",
"documentId": "doc_xyz789"
}
}El agente usa ese trackingReference para consultar el estado en la DGII hasta obtener la confirmación final.
Síncrono vs. asíncrono: la tabla que define la lógica de seguimiento
Este es el dato que más sorprende a quienes integran por primera vez la API de Alanube para RD: no todos los tipos de e-CF se comportan igual, y la diferencia determina si la integración necesita polling o no.
| Tipo de e-CF | Flujo | Condición |
|---|---|---|
| 32 — Factura de Consumo | Síncrono | Solo si el monto es menor a DOP$250.000 |
| 32 — Factura de Consumo | Asíncrono | Monto igual o mayor a DOP$250.000 |
| 31, 33, 34, 41, 43, 44, 45, 46, 47 | Asíncrono | Siempre, sin excepción por monto |
⚠️ Nota normativa: cualquier integración que maneje más de un tipo de e-CF debe asumir seguimiento asíncrono como comportamiento estándar. El flujo síncrono de la Factura de Consumo es la excepción, no la regla.
Errores frecuentes al conectar el MCP y cómo resolverlos
Error: la DGII rechaza el documento con un governmentResponseCode de validación de fondo.
Causa: tipo de e-CF incorrecto para el receptor — por ejemplo, usar el tipo 32 para una venta al sector público, que exige el tipo 45 (Comprobante Gubernamental).
Solución: invocar diagnose_rd_api_error con el código recibido; la herramienta devuelve la causa probable y el tipo correcto antes de reintentar.
Error: flowMode: "async" en una Factura de Consumo que se esperaba síncrona.
Causa: el monto superó DOP$250.000, o la DGII no respondió en el tiempo esperado y la API encoló el documento automáticamente.
Solución: no es un error de integración. El mismo trackingReference sirve para consultar el estado final sin lógica adicional.
Error: el agente no detecta el servidor MCP al iniciar el cliente.
Causa: error de formato JSON en el archivo de configuración del cliente, o token copiado con espacios o caracteres adicionales.
Solución: validar el JSON con cualquier herramienta en línea y confirmar que el header Authorization: Bearer contenga únicamente el token Sandbox activo.
Compatible con Claude, Cursor, VS Code y más
El MCP de infraestructura fiscal de Alanube funciona con cualquier cliente que soporte el protocolo MCP: Claude Desktop, Claude Code, Cursor, Continue, VS Code con extensión MCP, Windsurf y Zed. La configuración es idéntica en todos los casos: un endpoint y el token de la cuenta de Alanube.
Para integraciones directamente en código, sin cliente de chat, el mismo MCP es accesible desde el SDK estándar @modelcontextprotocol/sdk. Las 30 herramientas quedan disponibles en cuanto el cliente detecta el servidor, sin configuración adicional por herramienta.
Preguntas frecuentes sobre el MCP de infraestructura fiscal en República Dominicana
¿Qué es un MCP de infraestructura fiscal?
Es una capa de integración que expone una API de facturación electrónica certificada como herramientas invocables por un agente de IA. A diferencia de un MCP genérico que lee datos, cada herramienta del MCP de Alanube ejecuta una operación real contra los sistemas de la DGII de República Dominicana — desde el Ambiente Piloto durante la integración.
¿Cuál es la diferencia entre el MCP de Alanube y la API REST tradicional?
La API REST requiere que el developer construya el payload, implemente el seguimiento de estado y procese la respuesta manualmente. El MCP traslada esa lógica al agente de IA: descubre las herramientas, genera el payload en lenguaje natural y valida antes de enviar. Ambas rutas acceden a la misma infraestructura de Alanube certificada ante la DGII.
¿Qué pasa si la DGII rechaza un documento enviado desde el agente?
La herramienta diagnose_rd_api_error interpreta el governmentResponseCode del rechazo y devuelve la causa probable y la corrección concreta. El developer no necesita buscar en la documentación ni escalar a soporte para entender qué falló y cómo corregirlo antes del siguiente intento.
¿La API de Alanube soporta los 10 tipos de e-CF de la DGII a través del MCP?
Sí. El catálogo del MCP cubre los 10 tipos de e-CF activos en República Dominicana — 31, 32, 33, 34, 41, 43, 44, 45, 46 y 47 — cada uno con herramientas de emisión, consulta de estado y diagnóstico específicas. El acceso Sandbox incluye pruebas con todos los tipos desde el primer día.
Conecta tu agente a la API de Alanube hoy
Solicita acceso al Sandbox del MCP, conecta tu cliente en minutos y empieza a probar la integración de e-CF con la DGII sin construir un solo payload a mano.
Solicita acceso al Sandbox del MCP de Alanube →
Fuentes
Dirección General de Impuestos Internos. (2026). Aviso: Extensión del plazo de implementación de Facturación Electrónica para contribuyentes Pequeños, Micros y no clasificados. DGII. https://dgii.gov.do
Congreso Nacional de la República Dominicana. (2023). Ley núm. 32-23 de Facturación Electrónica. Gaceta Oficial.
Alanube. (2026). Documentación oficial del MCP de Alanube para República Dominicana. https://developer.alanube.co/docs/alanube-mcp
