Invoice4U MCP por Agente

Un servidor no oficial de terceros Model Context Protocol que brinda a cualquier agente compatible con MCP acceso seguro y tipado a una cuenta de Invoice4U: búsqueda de documentos y clientes, y creación de recibos vinculados a facturas pagadas.

• No oficial: esta es una integración comunitaria, no afiliada, respaldada ni soportada por Invoice4U. Los nombres de Invoice4U se usan de forma nominativa para describir a qué se conecta el servidor. No se utilizan marcas comerciales ni logotipos de Invoice4U sin permiso.

• TypeScript / Node.js 24 LTS / MIT · transporte stdio · autoalojado localmente: Agente nunca custodia tus credenciales de Invoice4U.

• Solo lectura por defecto: la única herramienta de escritura (creación de recibos) no está registrada en tools/list a menos que INVOICE4U_ALLOW_WRITES=true.

• Inglés README · Hebreo README.he.md

Inicio rápido

{
  "mcpServers": {
    "invoice4u": {
      "command": "npx",
      "args": ["-y", "@agente-dev/invoice4u-mcp"],
      "env": {
        "INVOICE4U_API_TOKEN": "your-api-key",
        "INVOICE4U_ENV": "qa",
        "INVOICE4U_ALLOW_WRITES": "false"
      }
    }
  }
}

INVOICE4U_ENV debe ser explícitamente qa o production; nunca se establece silenciosamente a production. Comienza con QA; es la configuración inicial segura y documentada.

Related MCP server: mcp-server-smallinvoice

Herramientas (superficie v0.1)

Las herramientas de lectura declaran readOnlyHint: true, idempotentHint: true. La herramienta de escritura declara readOnlyHint: false, destructiveHint: false, idempotentHint: true — la idempotencia se mantiene solo porque un apiIdentifier estable es obligatorio y los resultados duplicados o inciertos se resuelven mediante la búsqueda por identificador. Un tiempo de espera después de enviar una escritura nunca se reintenta a ciegas: el servidor primero consulta por apiIdentifier y reintenta solo cuando la búsqueda demuestra que no existe ningún documento.

El dinero se expresa como cadenas decimales en el límite de MCP ("12500.00"), nunca como flotantes de JavaScript. Las respuestas de Invoice4U que devuelven HTTP 200 mientras contienen errores de aplicación en la colección Errors se normalizan en un modelo de error tipado — nunca se reportan como éxito.

Configuración

Las credenciales viven solo en variables de entorno: el token nunca se acepta como argumento de herramienta, nunca se devuelve, nunca se registra.

Consulta .env.example. Solo se contactan hosts oficiales revisados de Invoice4U — no hay una vía de escape arbitraria de URL base.

Modelo de seguridad

• Solo lectura por defecto — la herramienta de escritura se omite por completo de tools/list a menos que las escrituras estén explícitamente habilitadas.

• Escrituras idempotentes — apiIdentifier estable obligatorio; reenviar la misma solicitud no puede crear un segundo recibo.

• Escrituras verificadas — cada escritura vuelve a obtener el recibo y las facturas referenciadas, devolviendo saldos y estados anteriores/nuevos como salida estructurada.

• Sin reintentos a ciegas en resultados de escritura inciertos; la resolución se realiza mediante la búsqueda de apiIdentifier.

• Higiene de secretos — sin tokens ni PII de clientes en los registros en niveles normales; los fixtures de QA no contienen datos reales de clientes.

• Sin movimiento de dinero — crear un recibo registra dinero ya recibido; el servidor no puede iniciar pagos ni cobrar tarjetas.

Estado

Implementado — superficie v0.1. Ocho herramientas (7 de lectura + 1 de escritura restringida) están implementadas y registradas como se describe en la tabla de Herramientas anterior. La cobertura se rastrea en coverage-manifest.json, con detalles en docs/.

• Estado de QA: las herramientas de lectura están verificadas contra la referencia de API de Invoice4U más pruebas de contrato (120 pruebas unitarias y de contrato en verde). La integración de QA en vivo está BLOQUEADA pendiente de credenciales — no hay sandbox público de Invoice4U, y ejercitar apiqa.invoice4u.co.il requiere una cuenta de organización de QA real + token de API. La prueba de humo restringida (tests/integration/qa.spec.ts) se omite sin token; consulta docs/qa-testing.md.

• Paquete npm pendiente: la publicación espera el enlace de publicación confiable para @agente-dev/invoice4u-mcp en npmjs.com.

Licencia

MIT — consulta LICENSE. © Agente Dev LTD. No afiliado con Invoice4U.