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

Gestión de empresas y licencias: estos métodos se autentican con el token de desarrollador de tu cuenta de cliente (no con el de una empresa), así que tienen su propio servidor: https://api.ticketbaiws.eus/mcp-api/cuenta, con el token de desarrollador y el NIF de la cuenta en las mismas cabeceras. Añádelo como un segundo conector.

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.

Conectar tu asistente

Solo necesitas la URL. Al añadir el conector, tu asistente te abre una ventana de Ticketbai WS: inicias sesión con tu cuenta, eliges la empresa y das acceso. No tienes que copiar tokens ni configurar cabeceras.

Claude (claude.ai y Claude Desktop)

  1. En Ajustes → Conectores, añade un conector personalizado con la URL del servidor MCP.
  2. Pulsa Conectar, inicia sesión con tu cuenta de Ticketbai WS y elige la empresa.

ChatGPT

  1. Añade un conector personalizado con la URL del servidor MCP (según tu plan, puede que tengas que activar el modo desarrollador de los conectores).
  2. Elige autenticación OAuth, inicia sesión con tu cuenta de Ticketbai WS y elige la empresa.

Claude Code

claude mcp add --transport http ticketbaiws-test https://api-test.ticketbaiws.eus/mcp-api

Después, dentro de Claude Code, escribe /mcp y elige Authenticate para iniciar sesión.

Cursor, VS Code y otros clientes

Añade la URL del servidor MCP. Si tu cliente admite OAuth, te pedirá iniciar sesión; si no, usa las cabeceras (abajo).

Una conexión por empresa y entorno. El acceso que das vale solo para la empresa que eliges y solo para el entorno de la URL (pruebas o producción). Si gestionas varias empresas, añade un conector por empresa. Para la gestión de empresas y licencias usa https://api.ticketbaiws.eus/mcp-api/cuenta e inicia sesión con tu cuenta de cliente.

Alternativa: cabeceras con tu token

Para clientes sin OAuth o para automatizaciones, el servidor sigue aceptando el token de la empresa en cabeceras HTTP, como la API REST: Token y Nif. Si tu cliente solo deja elegir cabeceras de una lista, usa X-API-Token y X-Client-ID; si solo permite Authorization, envía Authorization: Bearer TU_NIF:TU_TOKEN.

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

El servidor no guarda tu token 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.

Ejemplos de lo que puedes pedir

Mira conversaciones completas, con las herramientas que usa el asistente, en los casos de uso del servidor MCP.

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

Documento de representación (Verifactu, Bizkaia, Gipuzkoa)

Batuz Bizkaia (LROE)

Webhooks, empresas y licencias

Factura electrónica B2B (SPFE)

Buenas prácticas