@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

Related MCP server: mcp-sii

Instalación

npm install
npm run build

Variables de entorno

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

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.