Siigo MCP

MCP Server Siigo

Servidor MCP (Model Context Protocol) para integrar la API de Siigo Nube con Claude y otros clientes MCP.

Instalacion

git clone https://github.com/Gopenux/Siigo-MCP.git
cd Siigo-MCP
npm install
npm run build

Configuracion

Obtener Credenciales de Siigo

1. Ingresa a tu cuenta de Siigo Nube
2. Ve a Alianzas > Mi Credencial API
3. Copia tu username (email) y access_key

Configuracion en Claude Code (CLI)

Agrega la siguiente configuracion a tu archivo ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "siigo": {
      "command": "node",
      "args": ["/ruta/a/Siigo-MCP/dist/index.js"],
      "env": {
        "SIIGO_USERNAME": "tu_usuario@empresa.com",
        "SIIGO_ACCESS_KEY": "tu_access_key_aqui"
      }
    }
  }
}

Ubicacion del archivo de configuracion:

• macOS/Linux: ~/.claude/claude_code_config.json
• Windows: %USERPROFILE%\.claude\claude_code_config.json

Tambien puedes configurarlo por proyecto creando un archivo .mcp.json en la raiz de tu proyecto:

{
  "mcpServers": {
    "siigo": {
      "command": "node",
      "args": ["./node_modules/mcp-server-siigo/dist/index.js"],
      "env": {
        "SIIGO_USERNAME": "tu_usuario@empresa.com",
        "SIIGO_ACCESS_KEY": "tu_access_key_aqui"
      }
    }
  }
}

Configuracion en Claude Desktop

Agrega la siguiente configuracion a tu archivo claude_desktop_config.json:

Ubicacion del archivo:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "siigo": {
      "command": "node",
      "args": ["/ruta/a/Siigo-MCP/dist/index.js"],
      "env": {
        "SIIGO_USERNAME": "tu_usuario@empresa.com",
        "SIIGO_ACCESS_KEY": "tu_access_key_aqui"
      }
    }
  }
}

Variables de Entorno (Alternativa)

Tambien puedes configurar las credenciales como variables de entorno del sistema:

export SIIGO_USERNAME="tu_usuario@empresa.com"
export SIIGO_ACCESS_KEY="tu_access_key_aqui"

Y luego en la configuracion omitir el bloque env:

{
  "mcpServers": {
    "siigo": {
      "command": "node",
      "args": ["/ruta/a/Siigo-MCP/dist/index.js"]
    }
  }
}

Uso

Una vez configurado, las herramientas de Siigo estaran disponibles en Claude. Puedes:

• Listar, crear, actualizar y eliminar productos
• Gestionar clientes/terceros
• Crear y consultar facturas de venta
• Gestionar cotizaciones
• Crear notas credito
• Registrar facturas de compra
• Crear recibos de caja y pagos
• Generar comprobantes contables
• Consultar reportes financieros
• Administrar webhooks

Herramientas Disponibles

Autenticacion

• siigo_authenticate - Genera token de autenticacion

Productos

• siigo_list_products - Lista productos
• siigo_get_product - Obtiene un producto
• siigo_create_product - Crea un producto
• siigo_update_product - Actualiza un producto
• siigo_delete_product - Elimina un producto

Grupos de Inventario

• siigo_get_account_groups - Lista clasificaciones de inventario
• siigo_create_account_group - Crea clasificacion
• siigo_update_account_group - Actualiza clasificacion

Clientes

• siigo_list_customers - Lista clientes
• siigo_get_customer - Obtiene un cliente
• siigo_create_customer - Crea un cliente
• siigo_update_customer - Actualiza un cliente

Facturas de Venta

