--- title: "Servidor MCP para Claude y otras IA" description: "Conecta Claude u otro asistente compatible con MCP a tu espacio de trabajo: OAuth 2.1, permisos por área y borradores que una persona revisa." canonical: https://factura.com.do/desarrolladores/mcp lang: es generator: factura.com.do docs-index --- Servidor MCP # 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 | Tu URL: https://tuempresa.factura.com.do/mcp `tuempresa` es un ejemplo: cámbialo por el subdominio con el que entras a la app. ## Cómo conectar Claude 1. En Claude, abre Configuración → Conectores y agrega un conector personalizado con la URL de tu servidor MCP. 2. Claude te lleva a la pantalla de inicio de sesión de tu espacio de trabajo. Entra con tu usuario. 3. 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. 4. 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: terminal ``` claude mcp add --transport http factura https://tuempresa.factura.com.do/mcp ``` ## Qué 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). Revisa lo que concedes El registro de clientes es abierto: cualquiera puede registrar una aplicación con el nombre que quiera. La pantalla de consentimiento avisa cuando una aplicación no está verificada y muestra el sitio al que irá el acceso. Hoy solo Claude (`claude.ai` y `claude.com`) figura como verificado; las demás aplicaciones funcionan, con el aviso. ## Siguientes pasos Siguiente paso ## Continúa por aquí - [ API REST Integración máquina a máquina con X-Api-Key. ](/desarrolladores/autenticacion) - [ Ciclo del e-CF Qué pasa después de publicar un comprobante. ](/desarrolladores/ciclo-ecf) - [ Webhooks Entérate cuando la DGII responde. ](/desarrolladores/webhooks)