Herramientas y desarrolladores

Conectar Joinways a Claude (MCP)

Consulta y controla tus datos de Joinways desde Claude con el conector MCP, para análisis y acciones en lenguaje natural.

El conector MCP (Model Context Protocol) permite que un asistente como Claude acceda a tus datos de Joinways para responder preguntas y ejecutar acciones en lenguaje natural. En vez de hacer clic en la interfaz, preguntas « ¿Cuántos eventos este mes? » o « Crea un presupuesto para este cliente » y el asistente consulta o actúa sobre tu espacio por ti. Es una función avanzada, pensada para usuarios cómodos con las herramientas de IA.

Este artículo explica qué aporta concretamente el conector, cómo configurarlo de forma segura, qué puedes preguntar o pedirle que haga, y las precauciones a tomar, ya que da acceso a tus datos. El objetivo: aprovechar el asistente sin perder nunca el control de tu espacio.

Requisitos

  • Una cuenta de Joinways con acceso a los Ajustes de tu espacio de trabajo.
  • Un asistente compatible con MCP (por ejemplo Claude) donde introducir la configuración del conector.
  • El permiso de generar credenciales de conexión; suele estar reservado a los administradores.
  • Una soltura básica con las herramientas de IA y la noción de conector o integración.

Lo que aprenderás

  • Entender qué aporta el conector MCP.
  • Configurarlo de forma segura.
  • Conocer las preguntas y acciones posibles.
  • Gestionar y revocar las credenciales de conexión.
  • Adoptar los buenos usos y evitar los riesgos.

Para qué sirve

El conector convierte tu asistente en una superficie de pilotaje de Joinways en lenguaje natural. Haces una pregunta o das una instrucción; el asistente lee o modifica tus datos a través del conector, y luego te devuelve la respuesta.

  • Hacer preguntas sobre tus eventos y presupuestos en lenguaje natural.
  • Preparar análisis rápidos sin exportación manual.
  • Desencadenar ciertas acciones desde tu asistente.

Configurar el conector

La configuración consiste en generar credenciales del lado de Joinways, y luego introducirlas del lado del asistente. Una vez establecida la conexión, el asistente puede consultar y actuar sobre tu espacio dentro de los límites de los permisos concedidos.

  1. Ve a Ajustes y luego Integraciones / Herramientas.
  2. Genera las credenciales de conexión MCP.
  3. Introdúcelas en la configuración MCP de tu asistente (p. ej. Claude).
  4. Prueba la conexión con una pregunta sencilla (por ejemplo el número de eventos próximos).
  5. Conserva las credenciales en un lugar seguro, como secretos.
⚠️ A tener en cuenta: este conector da acceso a tus datos. Conserva las credenciales como secretos y revócalas ante la duda.

Referencia: lo que puedes preguntar y hacer

Estas son, en una línea cada una, las grandes familias de preguntas y acciones que el asistente puede tratar a través del conector.

  • Consultar y contar — eventos, presupuestos, empresas, personas, tareas y prospectos de tu espacio.
  • Buscar — encontrar un elemento por palabras clave mediante una búsqueda global.
  • Eventos — listar, consultar el detalle, crear, actualizar y cambiar el estado de un evento.
  • Presupuestos — listar, consultar, crear, duplicar, descargar un presupuesto y modificar sus líneas o su estado.
  • Empresas y personas — listar, buscar, crear y actualizar tus contactos y sociedades.
  • Tareas — listar, crear, actualizar y eliminar tareas de seguimiento.
  • Prospectos (leads) — listar, consultar, cambiar el estado y convertir un prospecto en evento.
  • Disponibilidad de los lugares — comprobar disponibilidades, bloquear o desbloquear fechas, listar conflictos.
  • Análisis — obtener indicadores comerciales, contables y de eventos sin exportación manual.
  • Correos — generar un borrador de correo o enviar un correo vinculado a un evento.
  • Catálogo — listar, crear, actualizar y eliminar elementos de catálogo.
  • Notas de evento — añadir y listar notas vinculadas a un evento.
  • Equipo y personal — listar los miembros del equipo y el personal asignado a un evento.
  • BEO y jornadas — consultar el guion (BEO) y las jornadas de un evento.
  • Notificaciones — listar tus notificaciones recientes.
  • Plantillas y conexiones de correo — listar las plantillas de correo y las conexiones de buzón disponibles.

Cómo funciona

