Conectá tu asistente
al ERP.

MCP (Model Context Protocol) es un estándar abierto que le permite a un asistente de IA conectarse a un sistema y trabajar con sus datos reales, en vez de responder de memoria. Dicho de otro modo: en vez de copiar y pegar tus facturas dentro de un chat, le das al asistente una llave para que las consulte él mismo, con tus permisos y sobre tu empresa.

No hace falta instalar nada en tu computadora ni saber programar. Generás una credencial dentro del ERP, la pegás en la configuración de tu asistente, y listo.

Entrá a Configuración → Conexión IA y generá una credencial. Empieza con sipmcp_ y se muestra una sola vez: copiala en ese momento.

La credencial queda atada a tu usuario y a una empresa. Las herramientas que el asistente va a ver son exactamente las que tu rol te permite usar en el ERP: si no podés crear facturas, el asistente ni siquiera se entera de que existe proponer_factura. Ninguna herramienta recibe un identificador de empresa como parámetro, así que no hay forma de que el modelo consulte los datos de otra.

Podés revocar una credencial cuando quieras desde la misma pantalla. La revocación es inmediata.

Reemplazá sipmcp_TU_CREDENCIAL por la credencial que acabás de generar. La pantalla de Conexión IA te muestra este mismo bloque ya completado con tu credencial real.

Claude Desktop

Abrí Configuración → Desarrollador → Editar configuración, o editá directamente el archivo:

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

{
  "mcpServers": {
    "sipagentai": {
      "type": "http",
      "url": "https://app.sipagentai.com/api/mcp",
      "headers": { "Authorization": "Bearer sipmcp_TU_CREDENCIAL" }
    }
  }
}

Reiniciá Claude Desktop para que tome la configuración.

Claude Code

claude mcp add --transport http sipagentai \
  https://app.sipagentai.com/api/mcp \
  --header "Authorization: Bearer sipmcp_TU_CREDENCIAL"

Cursor

Usa el mismo formato que Claude Desktop, en ~/.cursor/mcp.json (global) o en .cursor/mcp.json dentro del proyecto.

Hay dos formas de autenticar un servidor MCP: con una credencial (API key), que es la de arriba y funciona hoy; y con OAuth, donde el asistente te manda a una pantalla de SIPAgentAI, iniciás sesión y autorizás el acceso sin copiar ninguna clave. OAuth es el camino que exigen los clientes web —claude.ai en el navegador y ChatGPT— porque ahí no podés escribir un archivo de configuración local.

El servidor de autorización ya está publicado. Un cliente MCP que reciba un 401 de https://app.sipagentai.com/api/mcp encuentra todo lo que necesita en /.well-known/oauth-protected-resource y /.well-known/oauth-authorization-server: se registra solo (registro dinámico, RFC 7591) y arranca el flujo con PKCE S256, que es obligatorio. La URL que se pega en el conector es la misma de siempre: https://app.sipagentai.com/api/mcp.

Los permisos que pide son dos, y son los mismos que gobiernan las herramientas: erp:lectura para consultar y erp:escritura para preparar y confirmar comprobantes, más offline_access para que la conexión no se caiga cada hora. El permiso efectivo es siempre la intersección con lo que tu rol ya podía hacer: autorizar erp:escritura no le da a nadie un permiso que no tenía.

Los nombres están en español porque es el idioma en el que un modelo razona mejor sobre el dominio fiscal ecuatoriano. Vas a ver solo las que tu rol habilita.

Consulta — 8 herramientas, solo lectura

Emisión — 3 herramientas

Un ejemplo de conversación completa: «buscá el cliente Comercial Andina, armale una factura por 3 horas de consultoría a $80 y mostrámela antes de emitir». El asistente encadena buscar_cliente, buscar_producto y proponer_factura, y se detiene ahí hasta que vos confirmes.

Desde el 1 de enero de 2026 la transmisión al SRI es inmediata, y las facturas a consumidor final (identificación 9999999999999) no se pueden anular ni corregir con nota de crédito una vez transmitidas (Resolución NAC-DGERCGC25-00000017, vigente desde el 1 de agosto de 2025). El plazo para pedir la anulación de un comprobante también se acortó; el ERP no lo verifica por código, así que ese dato hay que confirmarlo en el portal del SRI.

