recibo.ecMCP | Guía de integración

Conecta tu asistente de IA con tus comprobantes del SRI en recibo.ec y pregúntale en tus palabras: cuánto compraste, a quién y en qué. El acceso es de solo lectura, tú lo autorizas al conectar y lo revocas cuando quieras desde tu cuenta.

Requisito: una cuenta en recibo.ec. Con correo o Google necesitas una cédula o RUC verificado en el portal; con tu clave del SRI entras directo con ese RUC.

Conéctalo a tu asistente

Claude (web, escritorio o móvil)

1. Abre Ajustes > Conectores y elige "Añadir conector personalizado".
2. Pega la dirección de arriba (no hace falta Client ID ni Secret) e inicia sesión.
3. En un chat, actívalo desde el botón "+" > Conectores.

Claude Code (terminal)

claude mcp add --transport http recibo https://mcp.recibo.ec/mcp

Luego ejecuta /mcp dentro de la sesión para iniciar sesión. Con --scope user queda en todos tus proyectos.

ChatGPT (modo desarrollador)

1. Ajustes > Aplicaciones y conectores > Ajustes avanzados: activa "Modo de desarrollador" (planes Plus, Pro, Team, Enterprise o Edu).
2. En Conectores, "Crear": pega la dirección de arriba y elige autenticación "OAuth".
3. Permite la ventana emergente de autorización y habilita el conector en el chat.

Cursor, VS Code y LM Studio (un clic)

O a mano. Cursor y LM Studio (mcp.json):

{ "mcpServers": { "recibo.ec": { "url": "https://mcp.recibo.ec/mcp" } } }

VS Code (mcp.json; ojo: la clave raíz es "servers"):

{ "servers": { "recibo.ec": { "type": "http", "url": "https://mcp.recibo.ec/mcp" } } }

Windsurf

{ "mcpServers": { "recibo.ec": { "serverUrl": "https://mcp.recibo.ec/mcp" } } }

En ~/.codeium/windsurf/mcp_config.json o desde el panel de Plugins.

Gemini CLI

{ "mcpServers": { "recibo": { "httpUrl": "https://mcp.recibo.ec/mcp" } } }

En ~/.gemini/settings.json. El OAuth se descubre solo: al primer uso abre el navegador.

Codex CLI

[mcp_servers.recibo]
url = "https://mcp.recibo.ec/mcp"

En ~/.codex/config.toml y luego: codex mcp login recibo

Otros clientes

Cualquier cliente MCP con soporte de servidores remotos (Streamable HTTP + OAuth) funciona con la misma dirección. Para clientes que solo hablan stdio, usa el puente mcp-remote:

{ "mcpServers": { "recibo.ec": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.recibo.ec/mcp"] } } }

Con pnpm: pnpm dlx mcp-remote https://mcp.recibo.ec/mcp. Para probar y depurar: pnpm dlx @modelcontextprotocol/inspector (transporte "Streamable HTTP").

Qué puede consultar

Herramienta	Para qué sirve
identidades_disponibles	Lista las cédulas/RUC con las que esta conexión puede consultar.
consultar_comprobantes	Listado paginado con filtros: tipo (facturas, notas de crédito/débito, liquidaciones, retenciones), fechas, proveedor, producto, montos.
resumen_compras	KPIs del periodo: total, impuestos, ticket promedio, tops y serie diaria.
principales_proveedores	Ranking de proveedores por monto.
resumen_productos	Qué productos se compraron, cantidad y monto (solo facturas).
comprobantes_por_categoria	Distribución del gasto por categoría (solo facturas).
buscar_contraparte	Resuelve un nombre a RUC/cédula para filtrar por proveedor o cliente.
comprobante_por_clave	Documento completo (detalle línea por línea, impuestos, formas de pago) por su clave de acceso de 49 dígitos.
enlace_pdf	Enlace al PDF imprimible (RIDE) de un comprobante.

Cómo funciona el acceso

• OAuth 2.1 con registro automático de clientes y PKCE S256 obligatorio; alcance único comprobantes:leer (solo lectura).
• Inicias sesión con correo + código, Google o tu clave del SRI (se valida contra el SRI y no se guarda en texto plano).
• Cada consulta se limita a tus identidades verificadas; con varias, el asistente debe indicar cuál usar.
• Revocas el acceso por aplicación desde tu cuenta.
• Metadatos para clientes: recurso protegido y servidor de autorización.

Preguntas de ejemplo

• "¿Cuánto gasté en junio y cuánto fue IVA?"
• "¿Quiénes fueron mis 5 principales proveedores del semestre?"
• "¿Cuánto llevo gastado en combustible este año?"
• "Lista mis facturas de más de 500 dólares del trimestre."
• "¿Qué compré exactamente en esa factura? Dame el PDF."

Volver al inicio | llms.txt para asistentes | recibo.ec