Agentes con MCP

Fiscalbase tiene un servidor MCP, el protocolo con el que los agentes de IA usan herramientas externas. Conectas tu agente con una API key y le pides en tus palabras lo que harías en la consola: «factura a Ferretería El Sol dos taladros», «¿qué me devolvió el SRI este mes?», «haz una nota de crédito por el taladro que devolvieron».

Cada herramienta que el agente usa es una llamada a la API con tu API key: su ambiente, su permiso y su límite de solicitudes valen igual que en tu propio sistema, y los comprobantes que emite aparecen en la consola con el origen MCP.

ConéctateCopiar enlace a esta sección

El servidor está en https://mcp.fiscalbase.io/mcp y recibe tu API key en el encabezado Authorization. No hay una pantalla de inicio de sesión: la API key es todo.

Guarda la API key en una variable de entorno, por ejemplo FISCALBASE_API_KEY, y nunca la pegues en una conversación.

claude mcp add --transport http fiscalbase https://mcp.fiscalbase.io/mcp \
  --header "Authorization: Bearer $FISCALBASE_API_KEY"

{
  "mcpServers": {
    "fiscalbase": {
      "type": "http",
      "url": "https://mcp.fiscalbase.io/mcp",
      "headers": { "Authorization": "Bearer ${FISCALBASE_API_KEY}" }
    }
  }
}

Qué API key darleCopiar enlace a esta sección

Dale al agente una API key propia, para revocarla sin tocar tus otros sistemas. Cada API key es de un solo negocio: el agente emite con ese RUC y no puede elegir otro. Para que trabaje con otro negocio, créale una API key en él.

1. Empieza en Sandbox (fb_sandbox_…). El agente practica con el negocio de práctica de esa API key y un SRI simulado: nada tiene validez tributaria y puede equivocarse sin consecuencias.
2. Sigue en Pruebas (fb_test_…) para que el SRI de pruebas revise tus datos reales, también sin validez tributaria.
3. En Producción, usa el permiso Sin emitir en Producción (no_live_issuing). El agente consulta, busca, resume y prepara, pero no ve las herramientas que emiten, y la API rechaza esas llamadas aunque alguien las intente por fuera.

En Sandbox el agente emite apenas se lo pides. En Pruebas te muestra el resumen y espera tu sí. En Producción, además, cada comprobante y cada acción que no se deshace te piden confirmación (mira Producción); si el agente nunca debe emitir allí, dale la API key con el permiso Sin emitir en Producción.