Un modelo que alucine un monto en ese contexto no genera un error corregible: genera un hecho tributario. Por eso ninguna herramienta de este servidor emite directamente.

1. El asistente llama proponer_factura o proponer_nota_credito. Se guarda un borrador con los totales calculados. No se emite nada, no se reserva número y el SRI no recibe nada.
2. El asistente te muestra el borrador. La propuesta caduca a los 30 minutos.
3. El asistente llama confirmar_emision con el proposalId. Recién ahí se firma, se transmite y existe fiscalmente.
4. confirmar_emision responde de inmediato, sin esperar la autorización del SRI. El estado final se consulta después con estado_comprobante.

Llamar confirmar_emision dos veces con el mismo proposalId emite un solo comprobante: la segunda vez devuelve el que ya se emitió.

El SRI tiene dos ambientes: pruebas y producción. Un comprobante emitido en producción es real: cuenta para tu declaración y no se deshace.

Toda credencial MCP nueva nace en ambiente de pruebas. Pasarla a producción es un acto deliberado de un administrador, con confirmación explícita, desde Configuración → Conexión IA. Es deliberado: la primera vez que conectás un asistente conviene que practique contra el ambiente de pruebas del SRI.

Hay dos valores de ambiente y no son el mismo: el de la credencial y el de la empresa. Un comprobante se considera de prueba solo cuando ambos lo son.

• No anula comprobantes ante el SRI. No existe una herramienta de anulación, a propósito: hoy la opción «anular» del ERP solo cambia el estado local del documento. Exponer una anulación que no anula sería peor que no tenerla — el asistente te diría que anuló algo que para el SRI sigue vivo. La anulación se tramita en el portal del SRI.
• No emite los otros cuatro comprobantes por MCP. Notas de débito, retenciones, guías de remisión y liquidaciones de compra se consultan por MCP, pero se emiten desde el ERP.
• No gestiona certificados. El certificado P12 y las credenciales del portal del SRI se cargan en el ERP.
• No cubre inventario, cartera ni contabilidad. El alcance actual es facturación, documentos electrónicos y el Formulario 104.

Si preferís HTTP directo en vez de MCP, el esquema OpenAPI describe la API REST de facturación. Se autentica con la sesión web, no con la credencial MCP.

• 401 / «falta el header Authorization» — la credencial no llegó, está mal copiada, fue revocada o expiró. Generá una nueva.
• 405 al abrir la URL en el navegador — es lo esperado. El endpoint solo atiende POST; no hay nada que ver ahí con el navegador.
• El asistente dice que el plan no incluye MCP — hace falta al menos el Plan Premium, o un período de prueba vigente. Se resuelve en Facturación.
• Falta una herramienta en la lista — tu rol no tiene el permiso correspondiente, o el módulo está apagado para tu empresa. Las herramientas que no corresponden se omiten del listado en vez de rechazarse, para que el modelo ni siquiera sepa que existen. Pedile al administrador del ERP que habilite la opción para tu rol.
• Una consulta tarda demasiado y se corta — acotá el rango de fechas o el límite de resultados.

• /llms.txt — índice de esta documentación en el formato de llmstxt.org.
• /openapi.json — esquema OpenAPI 3.1 de la API REST de facturación.
• /.well-known/skills/index.json — índice de Agent Skills publicadas.
• Skill facturacion-ecuador — las reglas del SRI Ecuador en un formato que un agente puede instalar: los seis comprobantes, códigos de IVA y de retención, casilleros del Formulario 104 y lo que quedó irreversible desde 2026.

¿Algo no funciona, o necesitas ayuda para conectar? soporte@sipagentai.com. Respondemos en español.

• Política de privacidad — qué datos se tratan, dónde se almacenan y con quién se comparten. Incluye la diferencia entre el asistente interno y la conexión MCP: por el camino MCP no enviamos tus datos a ningún proveedor de modelos.
• Términos de servicio — alcance, responsabilidades, planes y límites.