• siigo_list_invoices - Lista facturas
• siigo_get_invoice - Obtiene una factura
• siigo_create_invoice - Crea una factura
• siigo_update_invoice - Actualiza una factura
• siigo_delete_invoice - Elimina una factura
• siigo_annul_invoice - Anula una factura
• siigo_get_invoice_pdf - Obtiene PDF
• siigo_get_invoice_xml - Obtiene XML
• siigo_send_invoice_email - Envia por email
• siigo_get_invoice_stamp_errors - Consulta errores DIAN
• siigo_create_invoice_batch - Crea facturas en lote

Cotizaciones

• siigo_list_quotations - Lista cotizaciones
• siigo_get_quotation - Obtiene una cotizacion
• siigo_create_quotation - Crea una cotizacion
• siigo_update_quotation - Actualiza una cotizacion
• siigo_delete_quotation - Elimina una cotizacion

Notas Credito

• siigo_list_credit_notes - Lista notas credito
• siigo_get_credit_note - Obtiene una nota credito
• siigo_create_credit_note - Crea una nota credito
• siigo_get_credit_note_pdf - Obtiene PDF

Facturas de Compra

• siigo_list_purchases - Lista compras
• siigo_get_purchase - Obtiene una compra
• siigo_create_purchase - Crea una compra
• siigo_update_purchase - Actualiza una compra
• siigo_delete_purchase - Elimina una compra

Recibos de Caja

• siigo_list_vouchers - Lista recibos
• siigo_get_voucher - Obtiene un recibo
• siigo_create_voucher - Crea un recibo

Recibos de Pago/Egreso

• siigo_list_payment_receipts - Lista recibos de pago
• siigo_get_payment_receipt - Obtiene un recibo de pago
• siigo_create_payment_receipt - Crea un recibo de pago
• siigo_delete_payment_receipt - Elimina un recibo de pago

Comprobantes Contables

• siigo_list_journals - Lista comprobantes
• siigo_create_journal - Crea un comprobante

Reportes

• siigo_test_balance_report - Balance de prueba general
• siigo_test_balance_by_thirdparty - Balance por tercero
• siigo_accounts_payable - Cuentas por pagar

Catalogos

• siigo_get_taxes - Impuestos
• siigo_get_users - Usuarios/vendedores
• siigo_get_document_types - Tipos de documentos
• siigo_get_payment_types - Formas de pago
• siigo_get_warehouses - Bodegas
• siigo_get_cost_centers - Centros de costo
• siigo_get_price_lists - Listas de precio
• siigo_get_fixed_assets - Activos fijos

Webhooks

• siigo_list_webhooks - Lista webhooks
• siigo_create_webhook - Crea webhook
• siigo_update_webhook - Actualiza webhook
• siigo_delete_webhook - Elimina webhook

Monitoreo Automatico de Documentacion

Este repositorio incluye un workflow de GitHub Actions que monitorea automaticamente los cambios en la documentacion oficial de Siigo API en Apiary.

Como funciona

1. Ejecucion programada: El workflow se ejecuta diariamente a las 9:00 AM UTC (4:00 AM hora Colombia)
2. Descarga y comparacion: Descarga la documentacion desde https://siigoapi.docs.apiary.io/api-description-document y compara el hash MD5 con el archivo local siigoapi.apib
3. Notificacion: Si detecta cambios, crea automaticamente un issue en GitHub con:

- Resumen de los cambios (diff) - Menciones a los responsables - Labels: documentation, api-changes, backlog

Configuracion inicial

1. Configurar labels: Ejecuta manualmente el workflow Setup Repository Labels para crear las labels necesarias

1. Menciones configuradas: El workflow notificara automaticamente a @jannortiz, @carlosdazag y @helysm cuando se detecten cambios.

1. Ejecucion manual: Puedes ejecutar el workflow manualmente desde la pestana Actions > "Check Siigo API Documentation Changes" > "Run workflow"

Archivo de documentacion

El archivo siigoapi.apib contiene la copia local de la documentacion de Siigo API en formato API Blueprint. Este archivo se usa como referencia para detectar cambios.

Licencia

MIT