Funções
App sócios Admin Clientes Comparar Ferramentas
Preços Docs Novidades
Idioma
nl en de es fr it pt
Modo escuro
Entrar Teste grátis

Documentation

Ligar agente IA

Ligue Claude, ChatGPT, Grok, Gemini, Cursor ou outro assistente compatível com MCP para gerir o seu ginásio fora da app Sessy — passo a passo para pessoal sem conhecimentos técnicos.

Introdução

Ligue um assistente de IA externo ao seu ginásio para lhe pedir que verifique o horário, planeie sessões, contacte membros e mais — com as mesmas regras de negócio da app Sessy.

Importante: Ao ligar uma ferramenta de IA externa, os dados do ginásio e dos membros são enviados para esse fornecedor de IA. Leia 4. Privacidade e segurança de dados antes de começar e escolha Limitado — sem dados de membros no token quando o assistente não precisa de fluxos com membros.

Depois de ligado, consulte competências do agente IA para exemplos de pedidos — planeamento, mensagens, marcações, programming e mais.

O assistente de IA integrado da Sessy (na app Sessy) é diferente. Não usa token. Esta página trata de ligar ferramentas externas como Claude ou ChatGPT.

Nesta página

  1. Escolher uma ferramenta de IA adequada
  2. Criar um token de acesso na Sessy
  3. Ligar a sua ferramenta de IA
  4. Privacidade e segurança de dados

1. Escolher uma ferramenta de IA adequada

A Sessy liga-se através de MCP (Model Context Protocol) — uma forma padrão de as apps de IA se integrarem com outros serviços. Não precisa de perceber MCP; só precisa de uma app com uma definição de MCP, conector ou integração onde possa colar um endereço de servidor e um token.

Ferramentas de IA adequadas

Escolha o tipo que se adequa à sua equipa e depois uma ferramenta que já use:

Tipo Melhor para Exemplos
Assistentes de chat A maioria do pessoal — fazer perguntas e delegar tarefas num chat simples (browser ou secretária) Claude, ChatGPT, Grok, Gemini
Editores com IA Proprietários ou coaches que trabalham numa app de IA de secretária no computador Cursor, VS Code + extensão MCP, Windsurf, Zed, Raycast
Agentes de automatização Configurações avançadas — tarefas agendadas, fluxos em vários passos ou computer use (o agente controla apps no seu computador) OpenClaw, Hermes Agent, Grok bot — configuração técnica; consulte a documentação MCP de cada produto