Cuando formulas una petición, el asistente la traduce en llamadas al conector de Joinways. Para una pregunta, lee los datos y compone una respuesta; para una acción, llama a la herramienta correspondiente (crear un presupuesto, actualizar un estado, etc.). Las credenciales determinan el espacio objetivo y el alcance de los permisos; nada es accesible más allá de lo que esas credenciales permiten.

Tú sigues siendo el árbitro: relee las respuestas y confirma las acciones sensibles antes de validarlas, sobre todo cuando crean o modifican registros.

Casos particulares

  • Credencial compartida: si varias personas usan la misma credencial, pierdes la trazabilidad; prefiere credenciales distintas por persona cuando sea posible.
  • Acción involuntaria: una instrucción ambigua puede desencadenar una creación no deseada; reformula o anula la acción del lado de Joinways.
  • Credencial comprometida: ante la duda (filtración, dispositivo perdido), revoca la credencial de inmediato y genera una nueva.
  • Datos sensibles: el asistente ve lo que el conector expone; limita su uso a contextos de confianza.

Buenas prácticas

  • Limita el acceso a personas de confianza.
  • Revoca de inmediato una credencial comprometida.
  • Revisa las acciones sensibles antes de ejecutarlas.
  • Prueba primero en modo lectura (preguntas, análisis) antes de permitir acciones de escritura.
  • Mantén las credenciales fuera de mensajes y archivos compartidos.
  • Relee siempre el resumen de una acción de escritura antes de confirmarla.

Solución de problemas

Problema: el asistente no ve tus datos. Causa: las credenciales faltan o están mal introducidas del lado del asistente. Solución: regenera las credenciales en Ajustes y luego Integraciones / Herramientas y pégalas con cuidado en la configuración MCP.

Problema: una acción ha fallado o no ha hecho nada. Causa: la petición era ambigua o los permisos no cubren esa acción. Solución: reformula la petición con precisión y comprueba que la credencial usada tiene los permisos necesarios.

Problema: temes una filtración de credencial. Causa: credencial expuesta en un mensaje o un dispositivo no seguro. Solución: revócala de inmediato, genera una nueva, y actualiza la configuración del asistente.

Ejemplo concreto

Un responsable de sala quiere un repaso rápido el lunes por la mañana. Desde Claude conectado al conector, pregunta « ¿Cuántos eventos confirmados esta semana y qué facturación se prevé? ». El asistente consulta Joinways, cuenta los eventos y devuelve los indicadores comerciales, sin tener que abrir la interfaz ni exportar nada.

Acto seguido, pregunta « Crea una tarea de seguimiento para el presupuesto de la boda Martin ». El asistente crea la tarea en Joinways; él comprueba la confirmación antes de continuar.

Otro ejemplo

Al preparar un presupuesto, el gerente pide al asistente comprobar la disponibilidad de la sala principal para una fecha dada. El conector consulta la disponibilidad del lugar e indica que está libre; el gerente continúa con « Crea un presupuesto para este cliente con un alquiler de sala ».

El asistente crea el presupuesto y sus líneas a través del conector; el gerente lo descarga después para revisarlo antes de enviarlo.

Preguntas frecuentes

¿Hay que ser desarrollador?

No necesariamente, pero ayuda tener soltura con las herramientas de IA y la configuración MCP.

¿Qué asistente puedo conectar?

Cualquier asistente compatible con MCP, por ejemplo Claude, donde introduces la configuración del conector.

¿Qué puedo preguntar al asistente?

Consultar y contar tus eventos, presupuestos, empresas, personas, tareas y prospectos, y obtener análisis en lenguaje natural.

¿Qué acciones puedo desencadenar?

Crear o actualizar eventos, presupuestos, contactos y tareas, comprobar disponibilidades o generar correos, según tus permisos.

¿El conector puede modificar mis datos?

Sí, para las acciones de escritura autorizadas; relee y confirma las acciones sensibles antes de validar.

¿Cómo revoco el acceso?

Revoca la credencial desde Ajustes y luego Integraciones / Herramientas; el asistente pierde entonces el acceso de inmediato.

¿Mis credenciales son secretos?

Sí. Trátalas como contraseñas: no las compartas y regénéralas ante la duda.

¿El asistente accede a varios espacios?

El acceso se limita al espacio objetivo de las credenciales y al alcance de los permisos asociados; nada más allá es visible.

Véase también

  • Claves API
  • Seguridad y acceso

¿Listo para centralizar tus solicitudes de eventos?