O seu clube já teve a conversa difícil e chegou a uma conclusão: sim, vamos deixar um agente de IA trabalhar na plataforma do clube. A pergunta que decide se isso vai dar certo é menor, mais prática e muito mais fácil de errar: quanta liberdade você dá a ele, e como decide isso?
É uma questão de governança, não técnica, e no ClubHelix ela tem uma resposta concreta. Criar uma conexão para um agente de IA define dois controles. O primeiro é o escopo: leitura, permitir alterações, permitir publicação. O segundo é uma restrição que a maioria dos clubes nunca abre, que limita uma conexão a uma parte do painel: a página de notícias sem a loja, por exemplo. Acerte os dois, e a sua diretoria terá algo que pode registrar em ata, revisar em uma data definida e revogar com um clique.
Este guia trata desses dois controles. Ele não é o passo a passo de configuração: conectar um assistente de IA aos dados do seu clube explica como criar a conexão e colar o comando. Também não é a lista de verificação de fornecedores: as perguntas a fazer a um fornecedor de IA antes de confiar a ele informações dos sócios estão em segurança e privacidade de IA para clubes. Este guia começa depois dos dois, no momento em que alguém está olhando o formulário e se perguntando quais caixas marcar.
Onde ficam os controles
No painel do clube, abra Sistema → API e webhooks e encontre o cartão Acesso de assistente de IA (MCP). Ele está disponível em todos os planos, inclusive no Free; veja os planos e preços para saber o que mais cada um inclui. Uma decisão de escopo já vem tomada e não pode ser marcada: nenhum token pode alterar a sua assinatura, a cobrança ou as configurações de pagamento, seja o que for que o dono dele possa fazer no painel. Essas são ferramentas da equipe da plataforma. Criar uma conexão ali gera um token: uma longa sequência secreta que o agente de IA apresenta a cada solicitação, do mesmo jeito que um cartão de acesso identifica uma pessoa na porta.
O formulário é curto. Dê à conexão um nome que diga onde ela fica ("Claude no notebook do secretário"), escolha quando ela expira, marque ou deixe desmarcadas as duas caixas de escopo e, se quiser, abra Limitar o que este token pode acessar (opcional) para restringi-la ainda mais. Essa é a decisão inteira.
Uma coisa para saber antes de começar a marcar: a conexão age como a pessoa que a criou. Ela não é uma nova conta com poderes próprios; herda a função e as permissões dessa pessoa e é verificada de novo em relação a elas a cada solicitação.
Controle um: ler, alterar ou publicar
Duas caixas de seleção dão três escopos. Eles se somam: deixar as duas desmarcadas é o menor, marcar a primeira acrescenta a ele, marcar as duas acrescenta de novo.
Somente leitura: deixe as duas caixas desmarcadas
É por aqui que todo clube deve começar, e está longe de ser um gesto simbólico. Uma conexão somente leitura libera cerca de 86 ferramentas que trabalham com os dados da sua própria organização, cobrindo sócios, dinheiro, eventos, jogos, formulários, espaços, programas, entrega de e-mails e mensagens, registros de governança e o próprio registro de auditoria do clube.
Na prática, ele responde às perguntas que a sua diretoria hoje responde exportando três planilhas e forçando a vista. Quantos sócios não renovaram desde o início da temporada? Quais eventos venderam menos vagas no ano passado, e em quais noites? O que mudou no nosso site nos últimos quinze dias, e quem mudou? O nosso último comunicado chegou mesmo às pessoas, ou uma parte voltou?
Duas características tornam isso seguro o bastante para ser aprovado em uma única reunião. Primeiro, as ferramentas de dados de sócios devolvem números agregados (contagens por situação e por situação de pagamento), não nomes, endereços de e-mail ou dados médicos. Um agente pode dizer que quarenta e um sócios estão com a taxa em aberto; não pode entregar a lista de quem são. Segundo, as leituras são auditadas. Elas ficam no registro de auditoria do clube em nome da pessoa real pela qual a conexão age, então "o que essa coisa andou olhando?" é uma pergunta com resposta, e não um dar de ombros.
O limite honesto é que a leitura não faz nada por você: ela avisa que o boletim está atrasado, mas não o escreve. Para a maioria das diretorias, um mês exatamente assim é tempo bem gasto, porque transforma uma discussão abstrata sobre IA em uma lista concreta de tarefas que o clube gostaria de ver feitas.
Permitir alterações (criar e editar páginas, notícias, eventos)
Marque esta caixa e o agente pode começar a produzir. Ele pode criar e editar páginas, notícias e eventos, e pode ajustar configurações como o tema, a navegação e as preferências.
O que ele não pode fazer é mudar o que está e o que não está no seu site. Publicar e despublicar exigem a outra caixa, então este escopo nunca pode colocar algo novo diante dos visitantes nem tirar algo do ar, e isso é garantido pela plataforma, não pela boa educação do agente. Uma página nova é criada como rascunho, que nenhum visitante consegue acessar. Nas páginas do site, a plataforma vai além: reescrever uma página que já está no ar mudaria imediatamente o que os visitantes veem, então uma conexão só com alterações é recusada de cara e direcionada ao rascunho.
Seja preciso quanto ao limite, porque é a única coisa que as diretorias erram aqui. Este escopo pode corrigir o texto de uma notícia ou de um evento que já está no site público: essas ferramentas deixam o status de propósito como está, então uma notícia no ar continua no ar e o texto dela muda. Normalmente é exatamente isso que você quer de um agente de redação, e não é a mesma promessa que "nada do que ele faz fica visível". A promessa que você realmente fez ao marcar uma caixa e não a outra é que o agente não pode decidir o que é publicado.
Existe um segundo freio. Toda alteração passa primeiro por uma simulação: a primeira chamada do agente recebe uma descrição do que aconteceria, e nada é gravado até que ele volte com uma confirmação explícita. Então o formato de uma sessão é sempre o mesmo: o agente propõe, uma pessoa lê a proposta, uma pessoa dá o sinal verde. Essa etapa de revisão acontece mesmo que ninguém tenha pensado em pedi-la.
Permitir publicação (tornar as alterações visíveis ao público)
Esta caixa se soma às alterações, então marcá-la dá as duas coisas. Agora o agente pode pegar o rascunho que escreveu e colocá-lo no ar e, tão importante quanto, tirar algo do ar ou voltar a uma versão anterior. Uma conexão com escopo de publicação é uma ferramenta de conserto, além de um risco.
É um poder mais restrito do que parece, e esta é a frase que vale levar para a reunião: um agente com escopo de publicação pode colocar uma página no ar e, ainda assim, não consegue enviar um único e-mail a um sócio. Existem mais de 200 ferramentas no endpoint inteiro, e nenhuma delas envia e-mail ou SMS, recebe um pagamento ou faz um reembolso. As ferramentas de mensagens que existem são relatórios de entrega, listas de supressão e leituras de configuração. Um agente pode redigir um comunicado; um ser humano aperta o botão de enviar. Esse limite está no produto, não no seu documento de política, então ninguém precisa se lembrar dele.
Controle dois: limitar o que este token pode acessar
Abaixo das caixas de seleção fica uma seção recolhida chamada Limitar o que este token pode acessar (opcional). A maioria dos clubes nunca a abre, e é o controle que mais ajuda a deixar um escopo mais amplo confortável. A própria explicação na tela é a versão mais clara: "Não marque nada e o token pode fazer tudo o que você pode. Marque algumas opções e ele poderá fazer só essas coisas."
Dentro dela há uma caixa por permissão, agrupada do mesmo jeito que o seu painel. Assim, você pode criar uma conexão que só pode escrever notícias, e nada mais: nem a loja, nem o quadro de sócios, nem as configurações de pagamento, mesmo que a pessoa que a criou acesse tudo isso todos os dias.
A regra que torna isso confiável é uma interseção, e ela só funciona em um sentido. Restringir nunca acrescenta capacidade. O poder real de uma conexão é a sobreposição entre o que o dono pode fazer e o que você marcou. Se o dono é moderador, a conexão é de moderador, por mais que você marque. Se você a restringe a notícias, ela é uma conexão de notícias, mesmo que o dono administre a organização inteira. E se as permissões do dono mudarem no mês que vem, a conexão muda junto: a verificação acontece em tempo real a cada solicitação, em vez de ficar congelada no momento em que o token foi criado.
A leitura prática: defina o escopo pela tarefa, não pela pessoa. O secretário pode muito bem ter direito a tudo. A tarefa que você está entregando ao agente é "manter a página de notícias atualizada", então marque notícias.
Uma escada em etapas para a sua diretoria votar
Aqui está a proposta. Três etapas, cada uma com algo para testar, algo para verificar depois e um sinal claro para recuar. Suba um degrau por reunião, ou fique em um deles indefinidamente: ficar para sempre na primeira etapa é um resultado perfeitamente respeitável.
Etapa um: um mês somente leitura
O que testar. Uma conexão, as duas caixas desmarcadas, expirando em 90 dias. Faça a ela as perguntas sobre as quais a sua diretoria realmente discute: quem não renovou, quais eventos venderam pouco, o que mudou no site no mês passado, se o último comunicado chegou. Mantenha uma nota compartilhada de quais perguntas deram resultado útil.
O que verificar depois. Abra o registro de auditoria e veja a atividade registrada em nome do dono. O volume corresponde ao trabalho que vocês pediram? Alguém mais usou a conexão informalmente? Alguma resposta estava errada de um jeito que importava, e alguém percebeu?
O que faria você recuar. Respostas confiantes que se revelam erradas, sem ninguém conferindo. Nesse caso, o problema não é o escopo: é que nada no seu processo verifica o que o agente diz, e um escopo mais amplo só agravaria isso.
Etapa dois: alterações ativadas, publicação desativada
O que testar. Crie uma conexão com Permitir alterações marcada e Permitir publicação desmarcada, restrita a uma área: notícias ou eventos. Dê a ela uma tarefa real com prazo: redigir os três relatos de jogo antes de quinta-feira ou montar o rascunho da página da temporada de inscrições das categorias de base.
O que verificar depois. Leia o que ele propôs antes que alguém confirmasse qualquer coisa. A etapa de simulação garante que sempre há um plano para ler; a questão é se uma pessoa o leu de verdade ou só clicou para seguir. Depois, avalie os rascunhos como um leitor faria: o tom é o de vocês, as datas estão certas, ele inventou algum detalhe que ninguém forneceu?
O que faria você recuar. Rascunhos chegando mais rápido do que alguém consegue revisar. Essa é a falha típica aqui: não um agente rebelde, mas uma fila de trabalho plausível aprovada sem olhar, porque revisar direito leva mais tempo do que escrever levou.
Etapa três: publicação, em uma única área restrita
O que testar. Uma conexão, publicação ativada, restrita à única área em que o hábito de revisão da etapa dois é mais forte. A maioria dos clubes escolhe notícias, porque uma notícia é o item de menor risco no site de um clube e o mais fácil de corrigir em público.
O que verificar depois. Compare o site no ar com o que a diretoria esperava que estivesse no ar. Confira se alguém ainda lê o registro de auditoria todo mês. Confirme que as áreas que vocês não abriram continuam fechadas: uma conexão restrita só é tão boa quanto a sua restrição, então releia as marcações.
O que faria você recuar. Qualquer coisa indo ao ar sem que a diretoria tivesse concordado, mesmo que uma única vez. A solução não é um sermão: é revogar a conexão e criar outra um degrau abaixo, o que leva mais ou menos um minuto.
A estrutura de governança
O escopo é a decisão. A estrutura em volta é o que mantém essa decisão revisável seis meses depois, quando quem a tomou já saiu da diretoria.
Nomeie um responsável e diga isso em voz alta
Uma conexão age como uma pessoa. Escolha alguém que responda por ela: secretário ou responsável pelas inscrições é a resposta comum, e se a sua diretoria nunca registrou quem ocupa o quê, cargos e responsabilidades da diretoria do clube é o ponto de partida. O registro de auditoria grava a atividade do agente em nome dessa pessoa, e isso é uma característica, não um acidente: sempre existe um ser humano que responde pelo que a conexão fez.
Ela também herda os limites dessa pessoa. E, como a verificação de privilégios acontece em tempo real, no dia em que essa pessoa deixar de ser administradora a conexão para de funcionar, sem que ninguém precise se lembrar. Revogue mesmo assim: uma conexão sem dono é uma conexão que ninguém revisa.
Trate a expiração como um gatilho de revisão, não como uma tarefa chata
O formulário oferece 30 dias, 90 dias, 1 ano ou Nunca, e o padrão é 90 dias. Aceite o padrão. Noventa dias é mais ou menos um ciclo da diretoria, o que transforma uma configuração de segurança em algo mais útil: um item fixo da pauta que pergunta, quatro vezes por ano, "isto ainda está fazendo o que aprovamos?".
"Nunca" é a opção que, sem alarde, sobrevive à diretoria que a escolheu. Se você escolher uma expiração longa, coloque a revisão na agenda por conta própria. A alternativa é uma chave funcional da plataforma do clube guardada em um notebook que saiu do clube duas temporadas atrás.
A revogação é a verdadeira rede de segurança
Um clique encerra uma conexão em todos os lugares, imediatamente: é a resposta para um notebook perdido, um projeto concluído, um voluntário que vai embora ou uma diretoria que mudou de ideia. Criar outra leva um minuto, então não há motivo para hesitar: revogue primeiro, discuta depois. Trate isso como você trata o código do cadeado da sede quando alguém devolve a chave.
A observação honesta sobre o acesso em duas etapas
Um limite merece ser dito com clareza, em vez de ficar escondido. Um token de conexão dispensa a etapa de verificação do acesso em duas etapas que uma pessoa enfrenta ao entrar pelo navegador. É assim que toda credencial de API funciona: o token é a credencial, então não há segunda etapa a pedir. É exatamente por isso que os outros três controles importam: o token expira, pode ser revogado com um clique e tudo o que ele faz é auditado em nome de uma pessoa identificada. Não deixe nenhum dos três de lado.
Mais um limite que vale registrar em ata com honestidade: a conexão tem um limite de 120 solicitações por minuto, então um agente descontrolado bate em uma parede, e não no seu banco de dados inteiro.
O que escrever na ata
Limite a cinco linhas. Uma proposta curta assim é algo com que uma diretoria futura consegue trabalhar:
- O que foi aprovado: "uma conexão de agente de IA com a plataforma do clube no escopo somente leitura" ou "alterações, restritas a notícias, publicação desativada".
- Quem é o responsável: a pessoa nomeada, e o fato de que o registro de auditoria grava a atividade do agente em nome dela.
- Quando expira: a data, e quem cria a nova conexão.
- Quando é revisada: a reunião em que a diretoria examina o registro de auditoria e decide se sobe, fica ou recua.
- Quem pode revogá-la: de preferência qualquer membro da diretoria, sem precisar de reunião.
Isso é uma política. Cabe em uma página, nomeia uma pessoa e tem uma data, mais do que a maioria das decisões de tecnologia recebe.
Perguntas frequentes
Um agente de IA pode excluir os nossos sócios ou pegar o dinheiro deles?
Não. Nada na conexão envia e-mail ou SMS, recebe um pagamento ou faz um reembolso: essas ferramentas não existem, então não podem ser pedidas. As informações dos sócios voltam como contagens agregadas, não como nomes ou dados de contato, e toda alteração é verificada em relação ao que o dono pode fazer, simulada antes de ser gravada e registrada no registro de auditoria.
Devemos dar uma conexão para a diretoria inteira ou uma para cada pessoa?
Uma para cada pessoa, com o nome de onde ela fica. Conexões são fáceis de criar e revogar não custa nada, e um segredo compartilhado é um segredo pelo qual ninguém responde. Conexões separadas também mantêm o registro de auditoria legível: quando duas pessoas trabalham com agentes, você quer saber qual fez o quê. E se duas tarefas precisam de escopos diferentes (somente leitura para o tesoureiro, só notícias para o voluntário de comunicação), são duas conexões, não um meio-termo.
E se o agente fizer algo que não esperávamos?
Revogue a conexão primeiro; um clique interrompe tudo na hora. Depois leia o registro de auditoria, que grava o que aconteceu em nome do dono. Se o agente publicou algo, o histórico da página é mantido, então uma versão anterior pode ser restaurada. Em seguida, decida se o escopo estava errado, se a restrição estava generosa demais ou se o hábito de revisão falhou, e crie uma nova conexão um degrau abaixo na escada enquanto resolve isso.
Precisamos entender a tecnologia para aprovar isso?
Não mais do que você precisa entender de fechaduras para decidir quem recebe uma chave. O modelo útil é este: a plataforma publica um cardápio fixo de coisas que um agente pode pedir e recusa todo o resto; os seus dois controles decidem quanto desse cardápio esta conexão consegue ver. Para os detalhes técnicos, as páginas de integrações e de acesso para agentes de IA descrevem como a conexão é construída, e a nossa página de segurança explica os controles da plataforma por baixo dela.
Como sabemos que um agente não está acessando os dados de outro clube?
A conexão fica vinculada à sua organização no momento em que é criada. As ferramentas que funcionam para a plataforma inteira a recusam de cara, as ferramentas que recebem o nome de uma organização recusam qualquer nome que não seja o seu, e o próprio banco de dados é a última barreira, filtrando as linhas para a sua organização independentemente do que o aplicativo peça. São três recusas separadas, e não uma única configuração, porque um controle que depende de uma única verificação tem um único ponto de falha.
