O que você vai conseguir pedir ao Claude
Depois de conectado, o Claude passa a responder — dentro dos limites que você autorizou — perguntas e pedidos como:
- Consultar sem abrir o painel: saldo de banco de horas, status de férias e últimos registros de ponto.
- Acompanhar pendências: quais solicitações de ajuste ainda estão esperando aprovação.
- Abrir uma solicitação: pedir um ajuste de ponto ou um período de férias — o Claude monta o rascunho e só grava depois da sua confirmação; o ajuste entra na fila de aprovação humana do painel (nunca aprovado automaticamente), e a férias é registrada de imediato após a confirmação, como um cadastro direto no painel.
- Registrar ponto (opcional): só funciona se o administrador da sua conta também tiver habilitado um segundo interruptor, separado do principal; o ponto criado por essa via fica marcado como autodeclarado, sem verificação biométrica ou de geolocalização.
Antes de começar
- Conta PontoNet ativa. Ainda não é cliente? comece um teste grátis antes de pedir para o seu admin habilitar o recurso.
- Agente de IA habilitado pelo admin. Um administrador da conta precisa ter ativado o Agente de IA em Integrações → Agente de IA, no painel do PontoNet — é autoatendimento, sem precisar falar com o time do PontoNet.
- Claude Desktop ou claude.ai (web) com suporte a Connectors (a opção aparece em Configurações).
Passo a passo (conectar por URL — caminho recomendado)
- No Claude, abra Configurações → Connectors.
- Clique em Add connector (adicionar connector personalizado).
- Cole a URL do servidor MCP do PontoNet:
https://pontonet.app/mcp. - O Claude descobre os endpoints de OAuth automaticamente (via
/.well-known/oauth-authorization-server) e se registra por conta própria — não há client_id nem token para copiar e colar. - Se você ainda não estiver logado, o Claude abre o login do PontoNet em uma janela do navegador.
- Revise a tela de consentimento do PontoNet: ela lista exatamente quais escopos estão sendo pedidos (por exemplo, "Ler seus registros de ponto e banco de horas" ou "Propor e enviar solicitações de ajuste de ponto para aprovação").
- Clique em Permitir. O connector aparece como ativo — pronto para conversar.
Verifique se a conexão funcionou
Pergunte diretamente ao Claude: "quais ferramentas você tem disponíveis no PontoNet?" ou "qual é o meu saldo de banco de horas agora?". Se a conexão e os escopos estiverem certos, o Claude chama a ferramenta correspondente e responde com dados reais da sua conta — não um resumo genérico.
Conversa de exemplo
Consulta (leitura)
- Você: "Qual é o meu saldo de banco de horas?"
- Claude: consulta a ferramenta de saldo e responde com o valor atual, igual ao que aparece no painel.
Solicitação (escrita, com aprovação)
- Você: "Esqueci de bater a saída no dia 18, quero pedir um ajuste."
- Claude: monta um rascunho do pedido e pergunta "confirma o envio?" antes de qualquer coisa.
- Você: "Confirma."
- Claude: envia o pedido para a fila de aprovação — o status fica pendente até seu gestor revisar, exatamente como um pedido feito no painel.
Se você pedir para o Claude registrar um ponto pela conversa, ele só consegue completar a ação se o administrador da conta também tiver habilitado o segundo interruptor ("registro de ponto via agente de IA"). Quando habilitado, o registro criado é marcado como autodeclarado — sem biometria nem geolocalização — para que auditoria e relatórios sempre identifiquem sua origem.
Solução de problemas
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O connector não aparece na lista | Versão do Claude sem suporte a Connectors, ou URL digitada errada | Atualize o Claude Desktop ou use claude.ai; confirme a URL exata https://pontonet.app/mcp |
| Erro 401 depois de reconectar | Token revogado em /perfil/agentes-ia ou expirado | Remova o connector antigo no Claude e refaça a conexão para gerar um novo token |
| Claude diz que não tem permissão para um pedido | Escopo não concedido na tela de consentimento, ou o admin não habilitou o recurso | Confira os escopos concedidos em /perfil/agentes-ia; peça ao administrador para revisar Integrações → Agente de IA |
| "Registrar ponto" não funciona mesmo com tudo aprovado | O segundo interruptor (registro de ponto via IA) ainda está desligado | Pergunte ao administrador se "Habilitar registro de ponto via agente de IA" está ativo — é uma opção separada do interruptor principal |
Transparência: toda chamada de ferramenta feita pelo Claude gera um registro de auditoria (quem autorizou, qual escopo, qual ferramenta) — os mesmos controles usados no restante do PontoNet.
Perguntas frequentes
Preciso colar algum token de API para conectar o Claude?
Não. A conexão usa OAuth 2.1 com PKCE e registro dinâmico de cliente (RFC 7591): você cola apenas a URL https://pontonet.app/mcp e aprova a tela de login e consentimento — não existe nenhum token para copiar e colar manualmente.
O Claude consegue registrar ponto ou abrir solicitações por mim?
Sim, para pedidos de ajuste e períodos de férias: o Claude monta um rascunho e só grava depois da sua confirmação explícita. Pedidos de ajuste sempre entram na mesma fila de aprovação humana usada no painel, nunca aprovados automaticamente; períodos de férias são registrados de imediato após a confirmação, sem fila de aprovação separada — o mesmo comportamento de um cadastro direto no painel. Registrar ponto pela IA é opcional e exige que o administrador da conta habilite um segundo interruptor, separado do principal; quando habilitado, o ponto criado é marcado como autodeclarado e não verificado (sem biometria ou geolocalização).
Preciso ser administrador da conta para conectar meu Claude?
Não, para autorizar sua própria conexão qualquer colaborador pode aprovar a tela de consentimento. Mas um administrador da conta precisa ter habilitado o Agente de IA antes, em Integrações → Agente de IA no painel — sem isso, a conexão não retorna dados.
Como eu revejo ou revogo o acesso do Claude depois de conectar?
Em /perfil/agentes-ia você vê todas as suas conexões ativas, com os escopos concedidos em português, data de criação e último uso, e pode revogar o acesso a qualquer momento — a revogação bloqueia o token imediatamente.
O ChatGPT também consegue se conectar ao PontoNet?
Sim, pelo mesmo servidor MCP e o mesmo fluxo OAuth. Veja o passo a passo específico no tutorial "Como conectar o ChatGPT ao PontoNet via MCP".
Próximo passo
Veja o que mais o PontoNet + IA consegue fazer
Saiba mais sobre escopos, aprovação humana e o segundo interruptor de registro de ponto na página do produto.