Tu club ya tuvo la conversación difícil y llegó a una conclusión: sí, vamos a dejar que un agente de IA trabaje en la plataforma del club. La pregunta que decide si todo sale bien es más pequeña, más práctica y mucho más fácil de responder mal: ¿cuánta libertad le das y cómo lo decides?
Es una pregunta de gobernanza más que técnica, y en ClubHelix tiene una respuesta concreta. Al crear una conexión para un agente de IA ajustas dos controles. El primero es el alcance: leer, permitir cambios, permitir publicar. El segundo es una restricción que la mayoría de los clubes nunca abre y que limita una conexión a una parte del panel de administración: la página de noticias sin la tienda, por ejemplo. Si ajustas bien los dos, tu comisión directiva tiene algo que puede dejar en el acta, revisar en una fecha fija y retirar con un clic.
Esta guía trata de esos dos controles. No es la guía de configuración: conectar un asistente de IA a los datos de tu club explica cómo crear la conexión y pegar el comando. Tampoco es la lista de verificación del proveedor: las preguntas que conviene hacerle a un proveedor de IA antes de confiarle datos de socios están en seguridad y privacidad de la IA para clubes. Esta guía empieza donde terminan las otras dos, en el momento en que alguien mira el formulario y se pregunta qué casillas marcar.
Dónde están los controles
En el panel de administración de tu club, abre Sistema → API y webhooks y busca la tarjeta titulada Acceso del asistente de IA (MCP). Está disponible en todos los planes, incluido el gratuito; consulta los precios para ver qué más incluye cada uno. Hay una decisión de alcance que ya está tomada y no se puede activar: ningún token puede cambiar tu suscripción, tu facturación ni tu configuración de pagos, tenga el permiso que tenga su dueño en el panel. Esas son herramientas del personal de la plataforma. Crear una conexión ahí genera un token: una cadena secreta larga que el agente de IA presenta en cada solicitud, igual que una tarjeta de acceso identifica a una persona en la puerta.
El formulario es corto. Dale a la conexión un nombre que diga dónde vive ("Claude en la laptop del secretario"), elige cuándo vence, marca o deja sin marcar las dos casillas de alcance y, si quieres, abre Limita a qué puede acceder este token (opcional) para restringirla más. Esa es toda la decisión.
Algo que conviene saber antes de empezar a marcar: una conexión actúa como la persona que la creó. No es una cuenta nueva con poderes propios: hereda el rol y los permisos de esa persona y se vuelve a verificar contra ellos en cada solicitud.
Primer control: leer, cambiar o publicar
Dos casillas te dan tres alcances. Se suman: dejar las dos sin marcar es el más pequeño, marcar la primera agrega capacidades y marcar las dos agrega más.
Solo lectura: deja las dos casillas sin marcar
Todo club debería empezar aquí, y no es un gesto simbólico. Una conexión de solo lectura habilita unas 86 herramientas que trabajan con los datos de tu propia organización: socios, dinero, eventos, partidos, formularios, instalaciones, programas, entrega de correos y mensajes, registros de gobernanza y el propio registro de auditoría del club.
En la práctica, responde las preguntas que hoy tu comisión directiva contesta exportando tres planillas y entrecerrando los ojos. ¿Cuántos socios no renovaron desde que empezó la temporada? ¿Qué eventos vendieron menos lugares el año pasado, y en qué noches? ¿Qué cambió en nuestra página web en las últimas dos semanas, y quién lo cambió? ¿Nuestra última difusión llegó de verdad a la gente, o rebotó una buena parte?
Dos propiedades la hacen lo bastante segura como para aprobarla en una sola reunión. Primero, las herramientas de datos de socios devuelven totales agregados (cantidades por estado y por situación de pago), no nombres, direcciones de correo ni datos médicos. Un agente puede decirte que cuarenta y un socios tienen la cuota pendiente; no puede darte la lista de quiénes son. Segundo, las lecturas quedan auditadas. Aparecen en el registro de auditoría del club a nombre de la persona real con la que actúa la conexión, así que "¿qué estuvo mirando esto?" es una pregunta con respuesta y no un encogimiento de hombros.
El límite honesto es que la solo lectura no puede hacer nada por ti: te dirá que el boletín está atrasado, pero no lo va a escribir. Para la mayoría de las comisiones, un mes de exactamente eso es tiempo bien invertido, porque convierte una discusión abstracta sobre la IA en una lista concreta de tareas que al club le gustaría resolver.
Permitir cambios (crear y editar páginas, noticias y eventos)
Marca esta casilla y el agente puede empezar a producir trabajo. Puede crear y editar páginas, noticias y eventos, y puede ajustar la configuración, como el tema, la navegación y los ajustes.
Lo que no puede hacer es cambiar qué está en tu sitio y qué no. Publicar y despublicar necesitan la otra casilla, así que este alcance nunca puede mostrar algo nuevo a tus visitantes ni quitar algo, y eso lo impone la plataforma, no los buenos modales del agente. Una página nueva se crea como borrador al que ningún visitante puede llegar. En las páginas de tu sitio web la plataforma va todavía más lejos: reescribir una que ya está publicada cambiaría de inmediato lo que ven los visitantes, así que una conexión que solo puede hacer cambios recibe un rechazo directo y se la redirige al borrador.
Conviene ser preciso con este límite, porque es lo único que las comisiones entienden mal. Este alcance sí puede corregir el texto de una noticia o de un evento que ya está en el sitio público: esas herramientas dejan el estado intacto a propósito, así que una publicación visible sigue visible y cambian sus palabras. Normalmente eso es justo lo que quieres de un agente redactor, y no es lo mismo que prometer "nada de lo que haga será visible". Lo que en realidad prometiste al marcar una casilla y no la otra es que el agente no puede decidir qué se publica.
Hay un segundo freno. Todo cambio se ejecuta primero como prueba: la primera llamada del agente recibe una descripción de lo que pasaría, y no se escribe nada hasta que vuelve con una confirmación explícita. Así, una sesión siempre tiene la misma forma: el agente propone, una persona lee la propuesta, una persona da el visto bueno. Ese paso de revisión ocurre aunque nadie haya pensado en pedirlo.
Permitir publicar (hacer visibles los cambios al público)
Se suma a los cambios, así que marcarla te da ambos. Ahora el agente puede tomar el borrador que escribió y publicarlo, y, igual de importante, quitar algo o volver a una versión anterior. Una conexión con alcance de publicación es también una herramienta de reparación, no solo un riesgo.
Es un poder más acotado de lo que parece, y esta es la frase que conviene llevar a la reunión: un agente con permiso de publicación puede poner una página en línea y aun así no puede enviar ni un solo correo a un socio. Hay más de 200 herramientas en todo el endpoint y ninguna envía un correo o un SMS, cobra un pago ni emite un reembolso. Las herramientas de mensajería que existen son reportes de entrega, listas de bloqueo y lecturas de configuración. Un agente puede redactar una difusión; una persona presiona enviar. Ese límite está en el producto, no en tu documento de políticas, así que nadie tiene que acordarse de él.
Segundo control: limita a qué puede acceder este token
Debajo de las casillas hay una sección plegada titulada Limita a qué puede acceder este token (opcional). La mayoría de los clubes nunca la abre, y es el control que más ayuda a que un alcance más amplio resulte cómodo. Su propia explicación en pantalla lo dice mejor que nadie: "Si no marcas nada, el token puede hacer todo lo que tú puedes hacer. Si marcas algunas opciones, solo puede hacer esas cosas."
Adentro hay una casilla por permiso, agrupadas igual que tu panel de administración. Así puedes crear una conexión que pueda escribir noticias y nada más (ni la tienda, ni el padrón de socios, ni la configuración de pagos), aunque la persona que la creó acceda a todo eso a diario.
La regla que lo hace confiable es una intersección, y funciona en un solo sentido. Restringir nunca puede agregar capacidades. El poder real de una conexión es la superposición entre lo que puede hacer su dueño y lo que marcaste. Si el dueño es moderador, es una conexión de moderador por muchas casillas que marques. Si la limitas a noticias, es una conexión de noticias aunque su dueño administre toda la organización. Y si los permisos del dueño cambian el mes que viene, la conexión cambia con ellos: la verificación se hace en vivo en cada solicitud, no queda congelada en el momento en que se creó el token.
La lectura práctica: decide el alcance según la tarea, no según la persona. Es muy posible que el secretario tenga derecho a todo. La tarea que le das al agente es "mantener al día la página de noticias", así que marca noticias.
Una escalera por etapas que tu comisión puede votar
Esta es la moción. Tres etapas, cada una con algo para probar, algo para revisar después y una señal clara para retroceder. Suban un escalón por reunión, o quédense en uno indefinidamente: quedarse para siempre en la primera etapa es un resultado perfectamente respetable.
Primera etapa: un mes de solo lectura
Qué probar. Una conexión, las dos casillas sin marcar, con vencimiento a 90 días. Hazle las preguntas sobre las que tu comisión realmente discute: quién no renovó, qué eventos vendieron poco, qué cambió en el sitio el mes pasado, si la última difusión llegó. Lleven una nota compartida con las preguntas que dieron algo útil.
Qué revisar después. Abre el registro de auditoría y mira la actividad registrada a nombre del dueño. ¿El volumen coincide con el trabajo que le pidieron? ¿Alguien más usó la conexión de manera informal? ¿Alguna respuesta estuvo mal en algo importante, y alguien se dio cuenta?
Qué te haría retroceder. Respuestas muy seguras que resultan equivocadas, sin que nadie las verifique. En ese caso el problema no es el alcance: es que nada en tu proceso verifica lo que dice el agente, y un alcance más amplio solo lo empeoraría.
Segunda etapa: cambios activados, publicación desactivada
Qué probar. Crea una conexión con Permitir cambios marcado y Permitir publicar sin marcar, limitada a un área: noticias o eventos. Dale una tarea real con fecha límite: redactar las tres crónicas de partido antes del jueves, o armar el borrador de la página para la temporada de inscripciones de juveniles.
Qué revisar después. Lee lo que propuso antes de que nadie confirme nada. El paso de prueba garantiza que siempre hay un plan para leer; la pregunta es si una persona lo leyó de verdad o solo hizo clic. Después, juzga los borradores como lo haría un lector: ¿el tono es el de ustedes?, ¿las fechas son correctas?, ¿inventó algún detalle que nadie le dio?
Qué te haría retroceder. Que lleguen borradores más rápido de lo que alguien puede revisarlos. Ese es el modo de falla aquí: no un agente descontrolado, sino una fila de trabajo convincente aprobada sin mirar porque revisarla bien lleva más tiempo que el que llevó escribirla.
Tercera etapa: publicación, en un área acotada
Qué probar. Una conexión con publicación activada, limitada a la única área donde el hábito de revisión de la segunda etapa sea más sólido. La mayoría de los clubes elige noticias, porque una noticia es lo de menor riesgo en la página web de un club y lo más fácil de corregir en público.
Qué revisar después. Compara el sitio publicado con lo que la comisión esperaba que estuviera publicado. Verifica que alguien siga leyendo el registro de auditoría cada mes. Confirma que las áreas que no abriste siguen cerradas: una conexión restringida vale lo que vale su restricción, así que vuelve a revisar las casillas.
Qué te haría retroceder. Que se publique algo que la comisión no había aprobado, aunque sea una sola vez. La solución no es un sermón: es revocar la conexión y volver a crearla un escalón más abajo, lo que lleva más o menos un minuto.
El marco de gobernanza
El alcance es la decisión. El marco es lo que permite revisar esa decisión seis meses después, cuando la persona que la tomó ya dejó la comisión.
Nombra un responsable, y dilo en voz alta
Una conexión actúa como una persona. Elige a alguien que rinda cuentas: lo habitual es el secretario o el encargado de registros, y si tu comisión nunca dejó por escrito quién se ocupa de qué, los roles y responsabilidades de la comisión directiva son el punto de partida. El registro de auditoría anota la actividad del agente a nombre de esa persona, y eso es una ventaja, no un accidente: siempre hay una persona que responde por lo que hizo la conexión.
La conexión también hereda sus límites. Y como la verificación de permisos se hace en vivo, el día que esa persona deja de ser administradora, la conexión deja de funcionar sin que nadie tenga que acordarse. Revócala de todos modos: una conexión que no es de nadie es una conexión que nadie revisa.
Usa el vencimiento como aviso de revisión, no como trámite
El formulario ofrece 30 días, 90 días, 1 año o Nunca, y por defecto marca 90 días. Acepta ese valor. Noventa días es más o menos un ciclo de la comisión, y eso convierte un ajuste de seguridad en algo más útil: un punto fijo del orden del día que pregunta cuatro veces al año "¿esto sigue haciendo lo que aprobamos?".
"Nunca" es la opción que, sin que nadie lo note, sobrevive a la comisión que la eligió. Si eliges un vencimiento largo, agenda tú mismo la revisión: la alternativa es una llave que funciona para la plataforma de tu club guardada en una laptop que dejó el club hace dos temporadas.
La revocación es la verdadera red de seguridad
Un clic termina una conexión en todas partes, al instante: es la respuesta a una laptop perdida, un proyecto terminado, un voluntario que se va o una comisión que cambió de opinión. Volver a crearla lleva un minuto, así que no hay motivo para dudar: primero revoca, después discute. Trátalo igual que el código del candado del club cuando alguien devuelve su llave.
La nota honesta sobre la verificación en dos pasos
Hay un límite que conviene decir con claridad en lugar de esconderlo. Un token de conexión omite la solicitud de verificación en dos pasos que recibe una persona al iniciar sesión desde el navegador. Así funciona toda credencial de API: el token es la credencial, así que no hay un segundo paso que pedir. Por eso mismo importan los otros tres controles: el token vence, se puede revocar con un clic y todo lo que hace queda auditado a nombre de una persona concreta. No descuides ninguno de los tres.
Otro límite que conviene dejar en el acta con honestidad: la conexión tiene un límite de 120 solicitudes por minuto, así que un agente descontrolado choca contra una pared en lugar de llegar a toda tu base de datos.
Qué escribir en el acta
Que sean cinco líneas. Una moción así de corta es una que una comisión futura puede aplicar:
- Qué se aprobó: "una conexión de agente de IA con la plataforma del club con alcance de solo lectura", o "cambios, limitados a noticias, publicación desactivada".
- Quién es el responsable: la persona con nombre y apellido, y el hecho de que el registro de auditoría anota la actividad del agente a su nombre.
- Cuándo vence: la fecha, y quién la vuelve a crear.
- Cuándo se revisa: la reunión en la que la comisión mira el registro de auditoría y decide si sube, se queda o retrocede.
- Quién puede revocarla: idealmente cualquier miembro de la comisión, sin necesidad de reunirse.
Eso es una política. Cabe en una página, nombra a una persona y tiene una fecha, que es más de lo que reciben la mayoría de las decisiones tecnológicas.
Preguntas frecuentes
¿Puede un agente de IA borrar a nuestros socios o cobrarles dinero?
No. Nada en la conexión envía un correo o un SMS, cobra un pago ni emite un reembolso: esas herramientas no existen, así que no se pueden pedir. La información de socios llega como totales agregados, no como nombres ni datos de contacto, y cada cambio se verifica contra lo que puede hacer el dueño, se ejecuta primero como prueba antes de escribirse y queda en el registro de auditoría.
¿Le damos una conexión a toda la comisión o una a cada persona?
Una a cada persona, con el nombre del lugar donde vive. Crear conexiones no cuesta nada y revocarlas tampoco, y un secreto compartido es uno del que nadie responde. Las conexiones separadas también hacen que el registro de auditoría se pueda leer: cuando dos personas trabajan con agentes, quieres saber cuál hizo qué. Y si dos tareas necesitan alcances distintos (solo lectura para el tesorero, solo noticias para el voluntario de comunicación), son dos conexiones, no una solución a medias.
¿Y si el agente hace algo que no esperábamos?
Primero revoca la conexión; un clic lo detiene todo al instante. Después lee el registro de auditoría, que anota lo que pasó a nombre del dueño. Si el agente publicó algo, el historial de la página se conserva, así que se puede restaurar una versión anterior. Luego decidan si el alcance estaba mal, si la restricción era demasiado generosa o si se relajó el hábito de revisión, y vuelvan a crear la conexión un escalón más abajo mientras lo resuelven.
¿Necesitamos entender la tecnología para aprobar esto?
No más de lo que necesitas entender de cerraduras para decidir quién recibe una llave. El modelo útil es este: la plataforma publica un menú fijo de cosas que un agente puede pedir y rechaza todo lo demás; tus dos controles deciden cuánto de ese menú ve esta conexión. Para los detalles, las páginas de integraciones y de acceso para agentes de IA explican cómo está construida la conexión, y nuestra página de seguridad cubre los controles de la plataforma que hay debajo.
¿Cómo sabemos que un agente no está llegando a los datos de otro club?
La conexión queda vinculada a tu organización cuando se crea. Las herramientas que trabajan con toda la plataforma la rechazan directamente, las herramientas que reciben el nombre de una organización rechazan cualquier nombre que no sea el tuyo, y la propia base de datos es la última barrera: filtra las filas a tu organización sin importar lo que pida la aplicación. Son tres rechazos separados en lugar de un solo ajuste, porque un control que depende de una sola verificación tiene un único punto de falla.
