@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 buildVariables 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 # RunPublicación a npm con versiones automáticas
Este repo usa Changesets + GitHub Actions.
Configuración inicial
- Crear el secret
NPM_TOKENen GitHub (Settings > Secrets and variables > Actions). - El token debe tener permisos para publicar en el scope
@integradte. - Si la organización exige 2FA para publish, usa un token con
bypass 2fa.
Flujo de versiones
- Para cada cambio que quieras versionar, crea un changeset:
pnpm changeset- Haz commit del archivo en
.changeset/*.mdjunto a tu cambio. - Al hacer merge a
main, el workflowReleasecrea/actualiza un PR de release con el nuevo versionado. - Cuando ese PR se mergea, el mismo workflow publica automáticamente a npm.