- Visão Geral
- O que é MCP
- Quem Pode Acessar
- Como Funciona o Acesso
- Autenticação via OAuth
- O que o MCP Consegue Fazer
- Limitações e o que NÃO Faz
- Perguntas Frequentes (FAQ)
Visão Geral
O MCP (Model Context Protocol) é um servidor que permite que agentes de IA, como Claude e Cursor, operem diretamente no Checklist Fácil. Com o MCP, você pode executar ações usando comandos em linguagem natural, sem necessidade de conhecimento técnico em APIs.
Por exemplo, em vez de montar uma requisição técnica, você pode simplesmente dizer: "crie uma unidade chamada XYZ" e a IA identifica a ação, pede os dados que faltam e confirma antes de executar.
O MCP é diferente da API REST tradicional: a própria IA interpreta seus comandos em linguagem natural e executa as ações de forma segura e confirmada.
O recurso está disponível para planos Professional e Enterprise.
O que é MCP
MCP é um protocolo aberto que funciona como um intermediário entre agentes de IA (como Claude) e o Checklist Fácil. Ele permite que a IA execute operações diretamente no sistema sem que você tenha que escrever código ou requisições API.
Principais benefícios:
- Acesso simplificado via linguagem natural
- Sem necessidade de conhecimento técnico em APIs
- Confirmação automática antes de ações destructivas
- Autenticação segura via OAuth
- Integração direta com ferramentas de IA populares
Quem Pode Acessar
O acesso ao MCP é restrito por razões de segurança. Apenas usuários com permissão de Administração Geral conseguem completar a autenticação e usar o MCP.
Se um usuário sem essa permissão tentar acessar o MCP, ele será bloqueado na tela de autorização, antes de qualquer sessão ser criada. A única opção disponível será o botão "Cancelar".
Importante: Apenas administradores gerais podem autenticar e usar o MCP. Verifique suas permissões antes de tentar configurar o acesso.
Como Funciona o Acesso
O fluxo de acesso ao MCP envolve três etapas principais:
1. Registrar o Endereço do MCP
No cliente de IA (como Claude Desktop ou Cursor), registre o endereço do servidor MCP do Checklist Fácil:
https://mcp.checklistfacil.com.br/mcp
2. Fazer Login e Autorizar
Após registrar o endereço, você será redirecionado para fazer login no navegador. Aqui, você autoriza o cliente de IA a acessar sua conta do Checklist Fácil. Este é o passo de autenticação OAuth, que garante a segurança da conexão.
3. Receber Token de Sessão
Após autorizar com sucesso, o servidor emite um token de sessão (JWT). Este token mantém sua sessão ativa para acessos seguintes, sem necessidade de autenticar novamente a cada comando.
Autenticação via OAuth
O MCP utiliza OAuth para autenticação segura. Este é um padrão de segurança amplamente adotado que permite que aplicações terceirizadas acessem sua conta de forma controlada.
Como funciona:
- Você faz login no navegador usando suas credenciais do Checklist Fácil
- Você autoriza o cliente de IA a acessar sua conta
- Um token seguro (JWT) é gerado e armazenado pelo cliente
- O token permite que o cliente execute ações em seu nome, sem expor sua senha
O OAuth substituiu o modelo anterior de Bearer Token/chave de API gerada manualmente, oferecendo maior segurança e facilidade de uso.
O que o MCP Consegue Fazer
O MCP permite que você execute uma variedade de operações diretamente no Checklist Fácil usando linguagem natural:
Estrutura Organizacional
- Criar e listar unidades
- Criar e listar tipos de unidade
- Criar e listar departamentos
- Vincular entidades (por exemplo: unidade a tipo de unidade, usuário a unidade)
Usuários
- Listar usuários e tipos de usuários existentes
- Convidar novos usuários por e-mail
- Vincular usuários a unidades, checklists e departamentos
Checklists
- Listar checklists existentes
- Consultar a estrutura completa de um checklist
- Criar checklists automaticamente via IA (geração automática)
- Gerar links de aplicação para checklists
- Importar checklists a partir de arquivos
- Vincular checklists a unidades e departamentos
Importante: Algumas ações têm limites. Por exemplo, é possível vincular até 20 entidades por chamada. Além disso, a criação de checklists não é granular - a IA cria o checklist completo, não item a item.
Limitações e o que NÃO Faz
Embora o MCP seja poderoso, existem funcionalidades que ainda não estão disponíveis nele. Para essas operações, você pode usar a API REST tradicional do Checklist Fácil.
O MCP NÃO consegue:
- Gerenciar registros e catálogos
- Criar ou gerenciar agendamentos
- Criar ou gerenciar planos de ação
- Acessar avaliações já aplicadas
- Gerenciar regiões e grupos
- Configurar webhooks, SSO ou IoT
- Acessar dados de localização (país, estado, cidade)
Para essas funcionalidades, consulte a documentação da API REST do Checklist Fácil ou entre em contato com nosso suporte.
Perguntas Frequentes (FAQ)
1. O que é melhor usar: MCP ou API REST?
Depende do seu caso de uso. Se você quer automatizar tarefas usando um agente de IA (Claude, Cursor), o MCP é mais fácil porque trabalha com linguagem natural. A API REST é ideal se você quer construir integrações complexas ou precisa de funcionalidades que o MCP ainda não oferece.
2. Posso usar MCP sem conhecimento técnico?
Sim! O MCP foi projetado para ser acessível. Você descreve o que quer fazer em linguagem natural, e a IA cuida do resto. No entanto, você precisa ter permissão de Administração Geral para acessar o MCP.
3. Qual é o endereço do servidor MCP?
O endereço é https://mcp.checklistfacil.com.br/mcp. Registre-o no seu cliente de IA (como Claude Desktop) para começar.
4. Meu token de sessão vai expirar?
O token de sessão (JWT) é emitido após a autenticação OAuth bem-sucedida e permanece ativo para acessos seguintes. Se o token expirar, você terá que fazer login novamente no navegador para obter um novo token.
5. O MCP está disponível em todas as regiões?
Sim, o MCP está disponível para toda a base de usuários. Você pode usar o mesmo endereço de servidor independentemente da sua localização.
6. Como posso vincular um usuário a múltiplas unidades?
Você pode fazer isso através do MCP em linguagem natural. Por exemplo, diga ao seu agente de IA: "vincule João às unidades A, B e C". O limite é de até 20 vínculos por chamada.
7. Posso criar checklists item por item com o MCP?
Não. A criação de checklists via MCP não é granular. A IA cria o checklist completo (com todas as áreas e itens) de uma vez. Para criar ou editar itens individuais, você pode usar a interface do Checklist Fácil.
8. Como faço para usar o MCP em Claude Desktop?
Abra as configurações do Claude Desktop, localize a seção de MCPs, e registre o endereço https://mcp.checklistfacil.com.br/mcp. Depois, faça login no navegador quando solicitado e autorize o acesso. Após isso, você pode usar o MCP normalmente na conversa com Claude.
❓Tem dúvidas? Entre em contato com nosso time de suporte.