Tu asistente de IA, conectado a tu facturación
Cada espacio de trabajo tiene su propio servidor MCP (Model Context Protocol). Claude, o cualquier cliente compatible con MCP, puede consultar tus comprobantes, clientes y reportes, y preparar borradores en tu nombre con los permisos que tú apruebes.
Datos de conexión
| Campo | Valor |
|---|---|
| URL | https://tuempresa.factura.com.do/mcp |
| Transporte | Streamable HTTP, sin sesión |
| Autenticación | OAuth 2.1. factura.com.do es el servidor de autorización de tu subdominio, con registro dinámico de clientes: el asistente se registra solo, sin llaves que copiar |
| Alcance del token | Solo tu subdominio: un token de una empresa no sirve contra otra |
| Revocación | Surte efecto en la siguiente petición. Desactivar a un usuario corta también a su asistente |
| Clientes compatibles | Cualquier cliente MCP con OAuth y registro dinámico que reciba el código en una URL https o en http://127.0.0.1 (no localhost). Desde un navegador, hoy solo se permite el origen de Claude |
Cómo conectar Claude
- En Claude, abre Configuración → Conectores y agrega un conector personalizado con la URL de tu servidor MCP.
- Claude te lleva a la pantalla de inicio de sesión de tu espacio de trabajo. Entra con tu usuario.
- Revisa la pantalla de consentimiento: muestra la aplicación que pide acceso, el sitio al que se enviará y cada permiso. Si la sesión tiene más de 10 minutos, te pide la contraseña otra vez.
- Aprueba. Desde ese momento el asistente actúa como tú, con los permisos concedidos.
En Claude Code, el mismo servidor se agrega desde la terminal:
claude mcp add --transport http factura https://tuempresa.factura.com.do/mcpQué puede hacer
El servidor publica más de 60 herramientas. Se agrupan así:
| Consultar | Facturas, notas de crédito y débito, gastos, cotizaciones, conduces, consignaciones y documentos recibidos; clientes, proveedores y productos; pagos, reportes fiscales, reporte de ventas y compras, tablero, tasa de cambio y consulta de RNC. |
|---|---|
| Preparar | Borradores de factura, cotización, nota de crédito, nota de débito y gasto; clonar o convertir documentos; crear y editar clientes, proveedores y productos; registrar pagos. |
| Publicar y anular | Publicar un borrador (asigna el e-NCF y consume un folio) y anular facturas y gastos. Estos permisos se piden aparte, con su propia pantalla de consentimiento. |
| Enviar | Enviar un documento por correo. Tiene permiso propio porque saca datos de la empresa hacia fuera. |
| Módulos | Contabilidad, inventario y tesorería, solo si tu empresa tiene el módulo. Asientos y ajustes quedan en borrador; contabilizarlos es otro permiso. |
Permisos
Los permisos siguen la forma recurso:acción. Los de lectura y los de preparar borradores se piden al conectar; los de efecto fiscal o externo (documents:issue, documents:void, documents:send) se piden solo cuando hacen falta, con una pantalla de consentimiento propia.
| Permiso | Qué permite |
|---|---|
documents:read · clients:read · suppliers:read · products:read · payments:read · expenses:read · reports:read · catalogs:read | Leer |
documents:write · expenses:write | Crear y editar borradores |
clients:write · suppliers:write · products:write · payments:write | Crear y editar datos maestros; registrar pagos |
documents:issue | Publicar un borrador (irreversible) |
documents:void | Anular |
documents:send | Enviar por correo |
accounting:* · inventory:* · treasury:* | Módulos instalados: read, write y, en contabilidad e inventario, post para contabilizar |
Lo que no hace
- No firma ni envía comprobantes a la DGII. Publicar deja el documento listo; el envío a la DGII lo hace una persona desde la app.
- Un borrador publicado no se edita: solo se anula, y anular gasta otro folio.
- Sin elicitación: el servidor no le pide al asistente que te pregunte nada a mitad de una operación. La confirmación vive del lado del servidor (borradores y confirmaciones escritas).