TicketBAI WS
Acceder Documentación
INICIO
Qué es TicketBAI Qué es Verifactu Cómo funciona Certificados electrónicos Preguntas frecuentes
FUNCIONALIDADES API
Guía rápida Ejemplos Terminal de pruebas Estado del servicio Servidor MCP
TARIFAS CONTACTO

Servidor MCP

Conecta tu asistente de IA (Claude, Cursor, VS Code…) a la API de Ticketbai WS con el Model Context Protocol. Cada método de la API es una herramienta: emite, consulta y anula facturas TicketBAI y Verifactu desde el chat.

Direcciones

EntornoURL del servidor MCP
Pruebashttps://api-test.ticketbaiws.eus/mcp-api
Producciónhttps://api.ticketbaiws.eus/mcp-api

Empieza siempre en pruebas. En producción las facturas tienen validez fiscal y se envían a Hacienda: pide al asistente que te confirme cada factura antes de emitirla.

Autenticación

Igual que la API REST: tu cliente MCP envía dos cabeceras HTTP, Token (el token de test o el real, según el entorno, en el área privada de la empresa) y Nif (el NIF de la empresa emisora). Si tu cliente solo permite Authorization, envía Authorization: Bearer TU_TOKEN junto con la cabecera Nif. Si tu cliente solo deja elegir cabeceras de una lista, usa X-API-Token para el token y X-Client-ID para el NIF.

El servidor no guarda tus credenciales ni accede a nada que no puedas hacer con la API: cada herramienta hace la misma llamada REST que harías tú, con los mismos límites de uso.

Configurar tu cliente

Claude Code

claude mcp add --transport http ticketbaiws-test https://api-test.ticketbaiws.eus/mcp-api \
  --header "Token: TU_TOKEN_DE_TEST" \
  --header "Nif: TU_NIF"

Claude Desktop y claude.ai

  1. En Ajustes → Conectores, añade un conector personalizado con la URL del servidor MCP.
  2. En autenticación elige sin inicio de sesión y, en cabeceras de la petición, añade X-API-Token con tu token y X-Client-ID con tu NIF.

La autenticación no se puede cambiar después de añadir el conector: si cambias de token, borra el conector y créalo de nuevo. En cuentas de empresa puede que solo un administrador pueda añadirlo, y entonces todos los usuarios comparten esas credenciales.

Cursor y otros clientes con configuración JSON

{
  "mcpServers": {
    "ticketbaiws-test": {
      "url": "https://api-test.ticketbaiws.eus/mcp-api",
      "headers": {
        "Token": "TU_TOKEN_DE_TEST",
        "Nif": "TU_NIF"
      }
    }
  }
}

El formato exacto cambia de un cliente a otro (por ejemplo, VS Code usa "servers" y "type": "http"). Lo importante es la URL y las dos cabeceras.

Ejemplos de lo que puedes pedir

Herramientas

Son los métodos de la documentación del API, con los mismos parámetros. Algunos métodos de gestión solo existen en producción.

Facturas TicketBAI / Verifactu

Verifactu: documento de representación

Batuz Bizkaia (LROE)

Webhooks, empresas y licencias

Buenas prácticas