Conectar tu asistente de IA a Buky (MCP)

Miguel Gómez Pérez · Equipo Bukyapp· 7 min de lectura·Actualizado 16 sept 2026

Conecta Claude Code o Claude Desktop a tu cuenta de Buky por MCP con un token de API y consulta o gestiona tu catálogo en lenguaje natural.

Buky ofrece un servidor MCP (Model Context Protocol) para que un asistente de inteligencia artificial como Claude trabaje directamente con tu cuenta: consultar disponibilidad y precios, revisar el calendario de una actividad, buscar clientes y reservas, o incluso crear y editar productos si tú se lo permites. Todo en lenguaje natural, desde el chat que ya usas.

Esta guía te explica qué puede hacer el asistente, cómo crear el token que le da acceso y cómo conectarlo paso a paso.

Atajo: en un minuto

Si ya usas Claude Code, no hace falta leer más. Crea un token de solo lectura en Configuración > API Tokens (paso 1 de esta guía) y pégale esto a tu asistente, con tu token en lugar de bk_TU_TOKEN:

Conéctate al servidor MCP de Buky: transporte HTTP, dirección https://api.bukyapp.com/mcp,
cabecera "Authorization: Bearer bk_TU_TOKEN". Cuando estés conectado, ejecuta whoami y dime quién soy.

El asistente se configura solo y te confirma tu cuenta. El resto de la página explica qué puede hacer, cómo conectarlo en otros clientes y qué hacer si algo falla.

Antes de empezar

• Tu cuenta necesita el complemento API y MCP activo. Se contrata desde Configuración > Suscripción, en el apartado de complementos.
• Necesitas ser administrador de la cuenta: solo los administradores pueden crear, ver y revocar tokens. Consulta Gestionar usuarios y permisos si tienes dudas sobre tu rol.
• Para Claude Code basta con tenerlo instalado. Para Claude Desktop necesitas además tener instalado Node.js en tu ordenador.

Qué puede hacer el asistente

Una vez conectado, el asistente ve un catálogo de operaciones de Buky con el manual de cada una. Entre otras:

• Consultar: qué días puede venir un grupo a una actividad, qué sesiones quedan con plazas, cuánto costaría una reserva, qué actividades, alojamientos, packs y alquileres tienes, qué extras y categorías, datos de un cliente o de una reserva.
• Construir y mantener tu catálogo (solo con un token de escritura): crear y editar actividades, alojamientos, packs, alquileres, extras, temporadas y tarifas, personal, localizaciones, cupones, formularios o automatizaciones, con las mismas reglas y validaciones que el panel.

Lo que no hace:

• Reservar. Reservar no es una operación del asistente. Cuando le preguntas por disponibilidad, te devuelve el enlace a tu motor de reservas con la fecha y las personas ya rellenas, para que la reserva la haga quien corresponda, con su pago y su confirmación.
• Tocar lo que un token nunca puede tocar: usuarios del panel, reembolsos, métodos de pago y suscripción, ni los propios tokens. Aunque el token sea de escritura.

Antes de ejecutar una operación de escritura el asistente puede hacer una prueba en seco (sin guardar nada). Y los borrados solo se ejecutan si tú los has pedido de forma explícita en la conversación: si el asistente cree que necesita borrar algo por su cuenta, te preguntará antes.

Paso a paso

1. Crea un token de API

Ve a Configuración y, en el bloque Configuración del panel izquierdo, entra en la pestaña API Tokens (lleva la etiqueta BETA).

En el bloque Nuevo token de API, escribe un nombre que identifique el uso, por ejemplo «Asistente de IA», y decide el permiso:

• Solo lectura (casilla «Permitir escritura» desmarcada): el asistente puede consultar, pero no cambia nada. Es lo recomendable para empezar.
• Escritura (casilla marcada): además puede crear y modificar productos, clientes y configuración, como lo haría un administrador. Resérvalo para cuando quieras que el asistente trabaje en tu catálogo.

Si marcas «Permitir escritura», Buky te avisa: ese token hay que guardarlo con el mismo cuidado que una contraseña de administrador.

Pulsa Crear token. Aparece el aviso Token creado con el token, una cadena que empieza por bk_, y un icono para copiarlo. Cópialo ahora: solo se muestra esta vez. Si pulsas Entendido sin copiarlo, revoca ese token y crea otro.

En la lista Tokens activos verás el permiso de cada uno en la columna Acceso. La lista conserva también los revocados, tachados y con la etiqueta «Revocado».

Para más detalle sobre tokens, consulta Conectar Buky con herramientas externas (API Tokens).

2. Conecta tu cliente

