Documentación
Agentes (MCP)
Conecta Claude, ChatGPT o Cursor para emitir con tu aprobación.
Conecta un agente
Claude, ChatGPT, Cursor o cualquier cliente MCP emiten por ti con el servidor https://api.devfact.fonles.com/mcp. Agrega la URL y el cliente abre la pantalla de autorización de DevFact: eliges los permisos y, si quieres, el acceso a producción. Nunca pegues una clave API en un agente: el MCP usa tokens OAuth que se renuevan solos y que revocas en Claves API.
claude mcp add --transport http devfact https://api.devfact.fonles.com/mcp{
"mcpServers": {
"devfact": {
"url": "https://api.devfact.fonles.com/mcp"
}
}
}En Claude: Configuración → Conectores → Agregar conector personalizado, con la misma URL.
Herramientas
- preparar_comprobanteValida, calcula los totales en el servidor y devuelve un token de confirmación. No emite.
- emitir_comprobanteEmite exactamente lo preparado (el cliente te pide confirmación). Idempotente.
- consultar_comprobanteEstado, recorrido y, si el SRI lo rechazó, la causa con su solución.
- descargar_comprobanteRIDE (PDF) o XML autorizado mientras siga retenido.
- estado_cuentaTus emisores y qué le falta a cada uno.
| Herramienta | Qué hace |
|---|---|
| preparar_comprobante | Valida, calcula los totales en el servidor y devuelve un token de confirmación. No emite. |
| emitir_comprobante | Emite exactamente lo preparado (el cliente te pide confirmación). Idempotente. |
| consultar_comprobante | Estado, recorrido y, si el SRI lo rechazó, la causa con su solución. |
| descargar_comprobante | RIDE (PDF) o XML autorizado mientras siga retenido. |
| estado_cuenta | Tus emisores y qué le falta a cada uno. |
En producción puedes exigir tu visto bueno antes de que un agente emita: las solicitudes llegan a Aprobaciones (y al webhook
aprobacion.requerida). Sin cuenta, https://api.devfact.fonles.com/mcp/publico ofrece gratis validar identificaciones y calcular totales.
