# SIPAgentAI

> ERP de facturación electrónica del SRI de Ecuador, con servidor MCP remoto.
> Emite los seis comprobantes electrónicos autorizados por el SRI, calcula el
> Formulario 104 (declaración mensual de IVA) y gestiona clientes, productos e
> inventario. Cualquier agente de IA puede conectarse por MCP y operar sobre los
> datos de una empresa, con emisión en dos fases y confirmación humana.

El servidor MCP vive en `https://app.sipagentai.com/api/mcp`. Transporte:
Streamable HTTP sin sesiones — **solo `POST`**; `GET` y `DELETE` responden 405,
no hay stream SSE. Los nombres de las herramientas están en español, porque es
el idioma del dominio fiscal ecuatoriano.

Autenticación, dos caminos. **API key:** `Authorization: Bearer sipmcp_...` con
una credencial que el usuario genera en el ERP (Configuración → Conexión IA);
es el camino soportado hoy, para Claude Desktop, Claude Code y Cursor.
**OAuth 2.1 + PKCE S256 con registro dinámico de clientes (RFC 7591):** el
descubrimiento ya está publicado en
`/.well-known/oauth-protected-resource` y `/.well-known/oauth-authorization-server`,
y los scopes son `erp:lectura`, `erp:escritura` y `offline_access`. Falta la
pantalla de consentimiento, así que el flujo todavía no se completa de punta a
punta: ver https://app.sipagentai.com/docs/mcp para el estado actualizado.

Cada credencial queda atada a **una** empresa. Ninguna herramienta recibe un
identificador de empresa como parámetro: no existe forma de que un modelo cambie
de empresa desde una llamada.

Antes de emitir cualquier cosa: ninguna herramienta de este servidor emite
directamente. `proponer_*` prepara un borrador y `confirmar_emision` lo
transmite. Las facturas a **consumidor final** (identificación `9999999999999`)
exigen además que una persona las apruebe con su sesión web del ERP; no existe
ningún parámetro que saltee ese paso, porque una factura a consumidor final no
se puede anular ni corregir con nota de crédito una vez transmitida al SRI
(Resolución NAC-DGERCGC25-00000017; la transmisión inmediata rige desde el
1-ene-2026). Este servidor **no expone** ninguna herramienta de anulación: ese
trámite se hace en el portal del SRI, y los plazos hay que verificarlos ahí —
el ERP no los implementa.

## Documentación

- [Conectar por MCP](https://app.sipagentai.com/docs/mcp): qué es MCP, cómo generar la credencial y el bloque JSON listo para pegar en Claude Desktop, Claude Code o Cursor.
- [Catálogo de herramientas](https://app.sipagentai.com/docs/mcp#herramientas): las 11 herramientas del servidor con sus parámetros y para qué sirve cada una.
- [Flujo de emisión en dos fases](https://app.sipagentai.com/docs/mcp#emision): proponer, revisión humana, confirmar, y por qué existe ese paso intermedio.
- [Ambiente de pruebas y producción](https://app.sipagentai.com/docs/mcp#ambientes): toda credencial nueva nace en pruebas.

## Conocimiento fiscal

- [Skill facturacion-ecuador](https://app.sipagentai.com/skills/facturacion-ecuador/SKILL.md): Agent Skill con las reglas del SRI Ecuador — los seis comprobantes y cuándo usar cada uno, códigos de IVA y de retención, casilleros del Formulario 104 y lo que quedó irreversible desde 2026.
- [Índice de skills publicadas](https://app.sipagentai.com/.well-known/skills/index.json): índice legible por máquina, con la URL estable de cada skill.

## API HTTP

- [Esquema OpenAPI](https://app.sipagentai.com/openapi.json): documento OpenAPI 3.1 de la API REST de facturación (creación de los seis comprobantes y emisión al SRI), generado desde los mismos esquemas de validación que usa el servidor. Autenticación por sesión web, no por credencial MCP.

## Producto

- [Inicio](https://app.sipagentai.com/): qué hace el ERP, módulos y planes.
- [Crear cuenta](https://app.sipagentai.com/register): alta con período de prueba.
- [Iniciar sesión](https://app.sipagentai.com/login): acceso al ERP.

## Optional

- [Configuración de la conexión IA](https://app.sipagentai.com/erp/configuracion/conexion-ia): pantalla del ERP donde se generan y revocan las credenciales MCP (requiere sesión).
- [Facturación y planes](https://app.sipagentai.com/admin/billing): el acceso por MCP requiere al menos el Plan Premium, o un período de prueba vigente (requiere sesión).