Ir al contenido

Conectar Claude o ChatGPT

Conecta Claude, ChatGPT u otra app de IA a tu cuenta de Bookline con la dirección del MCP y tu usuario del portal.

Puedes conectar una app de IA a Bookline para preguntarle por tus llamadas, tus agentes, tus locales, tus campañas y tus métricas, y para que haga algunos cambios por ti. No tienes que copiar ninguna clave en la app: le das una dirección, entras con tu usuario del portal y eliges con qué clave trabajará.

La app trabaja con una de tus claves de API. Las claves se gestionan en el portal, en el menú Administración → Claves de API; la opción solo aparece si tu usuario puede leer al menos un cliente. Si todavía no tienes ninguna clave, podrás crearla durante la conexión.

  1. En la app, añade un conector o servidor MCP personalizado con esta dirección:

    https://api.bookline.ai/mcp
    • Claude (web, escritorio y móvil): en Ajustes → Conectores, añade un conector personalizado.
    • ChatGPT: crea un conector personalizado (necesitas un plan que lo permita).
    • Otras apps compatibles con MCP: añade un servidor MCP remoto con la misma dirección. Funcionan las que siguen la especificación de autorización de MCP.
  2. La app abre la página de Bookline Conectar una app a Bookline. Si no has iniciado sesión, entra con tu usuario del portal.

  3. Comprueba qué app se conecta y a dónde vuelves al conectar (ver Apps verificadas).

  4. Elige con qué clave trabajará la app, o crea una nueva en ese momento.

  5. Pulsa Conectar. Vuelves a la app y ya puedes preguntarle.

La página indica si Bookline ha verificado la app:

  • Claude y ChatGPT aparecen con su nombre y la marca Verificada.
  • Cualquier otra app aparece con la dirección web a la que vuelves al conectar, marcada como No verificada y con un aviso. Cualquiera puede ponerle cualquier nombre a una app: fíate de la dirección, no del nombre. Si no la reconoces, cancela.

La app puede hacer exactamente lo que puede hacer la clave que eliges, nada más: los mismos permisos y los mismos locales.

  • Solo puedes elegir una de tus propias claves personales. Una clave de cuenta o una de otra persona no sirve.
  • Una app conectada con una clave del equipo de Bookline puede leer, pero nunca cambiar datos.

La app ve estas herramientas, cada una una ruta de la API. Solo obtiene respuesta en las que su clave tiene permiso.

Ámbito Leer Cambiar
Métricas export_metrics
Locales list_venues, get_venue update_venue
Llamadas list_calls, get_call
Agentes list_agents, get_agent update_agent (cambiar el nombre)
Bases de conocimiento list_knowledge_bases, get_knowledge_base create_knowledge_base, update_knowledge_base, delete_knowledge_base
Campañas list_campaigns, get_campaign, list_campaign_runs, get_campaign_run pause_campaign
Números de teléfono list_numbers, get_number
Integraciones list_integrations, get_integration
Facturación list_invoices, get_invoice, list_billing_services

Las herramientas que cambian datos siguen las mismas reglas que las escrituras de la API: la app lee antes el recurso y envía la versión que leyó, así que un cambio decidido sobre una lectura desactualizada se rechaza y se le pide a la app que vuelva a leer. Una creación lleva un id de petición, así que un reintento nunca crea dos veces. Para escribir hace falta una clave con el permiso :write correspondiente, que caduca en 90 días como máximo. Una app no puede quitar un valor (como la web de un local): hazlo a través de la API o en el portal.

Las apps que has conectado aparecen en el portal, en Administración → Claves de API, sección Apps conectadas, con la clave con la que trabaja cada una.

  • Para quitarle el acceso a una app, pulsa Desconectar.
  • Desconectar la app, revocar su clave o que la clave caduque corta la conexión en un minuto, aproximadamente.
  • Una conexión que no se usa durante 30 días caduca. La app te pedirá que vuelvas a iniciar sesión.

Si tu app MCP permite añadir cabeceras propias, también puedes conectarla a la misma dirección enviando tu clave en la cabecera apikey, como en el resto de la API (ver Claves y permisos). En ese caso la app no aparece en Apps conectadas: para cortarle el acceso, revoca la clave.