@integradte/mcp

MCP Server para consultar datos de facturación electrónica chilena desde la API IntegraDTE.

Permite a modelos de lenguaje (Claude, etc.) consultar documentos tributarios, folios, estadísticas y más mediante el protocolo MCP (Model Context Protocol).

Tools disponibles

Tool	Descripción
get_user_info	Info del usuario autenticado (nombre, email, estado)
get_certificate_info	Estado del certificado digital (vencimiento, titular)
list_documents	Listar DTEs con filtros (tipo, estado, fechas, paginación)
get_document	Detalle de un documento por ID
get_document_stats	Estadísticas: totales emitidos, montos, por tipo DTE
get_numeration_summary	Resumen de folios disponibles por tipo
get_last_folio	Último folio usado para un tipo de DTE

Instalación

npm install
npm run build

Variables de entorno

Variable	Descripción	Default
API_BASE_URL	URL de la API IntegraDTE	http://localhost:5058
API_KEY	API Key de autenticación (requerida)	—

Uso con Claude Desktop

Agregar a claude_desktop_config.json:

{
  "mcpServers": {
    "integradte": {
      "command": "npx",
      "args": ["-y", "@integradte/mcp"],
      "env": {
        "API_BASE_URL": "https://api.integradte.cl",
        "API_KEY": "tu_api_key"
      }
    }
  }
}

Uso con npx (una vez publicado)

{
  "mcpServers": {
    "integradte": {
      "command": "npx",
      "args": ["-y", "@integradte/mcp"],
      "env": {
        "API_BASE_URL": "https://api.integradte.cl",
        "API_KEY": "tu_api_key"
      }
    }
  }
}

Tipos de DTE soportados

Código	Tipo
33	Factura Electrónica
34	Factura Exenta
39	Boleta Electrónica
41	Boleta Exenta
46	Factura de Compra
52	Guía de Despacho
56	Nota de Débito
61	Nota de Crédito

Desarrollo

npm install
npm run dev    # Watch mode
npm run build  # Build
npm start      # Run

Publicación a npm con versiones automáticas

Este repo usa Changesets + GitHub Actions.

Configuración inicial

1. Crear el secret NPM_TOKEN en GitHub (Settings > Secrets and variables > Actions).
2. El token debe tener permisos para publicar en el scope @integradte.
3. Si la organización exige 2FA para publish, usa un token con bypass 2fa.

Flujo de versiones

1. Para cada cambio que quieras versionar, crea un changeset:

   pnpm changeset
   

2. Haz commit del archivo en .changeset/*.md junto a tu cambio.
3. Al hacer merge a main, el workflow Release crea/actualiza un PR de release con el nuevo versionado.
4. Cuando ese PR se mergea, el mismo workflow publica automáticamente a npm.