Conexión MCP — Digifact Developer Portal

🤖 URL de conexión

https://documentacion.digifact.com/mcp/sse

¿Para qué sirve?

💬

Preguntas naturales

Tu IDE responde "¿cómo emito una factura en GT?" trayendo el flujo completo.

⚡

Sin scraping

Acceso directo y estructurado a la fuente de verdad — siempre actualizada.

🎯

Multi-país

Una sola conexión cubre GT, SV, CR, PA y DO con su autoridad fiscal.

🔐

Con tus credenciales TEST

Las consultas se autentican con las credenciales de PRUEBA que ya tenés como cliente Digifact — sin registros adicionales.

Tools expuestos (15 en total)

2Vitrina (sin token)

Tool	Descripción
list_countries	Lista los países disponibles con sus autoridades tributarias. Abierto.
get_country_info	Info general de un país: autoridad, ambientes, versión de API, soporte. Abierto.

1Autenticación

Tool	Descripción
country_login	Login por país con tus credenciales de PRUEBA (TEST). Devuelve un access_token para consultar la documentación de ese país, con el mismo vencimiento que el token del API. El password no se almacena y no invalida tus tokens en uso.

3API y país (requieren access_token)

Tool	Descripción
list_endpoints	Lista los endpoints de API de un país (id, método, nombre, descripción).
get_endpoint	Devuelve la doc completa de un endpoint: URLs, headers, params, body, respuesta.
search_docs	Búsqueda full-text en los endpoints del país de tu access_token.

3Generación de NUC (requieren access_token)

Tool	Descripción
generate_nuc_template	Genera un esqueleto del NUC para un DocType de Guatemala (FACT, FCAM, NDEB, NCRE…) en XML o JSON, basado en ejemplos reales.
get_required_fields	Lista los campos obligatorios para construir un NUC del país indicado.
get_complement_for_doctype	Indica qué complementos requiere un DocType de GT (FCAM → FCAMB+CCA, NDEB → NDEB, etc.).

4Exploración del NUC (requieren access_token)

Tool	Descripción
get_nuc_field	Detalle completo de un campo por ID canónico (R01, A02, B051, FI03…) del país indicado.
list_nuc_fields_by_section	Campos por conjunto: R (raíz), A (header), B (emisor), C (receptor), D (ítems), E (totales)…
get_doctypes	Catálogo de tipos de documento por país, con descripción y caso de uso.
get_catalog	Catálogos cerrados por país: AfiliacionIVA, Impuestos, formas de pago, tributos, etc.

2Ejemplos NUC (requieren access_token)

Tool	Descripción
list_examples	Lista los ejemplos NUC disponibles por país (XML + JSON) con filtros por DocType, formato y variante.
get_example	Contenido completo (XML o JSON) de un ejemplo NUC real para usar como referencia.

Configuración por cliente

Copiá el JSON y pegalo en el archivo de configuración del cliente. Reinicialo y la conexión queda activa.

{
  "mcpServers": {
    "digifact": {
      "url": "https://documentacion.digifact.com/mcp/sse"
    }
  }
}

Autenticación: 2 pasos con tus credenciales TEST

Las consultas de contenido (endpoints, campos, catálogos, ejemplos…) requieren un access_token por país. Se obtiene con el tool country_login usando las credenciales de PRUEBA (TEST) del país — las mismas Username/Password del ambiente de pruebas de la API que Digifact entrega a todo cliente. Solo list_countries y get_country_info quedan abiertos sin token.

# Pedile a tu IA (ya conectada al MCP):
"Logueate en el MCP de Digifact con mis credenciales TEST de Guatemala:
 usuario GT.000000123456.MIUSUARIO, password ********"

→ La IA llama country_login { country: "gt", username, password }
→ Respuesta: {
    "access_token": "eyJhbGci…",
    "country": "gt",
    "expiresIn": "30d",          // igual que tu token del API
    "expiresAt": "2026-09-04T20:14:01Z"
  }

🔐

Tu password nunca se guarda: country_login solo lo valida contra el API de pruebas del país y lo descarta. Si no tenés credenciales TEST, pedilas a soporte — todo cliente Digifact las recibe al iniciar su integración.

✅

No interfiere con tus pruebas de certificación: el API de Digifact permite tokens simultáneos, así que hacer country_login no invalida el token con el que tu integración ya está certificando en el ambiente de pruebas. El access_token del MCP hereda el mismo vencimiento que informa el API de tu país.

📂

Rutas del archivo de configuración:
• Claude Desktop (Win): %APPDATA%\Claude\claude_desktop_config.json
• Claude Desktop (Mac): ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor: ~/.cursor/mcp.json
• Windsurf: ~/.codeium/windsurf/mcp_config.json

Probá que esté en línea

# Health check del servidor MCP
curl https://documentacion.digifact.com/mcp/health

Ejemplos de prompts

Una vez conectado, tu IA puede responder cosas como:

💬 “Armame un FCAM en JSON para un Consumidor Final con un ítem de Q150 + IVA”

💬 “Dame el template XML de una Nota de Crédito (NCRE) para exportación en Guatemala”

💬 “¿Qué complementos requiere un FACM y qué campos lleva cada uno?”

💬 “¿Qué tipos de DTE existen en El Salvador y cuándo se usa cada uno?”

💬 “Muéstrame un ejemplo real de factura electrónica de Panamá en JSON”

💬 “¿Cuáles son las tarifas de IVA vigentes en Costa Rica?”

💬 “¿Cómo certifico un e-CF en República Dominicana?”

💬 “Dame el cURL para anular un DTE en GT con NIT 123456”

💬 “Busca "contingencia" en toda la documentación”

Conecta tu IA a Digifact