Los asistentes de IA dejaron de ser una novedad el día en que aprendieron a usar herramientas. Un asistente que puede leer los datos reales de tu club (socios, pedidos, páginas, partidos) responde preguntas de otra categoría que uno que solo puede hablar en términos generales. "¿Cómo debería un club recuperar a los socios con la cuota vencida?" es una entrada de blog. "¿Qué socios tienen la cuota vencida? Redacta el correo de renovación" es una tarde de trabajo de la comisión directiva resuelta antes de que se enfríe el café.
La tecnología que lo hace posible se llama Model Context Protocol (MCP): un estándar abierto que permite que un asistente de IA se conecte a un programa y use un conjunto definido de herramientas, cada una con sus permisos verificados. Esta guía explica cómo funciona en lenguaje sencillo y luego recorre, paso a paso, cómo conectar un asistente a un club de ClubHelix, con las salvaguardas que una comisión directiva de voluntarios debería exigir.
Qué es MCP, en términos de club
Piensa en MCP como una ventanilla de servicio para la plataforma de tu club. En lugar de darle tu contraseña a un asistente y dejar que recorra el panel de administración a su antojo (nunca hagas esto), la plataforma abre una ventanilla pequeña y bien iluminada, con un menú fijo de cosas que un asistente puede pedir: resumir el padrón de socios, listar los pedidos recientes, traer el contenido de esta página, guardar un borrador de noticia. Todo lo que no está en el menú, para el asistente, simplemente no existe.
Tres propiedades lo hacen seguro para un club:
- El menú lo fija la plataforma, no el asistente. Un asistente no puede inventar una opción de "eliminar a todos los socios"; si la plataforma no la puso en el menú, no se puede pedir.
- Cada solicitud se autentica y se verifica contra los permisos. La conexión usa un token vinculado a un administrador con nombre y apellido, y cada solicitud se vuelve a comprobar contra el rol actual de esa persona, no contra el rol que tenía cuando se creó el token.
- Se revoca con un clic. ¿Perdiste una laptop o simplemente terminaste el proyecto? Revoca el token y la conexión queda muerta en todas partes, al instante.
Qué puede hacer un asistente conectado en ClubHelix
El endpoint MCP de ClubHelix le da a un asistente conectado dos tipos de herramientas:
Lectura (siempre disponible): más de setenta herramientas de lectura que cubren el club: resúmenes del padrón (totales y socios al día, cifras agregadas en lugar de datos personales), pedidos y pagos, eventos y partidos, formularios, instalaciones, programas, entregabilidad del correo, las páginas de tu sitio web y su contenido, y una búsqueda en el registro de auditoría del propio club.
Cambios y publicación (solo lo que marques): la conexión tiene dos casillas, y dividen la decisión justo donde le importa a un club. Permitir cambios deja que un asistente cree y edite páginas, noticias y eventos: un borrador de noticia esperando en la sección Noticias del panel, un borrador de correo esperando sin enviar en el editor de difusiones, una edición de página ofrecida en el editor de páginas como propuesta para restaurar o descartar. No puede publicar ni despublicar, así que nunca puede poner algo nuevo en tu sitio ni quitar algo de él; y en las páginas de tu sitio web, incluso la edición de una página publicada se rechaza y se devuelve como borrador. Permitir publicar es el paso aparte, deliberado, que le deja hacer público ese trabajo y volver a retirarlo. Si lo dejas desmarcado, publicar sigue siendo una decisión humana. Marques lo que marques, cada cambio se te muestra como un plan y se confirma antes de que ocurra: un asistente no puede actuar sobre tu club por sorpresa.
Hay una frase que vale la pena tener a la vista de la comisión directiva, porque es estructural y no una configuración: hay más de 200 herramientas en la conexión y ninguna envía un correo ni un SMS, cobra un pago ni emite un reembolso. Un asistente al que le permitiste publicar una página sigue sin poder escribirle a un solo socio. Decidir hasta dónde llegar es una conversación aparte: qué alcance darle a un asistente de IA guía a la comisión directiva paso a paso.
Antes de conectar: tres preguntas para la comisión directiva
- ¿Quién es el responsable con nombre y apellido? La conexión actúa como un único administrador. Elige a alguien que rinda cuentas (por lo general, el secretario o el encargado del padrón), porque el registro de auditoría anotará la actividad del asistente a su nombre.
- ¿Solo lectura, o también cambios? Empieza con solo lectura. Marca Permitir cambios cuando la comisión directiva haya visto un mes de respuestas útiles y entienda el flujo de revisión, y trata Permitir publicar como una tercera decisión, posterior, y no como parte de la misma.
- ¿Cuál es el vencimiento? Trata los tokens como las llaves de la sede: 90 días es un valor razonable, con un recordatorio en el calendario para emitir uno nuevo. "Sin vencimiento" es para los clubes que tampoco cambian nunca la combinación del candado.
Paso a paso: conectar Claude a un club de ClubHelix
Necesitas ser administrador pleno de tu organización (en cualquier plan, incluido el plan Free; consulta los precios) y un asistente compatible con MCP. Claude es con el que hacemos las pruebas.
- Crea el token. En el panel de administración de tu club, abre Sistema → API y webhooks y busca Acceso del asistente de IA (MCP). Ponle al token un nombre según dónde va a estar ("Claude en la laptop del secretario"), elige un vencimiento (el predeterminado es 90 días) y deja desmarcadas por ahora las casillas Permitir cambios y Permitir publicar. Haz clic en Crear token.
- Cópialo de inmediato. El token se muestra una sola vez; después solo se guarda una huella digital, con la misma regla de una sola vez que una clave de API. Si lo pierdes, revócalo y crea otro.
- Agrega la conexión en el asistente. La página muestra el comando exacto para Claude; en resumen, consiste en darle al asistente la dirección MCP de tu club más el token en un encabezado de autorización. Pega el comando en una terminal (o sigue la pantalla de "agregar conector" de tu asistente) y listo. El token viaja en la configuración de la conexión: nunca lo pegues en un mensaje del chat.
- Pruébalo. Pregunta: "¿Como quién estás conectado y qué puedes ver?" El asistente debería indicar tu club, el administrador responsable y un alcance de solo lectura. Después prueba con una pregunta real: "Resume nuestro padrón de socios."
- (Más adelante) permite cambios. Cuando la comisión directiva esté lista, crea un segundo token con Permitir cambios marcado y revoca el primero. Pídele al asistente que redacte una noticia sobre los resultados del fin de semana y luego ve a buscarla: estará esperando, sin publicar, en la sección Noticias del panel. Si quieres que toque un área y ninguna otra, abre Limita a qué puede acceder este token y marca solo esa área: la página de noticias sin la tienda.
El modelo de seguridad, para quien haga las preguntas difíciles
Toda comisión directiva tiene a alguien que pregunta (con razón): "¿y qué le impide hacer tal cosa?". Esta es la respuesta honesta para ClubHelix, en sus propios términos:
- Limitado a tu club. Un token emitido por un club está fijado a tu organización. Pregúntale al asistente por cualquier otro club y la solicitud se rechaza: primero en la aplicación y, por debajo, con la misma seguridad a nivel de fila de la base de datos que separa los datos de cada club en la plataforma. No existe ninguna configuración en la que tu token lea los socios de otro club, ni el suyo lea los tuyos.
- Deja de funcionar cuando tú dejas de tener acceso. Cada solicitud vuelve a comprobar que el dueño del token sigue siendo administrador del club. Quítale el rol a ese administrador, o revoca el token, y la conexión se corta a mitad de la conversación. Cambiar de plan no la afecta: el acceso del asistente no depende del plan.
- Con límite de uso y registrado. Las solicitudes tienen un límite por token, y cada lectura y cada borrador quedan anotados en el registro de auditoría del club, con el nombre del dueño y el token utilizado.
- Sin contraseñas de por medio. El token no es tu contraseña y no sirve para iniciar sesión en el panel. Abre la ventanilla de servicio y nada más.
Nuestra lista de verificación de seguridad y privacidad de la IA convierte estos puntos en preguntas que puedes hacerle a cualquier proveedor, no solo a nosotros.
Para qué usarlo de verdad
Los clubes que le sacan provecho a un asistente conectado lo usan para tareas poco vistosas, cada semana:
- Preparar la reunión de la comisión: "Dame los números para el jueves: socios por estado, lo que falte enviar de la tienda y lo que cambió en el registro de auditoría esta semana."
- Temporada de renovaciones: "¿Cuántos socios tienen la cuota vencida comparado con esta misma fecha la temporada pasada? Redacta el correo de renovación." (Un borrador: quien lleva el padrón elige el público y lo envía.)
- Mantenimiento del sitio web: "Lista nuestras páginas y marca las que todavía mencionan la sede anterior. Redacta versiones corregidas de las dos peores."
- Traspaso de cargos: un nuevo secretario puede simplemente preguntar cómo están las cosas en lugar de descifrar las planillas de quien estaba antes; una solución real para el problema del club sin tiempo.
Preguntas frecuentes
¿Necesitamos a un programador para configurarlo?
No. Crear el token es una acción normal del panel de administración, y conectar el asistente es pegar un comando. Si tu club alguna vez configuró una dirección de correo propia, esto es más fácil.
¿Qué asistentes de IA funcionan con esto?
Cualquiera que hable MCP sobre HTTP y te permita configurar un encabezado de autorización: el estándar es abierto, pero esa segunda parte es la que decide. Hacemos las pruebas con Claude en la terminal, y la pantalla de conexión muestra el comando exacto para usarlo. Una app de chat cuya pantalla de conectores solo acepta una dirección web y luego intenta hacerte iniciar sesión no puede conectarse, porque aquí no hay ningún flujo de inicio de sesión que completar. Configurar la conexión en cada tipo de herramienta explica qué buscar.
¿El asistente puede ver los datos personales de los socios?
La herramienta del padrón devuelve cifras agregadas (conteos por estado y por situación de pago), no nombres, correos ni datos médicos. Los listados de pedidos muestran lo que un administrador vería en la pantalla de pedidos, porque el token actúa como ese administrador. El principio en todo momento: el asistente nunca puede ver más que la persona en cuyo nombre actúa, y por lo general ve mucho menos.
¿Qué pasa si alguien roba el token?
Tendría una llave con fecha de vencimiento que no sirve para iniciar sesión en el panel, que solo puede hacer lo que marcaste al crearla, que no puede enviar un correo ni un SMS ni mover dinero sin importar lo que hayas marcado, que tiene límite de uso, que anota cada acción en tu registro de auditoría y que deja de funcionar en el momento en que presionas Revocar, o en el momento en que se le quita el rol de administrador a su dueño. Compáralo con lo que podría hacer una contraseña de administrador robada y el objetivo del diseño queda claro: que el camino de la IA sea más seguro que el camino humano al que reemplaza.
