Atimeus MCP

[!with-close] With-close

O que é o servidor MCP Atimeüs?

O servidor MCP (Model Context Protocol) permite conectar um assistente de inteligência artificial (IA), como Claude, ChatGPT ou Copilot, à sua instância Atimeüs. Uma vez conectado, o assistente pode, por exemplo, consultar seus dados, executar seus indicadores, declarar tempo ou atualizar fichas, simplesmente a partir de suas perguntas em linguagem natural.

O assistente age sempre com seus direitos: ele só vê e modifica o que você poderia ver e modificar você mesmo no Atimeüs.

O que você pode solicitar

• Tempo e atividade: "Declare um dia no projeto Refonte SI para cada dia desta semana", "O que ainda me falta lançar neste mês?", "Envie minha folha de ponto de setembro".
• Gestão: "Mostre-me a taxa de ocupação por divisão no mês passado", "Qual é o faturamento faturado desde o início do ano?".
• Comercial: "Quais oportunidades abertas têm data de fechamento neste trimestre?", "Crie uma tarefa de acompanhamento para o contato Marie Durand".
• Recrutamento e RH: "Liste os candidatos do viveiro Java adicionados neste mês", "Qual é o meu saldo de férias?".

O assistente tem acesso aos principais objetos do Atimeüs, incluindo: clientes, contatos, oportunidades e negócios, orçamentos, projetos e tarefas, CRA e folhas de ponto, colaboradores, alocações, ausências e férias, notas de despesas, faturas, subcontratados, candidatos, candidaturas, currículos e viveiros.

Assistentes compatíveis

Qualquer assistente que suporte servidores MCP remotos pode se conectar, por exemplo:

• Claude (site, aplicativo de desktop, mobile) e Claude Code;
• ChatGPT;
• GitHub Copilot no Visual Studio Code;
• Microsoft Copilot Studio;
• Cursor ou Mistral Le Chat.

Dependendo da sua assinatura do assistente, a adição de conectores pode ser reservada aos administradores da sua organização.

Conectando seu assistente

O endereço do servidor é exclusivo da sua instância: https://[instance].atimeus.app/mcp

Substitua [instance] pelo prefixo da sua instância, por exemplo https://monentreprise.atimeus.app/mcp.

1. Nas configurações do seu assistente, adicione um conector (ou servidor MCP) personalizado.
2. Insira o endereço da sua instância.
3. Uma janela de conexão será aberta: faça login com sua conta habitual do Atimeüs.
4. Aceite a tela de autorização para permitir que o assistente acesse o Atimeüs.

Nenhuma senha ou token precisa ser copiado. A conexão permanece ativa enquanto você usar o conector pelo menos uma vez a cada 30 dias; após esse período, o assistente solicitará que você se reconecte.

Os detalhes técnicos (autenticação OAuth, configuração dos clientes) estão descritos no portal do desenvolvedor.

Leitura, modificação e exclusão

As ações do assistente se dividem em três famílias:

• Leitura: consultar fichas, pesquisar, executar indicadores, ler uma folha de ponto. Nenhum dado é modificado.
• Modificação: declarar tempo, avançar uma folha de ponto (completar, validar, encerrar, desbloquear), criar ou modificar uma ficha.
• Exclusão: excluir lançamentos de tempo ou uma ficha. Essas exclusões são definitivas.

Dependendo das configurações, seu assistente solicita confirmação antes de uma modificação e sempre antes de uma exclusão. Todas as modificações passam pelos mesmos controles do aplicativo: campos obrigatórios, permissões, períodos encerrados, etc.

Boas práticas

1. Especifique o período. Para tempos e indicadores, informe o mês ou as datas. Por padrão, o assistente usa o mês de fechamento em curso, que pode ser diferente do mês calendário.
2. Revise antes de confirmar. Verifique o que o assistente está prestes a criar, modificar ou excluir.
3. Verifique as quantidades declaradas. Um dia não pode exceder 1 dia de trabalho: se você declarar mais, a quantidade registrada é reduzida e o assistente informa isso.
4. Prefira os indicadores para perguntas de gestão: eles usam os cálculos configurados na sua instância.
5. Desconfie de resultados parciais. As pesquisas retornam resultados por páginas; peça ao assistente para continuar se a lista parecer incompleta.

Removendo o acesso

Para cortar o acesso, desconecte ou exclua o conector Atimeüs nas configurações do seu assistente.

Problemas frequentes

• A conexão falha após a autenticação: sua conta não existe ou não está ativa na instância, ou o tipo de conta usado (Microsoft ou Google) não é permitido para sua instância.
• O assistente indica acesso negado: suas permissões no Atimeüs não permitem essa ação. Fale com seu administrador.
• O conector não responde mais após várias semanas: a conexão expirou, reconecte o conector pelo seu assistente.

Dê sua opinião

Falta alguma informação, uma resposta não está clara ou você gostaria de um novo recurso? Basta pedir ao assistente para enviar um retorno à equipe Atimeüs: ele mostrará a mensagem antes de enviá-la, em seu nome, na forma de um ticket de suporte.

0 de 0