API e MCP no sistema de ponto: diferenças e possibilidades

Defina qual informação precisa atravessar a integração

A pergunta “o sistema tem API?” precisa de uma continuação: para consultar o quê e com qual autorização? Um produto pode publicar informações comerciais e oferecer, por outro caminho, consultas autenticadas sobre empresas. A existência de um endereço público não significa abertura de todos os dados.

No Onli Ponto, a API /api/v1 é pública comercial, voltada a planos, cotação e saúde do serviço. Ela não é uma API pública de funcionários. O MCP atende a consultas autorizadas de ponto com ChatGPT e Claude e tem acesso somente de leitura.

Essa diferença deve aparecer no escopo antes de qualquer desenvolvimento. Evita montar uma proposta de integração supondo endpoints privados ou funções de escrita que não foram oferecidos.

Separe os dois caminhos na proposta técnica

A documentação pública do Onli Ponto é a referência inicial para conferir os recursos documentados. Apresente ao responsável pela integração o dado de origem, a finalidade e o destinatário da informação.

| Necessidade | Caminho a avaliar | | --- | --- | | Consultar informações públicas de planos | API pública comercial documentada | | Obter cotação conforme documentação | API pública comercial documentada | | Consultar ponto em conversa com IA | MCP com autorização e elegibilidade | | Alterar batidas ou cadastrar pessoas pelo chat | Fora do escopo do MCP do produto |

API e MCP não são permissões por si mesmos. A documentação de arquitetura do MCP descreve um padrão de comunicação entre aplicações e servidores; os recursos efetivos continuam definidos pelo serviço.

Para um projeto, isso significa escrever explicitamente o que será usado. “Integrar tudo” não é um requisito testável. “Consultar a informação comercial documentada e apresentar a origem” permite verificar se a entrega corresponde ao que foi combinado.

Use um exemplo comercial e outro administrativo

Exemplo ilustrativo comercial: uma equipe está comparando sistemas e quer organizar informações públicas de contratação. O primeiro passo é consultar os recursos comerciais documentados, registrar a data da consulta e confirmar a proposta vigente com o fornecedor. Não há necessidade de acessar dados de empregados para essa tarefa.

Exemplo ilustrativo administrativo: um RH quer perguntar sobre o ponto de setembro de uma empresa sob sua responsabilidade. Esse trabalho exige o MCP autorizado, além de plano e assinatura elegíveis. Admin ou RH seleciona as empresas que podem ser consultadas e pode revogar o acesso.

No segundo exemplo, a consulta por datas aceita até 93 dias no fuso da empresa, e totais mensais exigem meses completos. A aplicação de IA precisa receber um pedido com empresa e período definidos. O resultado deve ser comparado com os registros do sistema antes de qualquer decisão.

Esses exemplos são roteiros de uso, sem integração implementada ou resultado de cliente associado. O comparativo entre sistema e planilha ajuda a avaliar também a rotina que dará origem aos dados consultados.

Escreva critérios de aceite antes de desenvolver

Uma especificação curta pode conter cinco critérios: recurso documentado utilizado, informação esperada, autorização necessária, condição de erro e forma de conferir a resposta. Acrescente quem é responsável por validar a integração e por revisar seu acesso.

No caminho público, teste se a aplicação deixa claro que apresenta informação comercial. No caminho autorizado, confira se a empresa e o período estão identificados. Quando houver indisponibilidade, o sistema consumidor deve mostrar que não conseguiu consultar, sem inventar uma resposta.

Se a necessidade for exportar dados para outro software, descreva exatamente os documentos e campos esperados ao fornecedor. Não presuma uma API de folha nem crie um fluxo com base em endereços internos encontrados por tentativa. Primeiro confirme o suporte ao requisito.

Fontes e atualização

Atualizado em 21/10/2026. Escopo do produto: documentação do Onli Ponto. Referência técnica: arquitetura oficial do MCP.

Para avaliar o sistema antes de planejar uma integração, inicie o teste comercial de 14 dias e confirme os recursos necessários à sua proposta.