Se uma ferramenta não estiver listada acima, só funciona se a documentação mencionar MCP ou Model Context Protocol e permitir adicionar um URL de servidor personalizado (https://mcp.sessy.app).

O que não funciona

  • Chat sem ligação — pedir ao ChatGPT ou Claude para «entrar no meu ginásio» sem configurar a Sessy primeiro. Sem ligação, não veem os dados da Sessy.
  • WhatsApp, SMS, email ou bots de redes sociais — a Sessy não liga assim.
  • O chat de IA na app Sessy — use a app diretamente; não precisa de token.

2. Criar um token de acesso na Sessy

  1. Inicie sessão como Admin
  2. Abra Configuração → Tokens de agente IA
  3. Dê nome ao token, escolha o funcionário, o acesso do token (Admin ou Funcionário) e o acesso a dados
  4. Copie o token de imediato — só é mostrado uma vez
  5. Entregue-o a esse funcionário para a sua ferramenta de IA
  6. Revogue-o no mesmo ecrã se se perder ou já não for necessário

Cada token é para o seu ginásio e um funcionário que escolher.

Vai precisar deste token no passo 3. Endereço do servidor para todas as ferramentas: https://mcp.sessy.app

Presets de acesso a dados

Ao criar um token, escolha o acesso a dados além do acesso do token (Admin ou Funcionário):

Preset Quando
Acesso completo O assistente precisa de pesquisar membros, inscrevê-los, enviar push direcionado, ver presenças ou receita, ou editar notas e etiquetas de membros
Limitado — sem dados de membros Horário, programming, catálogo da loja, banner do ginásio, newsletters e configuração do ginásio — sem enviar dados pessoais de membros à IA externa

Limitado é um controlo de privacidade. As ferramentas de IA externas recebem o que a Sessy devolve por cada ação. Com limitado ativo, a Sessy bloqueia ferramentas que expõem nomes, emails, listas de marcações, histórico de presenças, notas da equipa, etiquetas, audiências de push direcionado ou receita — e remove identificadores de membros das leituras do horário.

O acesso Funcionário não pode alterar a configuração global do ginásio. O acesso Admin só está disponível quando o funcionário selecionado é Admin na Sessy. O acesso do token não pode exceder o papel dessa pessoa.

O que limitado ainda permite

Área Exemplos
Horário Ver o horário (apenas contagens de marcações, não quem está inscrito), criar/atualizar/eliminar sessões, preencher uma semana a partir de modelos recorrentes, atribuir coach
Programming Pesquisar benchmarks globais (Fran, Murph, …) e workouts próprios, ligar workoutId nas sessões para registo de resultados, criar workouts custom
Banner do ginásio setGeneralMessage — banner na app para todos (sem lista de membros na resposta)
Newsletters Criar, atualizar, publicar ou eliminar rascunhos de newsletters (subscritores opt-in; publicar ainda exige cuidado)
Catálogo da loja Ler produtos e categorias
Resumo do ginásio Apenas contagem de membros via getBoxStats (sem nomes)
Configuração Apenas tokens Admin: localizações, tipos de sessão, subscrições, artigos/categorias da loja, definições de etiquetas

O que limitado não permite

O assistente não pode usar estas capacidades enquanto limitado estiver ativo:

Não disponível Porquê
Pesquisar membros por nome ou email Expõe dados pessoais de membros
Inscrever ou desinscrever um membro Requer identidade do membro
Histórico de presenças ou relatórios «quem treinou junto» Dados pessoais de presença
Relatórios de receita Relatórios financeiros ou ligados a membros
Push direcionado (notifyMembers para hoje/amanhã/membros/funcionários/todos) Usa listas de membros ou alcance pessoal amplo
Notas da equipa e etiquetas de membros em indivíduos Dados pessoais de membros

Use acesso completo quando o pessoal precisa desses fluxos. Use limitado para assistentes que só gerem horário, programming, banners, newsletters ou configuração do ginásio — especialmente ao ligar a um fornecedor de IA externo.

Quatro combinações (acesso do token × acesso a dados)

Dados completos Limitado — sem dados de membros
Token Funcionário Horário, programming, comunicação, pesquisa/marcação/notas de membros, relatórios Horário, programming, banner, newsletters, leitura da loja — sem pesquisa de membros, marcação, notas, push direcionado ou receita
Token Admin Tudo o que um token Funcionário pode fazer, mais configuração do ginásio Como Funcionário limitado, mais configuração do ginásio (localizações, tipos de sessão, subscrições, setup da loja)

Quando a IA se liga, a Sessy fornece um guia integrado access-profile (sessy://skills/access-profile) que lista as ferramentas exatas permitidas para esse token.

Guias integrados para o assistente

A Sessy fornece guias de workflow que ensinam o assistente como o seu ginásio funciona. Os clientes compatíveis carregam-nos automaticamente ao ligar.

Guia Para quem Propósito
Access profile Todos Comece aqui — ferramentas exatas para este token (papel + acesso a dados)
Overview Todos Regras de ouro e ordem de leitura
Data model Funcionário+ Membros, sessões, subscrições, loja
Tools reference Funcionário+ Tudo o que o assistente pode fazer
Limits and safety Funcionário+ Limites de taxa, validação, ações sensíveis
Schedule week Funcionário+ Planear uma semana — horário recorrente ou aulas avulsas
Manage sessions Funcionário+ Editar, eliminar, recorrente, preencher semana a partir do modelo
Book member Funcionário+ · apenas dados completos Inscrever ou desinscrever um membro
Program WOD Funcionário+ Ligar workouts por workoutId — benchmarks via pesquisa, custom via upsert
Notify members Funcionário+ · apenas dados completos Notificações push direcionadas
Newsletters Funcionário+ Rascunho e publicação
Member notes & tags Funcionário+ · apenas dados completos Notas da equipa e etiquetas
Query and reports Funcionário+ · apenas dados completos Presenças, receita, loja
Configuration Apenas Admin Configuração do ginásio

Os tokens Funcionário veem todos os guias exceto Configuration. Os tokens Admin veem o conjunto completo. Os tokens limitados não recebem guias de pesquisa de membros, marcação, push direcionado, notas ou relatórios pessoais — o access profile lista o que se aplica.

3. Ligar a sua ferramenta de IA

Mais fácil: cole este prompt

Depois de criar o token no passo 2, copie o prompt abaixo para Claude, ChatGPT, Grok, Gemini, Cursor ou outro assistente compatível com MCP. Substitua YOUR_TOKEN_HERE pelo seu token Sessy. A IA pode guiá-lo na adição da ligação no seu computador.

Cole o token apenas numa ferramenta de confiança.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

Connect me to Sessy (my gym admin platform).

- Server URL: https://mcp.sessy.app
- Transport: Streamable HTTP (JSON-RPC POST)
- Auth: Bearer token in the Authorization header
- My token: YOUR_TOKEN_HERE

Add this connection in my environment (Claude MCP settings, ChatGPT custom connector, Cursor mcp.json, Grok or Gemini MCP settings, OpenClaw/Hermes MCP config, or equivalent). Use the token only for this connection.

When you are done, confirm it works by listing the available Sessy tools.

Depois pergunte algo simples, por exemplo:

  • «Que ferramentas Sessy tens?»
  • «Mostra as sessões desta semana.» (se o token permitir acesso ao horário)

Se não vir a Sessy, verifique o token, se a ligação está ativa e se iniciou um chat novo depois de guardar as definições.

Configuração manual

Prefere configurar a ligação você mesmo, ou o prompt não funcionou? Use os passos da sua ferramenta abaixo. Em todo o lado é o mesmo princípio: adicionar a Sessy como ligação personalizada, colar o endereço do servidor https://mcp.sessy.app e o token, e guardar.

Claude (recomendado para utilizadores não técnicos)

No browser (claude.ai):

  1. Abra claude.ai e inicie sessão.
  2. Abra Definições (menu de perfil).
  3. Procure Conectores, Integrações ou MCP — o nome varia consoante o tipo de conta.
  4. Adicione um conector personalizado ou servidor MCP.
  5. Cole o URL https://mcp.sessy.app e o token Sessy na autenticação (Bearer token ou chave API).
  6. Guarde e inicie um chat novo. Pergunte: «O que podes fazer com o meu ginásio Sessy?»

Claude desktop: mesmos passos — Definições → Conectores / MCP → servidor personalizado com URL e token.

ChatGPT

  1. Abra chat.openai.com e inicie sessão (planos pagos costumam ser necessários para conectores).
  2. Definições → Conectores ou Apps (o nome pode variar).
  3. Adicione um conector personalizado ou ligação MCP.
  4. URL do servidor: https://mcp.sessy.app — autenticação: o seu token Sessy.
  5. Guarde, abra um chat novo e teste.

Grok

  1. Abra grok.com (ou a sua app xAI) e inicie sessão.
  2. Abra Definições e procure MCP, conectores ou integrações.
  3. Adicione um servidor MCP personalizado com URL https://mcp.sessy.app e o token Sessy como autenticação Bearer.
  4. Guarde e inicie um chat novo para testar.

Gemini

  1. Abra gemini.google.com e inicie sessão.
  2. Definições → Extensões, Apps ou MCP (o nome varia consoante o plano e a região).
  3. Adicione uma ligação personalizada com URL do servidor https://mcp.sessy.app e o token Sessy.
  4. Guarde e teste num chat novo.

Cursor

  1. Instale Cursor e inicie sessão.
  2. Abra Cursor Settings → MCP (ou edite o ficheiro de configuração MCP quando solicitado).
  3. Adicione um servidor chamado sessy com URL https://mcp.sessy.app e o token no cabeçalho Authorization.
  4. No painel de chat, confirme que aparecem ferramentas Sessy ao perguntar pelo ginásio.

OpenClaw, Hermes Agent ou Grok bot

São para configurações avançadas — automações, tarefas agendadas ou controlo de apps no computador. Adicione a Sessy como servidor MCP na configuração desse produto:

  • URL: https://mcp.sessy.app
  • Auth: Bearer token = o seu token Sessy

Consulte a documentação MCP da OpenClaw, o guia MCP do Hermes Agent ou a documentação do seu fornecedor Grok bot. Espere uma configuração mais técnica do que com Claude ou ChatGPT.

Outras apps MCP

Para Windsurf, Zed, VS Code, Raycast ou similares: abra as definições de MCP ou Integrações dessa app e adicione o URL e o token acima. Consulte as páginas de ajuda da app sobre «MCP» ou «custom server» se os nomes do menu diferirem.

4. Privacidade e segurança de dados

Dados pessoais saem da Sessy

Quando o seu assistente de IA usa a Sessy em seu nome, os dados do ginásio e dos membros são enviados para o serviço de IA que escolher — por exemplo Anthropic, OpenAI, xAI, Google ou Cursor. Podem incluir:

  • Nomes e emails de membros
  • Presenças e histórico de marcações
  • Notas da equipa e etiquetas de membros
  • Título e texto das mensagens que envia
  • Resumos de receita e outros relatórios

A Sessy não controla como esse fornecedor externo armazena, processa ou usa estes dados. É responsável por:

  • Escolher um serviço de IA em que confia
  • Verificar se os termos, tratamento de dados e (se aplicável) opções empresa / DPA cumprem as suas obrigações ao abrigo do RGPD e outras regras aplicáveis ao seu ginásio
  • Dar tokens apenas ao pessoal que precisa e revogá-los quando já não forem necessários
  • Usar Limitado — sem dados de membros quando o assistente não precisa de fluxos com membros (menos dados pessoais enviados à IA externa)

O assistente de IA integrado na Sessy mantém o processamento na infraestrutura própria da Sessy. Ligar um agente de IA externo é uma escolha deliberada de partilhar dados com terceiros.

Se não tiver a certeza se um fornecedor é adequado para os dados dos seus membros, não ligue até consultar o seu assessor jurídico ou de privacidade.

Tokens e limites de utilização

  • Trate os tokens como palavras-passe — quem tiver o token pode atuar como esse funcionário no seu ginásio
  • As mesmas regras de validação da app (tipos de sessão, localizações, janela de planeamento e mais)
  • Assistente in-app (por ginásio): 60 pedidos de chat por minuto; 30 alterações confirmadas por minuto, 500 por dia (UTC) e 200 por mês civil
  • Limites de escrita MCP (por token): 30 mutações por minuto e 500 por dia (UTC). Agendar uma semana completa a partir de modelos recorrentes conta como uma escrita; copiar uma semana antiga sessão a sessão pode atingir o limite de imediato
  • Os tokens não podem eliminar o ginásio, atribuir papéis Admin ou alterar a faturação da plataforma
  • Mensagens em massa a todos os membros ou publicar newsletters exigem cuidado extra