La dirección del servidor MCP de Buky es:

https://api.bukyapp.com/mcp

Elige la herramienta que uses. Todas se conectan a la misma dirección; solo cambian los pasos.

Claude Code (terminal)

Ejecuta este comando sustituyendo bk_TU_TOKEN por tu token:

claude mcp add --transport http buky https://api.bukyapp.com/mcp \
  --header "Authorization: Bearer bk_TU_TOKEN"

Comprueba la conexión con claude mcp list. Debe aparecer así:

buky: https://api.bukyapp.com/mcp (HTTP) - ✔ Connected

Claude Desktop (aplicación de escritorio)

Claude Desktop necesita un pequeño puente llamado mcp-remote, que se descarga solo la primera vez y requiere Node.js. Abre el fichero de configuración de la aplicación:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Y añade Buky dentro de mcpServers, sustituyendo bk_TU_TOKEN por tu token:

{
  "mcpServers": {
    "buky": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.bukyapp.com/mcp",
        "--header", "Authorization: Bearer bk_TU_TOKEN"
      ]
    }
  }
}

Guarda el fichero y reinicia Claude Desktop. Buky aparecerá entre las herramientas conectadas.

claude.ai (web) y ChatGPT

Sus conectores personalizados solo admiten servidores con autorización OAuth, así que de momento no se pueden conectar con un token. Usa Claude Code o Claude Desktop hasta que esté disponible la conexión con un clic.

3. Comprueba que funciona

Pregúntale al asistente «¿Quién soy en Buky?». Debe responder con el nombre de tu cuenta y si el token es de solo lectura o de escritura. Es la operación whoami y conviene hacerla siempre al conectar.

Después, algo real sobre tu negocio:

• «¿Qué días de octubre puede venir un grupo de 4 personas a [nombre de una actividad]?»
• «¿Cuánto costaría reservar [actividad] para 2 adultos el sábado que viene?»
• «Dame la lista de mis actividades activas.»
• «Busca al cliente [nombre] y dime qué reservas tiene.»

Si el asistente encuentra varias actividades con nombre parecido, te pedirá que elijas: nunca adivina.

Cómo trabaja el asistente con Buky

Al conectar, el asistente recibe tres herramientas: whoami (quién eres y qué permisos tienes), describe-operation (el manual de una operación: qué parámetros necesita y qué devuelve) y run-operation (ejecutar una operación). Dentro de esta última viene el índice completo de operaciones, así que el asistente sabe qué puede hacer sin que tú se lo expliques.

Cuando le pides algo, consulta el manual de la operación, la ejecuta con tu token y te cuenta el resultado. Cada respuesta indica si fue una prueba en seco o una ejecución real.

Seguridad

El token del asistente es una credencial de tu cuenta: dale solo lectura salvo que necesites que escriba, usa uno distinto por herramienta y revócalo cuando dejes de usarlo. Y no lo pegues nunca en un chat: va solo en el comando o en el fichero de configuración. Las buenas prácticas completas están en Conectar Buky con herramientas externas (API Tokens).

Preguntas frecuentes

No veo la pestaña API Tokens en Configuración.

Tu cuenta no tiene activo el complemento API y MCP, o tu usuario no es administrador. Actívalo desde Configuración > Suscripción o pide a un administrador que lo haga.

Claude Code dice «Failed to connect» y menciona un error 401.

El token no es válido: está mal copiado, revocado, caducado o pertenece a otra cuenta. Crea un token nuevo y vuelve a ejecutar el comando de conexión. Si tienes varias cuentas de Buky, comprueba que el token es de la cuenta correcta con la pregunta «¿Quién soy en Buky?».

El asistente dice que no puede crear ni modificar nada.

Tu token es de solo lectura. Con él, el asistente aún puede preparar la operación en modo prueba para enseñarte qué haría, pero no guardarla. Si de verdad quieres que escriba, crea un token nuevo con «Permitir escritura» marcado y cambia la configuración del cliente. Piensa antes si lo necesitas: la mayoría de consultas no requieren escritura.

¿Puede el asistente hacer una reserva por mí?

No. Te da el enlace al motor de reservas con la fecha y las personas rellenas, y la reserva se completa allí, con su pago y confirmación.

He dado de baja el complemento. ¿Qué pasa con la conexión?

Los tokens dejan de funcionar en el momento en que el complemento no está activo. Al reactivarlo vuelven a funcionar sin crear otros nuevos.

¿Qué ve el asistente de mi cuenta?

Solo los datos de la cuenta a la que pertenece el token, con el mismo alcance que tendría un administrador consultando el panel. Nunca datos de otras cuentas de Buky.