Easy8

Skip to content

Servidor MCP ¶

O servidor MCP do Easy8 permite que assistentes de IA, como Claude, ChatGPT, Microsoft Copilot Studio ou Cursor, trabalhem com o seu Easy8. Um usuário conecta o assistente uma vez, faz login com a conta Easy8 e então pergunta:

• "Quais tarefas estão atribuídas a mim esta semana?"
• "Crie uma tarefa no projeto Website para atualizar a página de preços e atribua-a à Jane."
• "Registre 2 horas na tarefa 1234 referentes a ontem."
• "Resuma os comentários e anexos da tarefa 1234."
• "Quais das minhas oportunidades não tiveram atividade de vendas no mês passado?"

O assistente age como o usuário conectado: ele vê apenas o que esse usuário pode ver e altera apenas o que esse usuário pode alterar. Ferramentas lista tudo o que ele pode fazer.

Configuração ¶

Um administrador faz isso uma vez.

1. Ative o MCP ¶

Em Administração → Configurações → IA, marque Ativar MCP e salve.

O endereço do servidor é o seu endereço Easy8 seguido de /mcp, por exemplo https://yourcompany.easy8.com/mcp.

2. Escolha como os assistentes fazem login ¶

Método	Use para	Onde
Autorregistro	Assistentes que se conectam apenas com o endereço do servidor, como Claude ou Copilot Studio	Administração → Easy SSO → Aplicativos que usam contas Easy8 → Autorregistro de aplicativos
Aplicativo manual	Assistentes que solicitam um Client ID e um segredo	Administração → Easy SSO → Aplicativos que usam contas Easy8 → Adicionar aplicativo
Chave de API	Scripts e ferramentas de desenvolvedor que enviam um cabeçalho em vez de fazer login, como Claude Code ou Cursor	Meu perfil → Chave de acesso à API de cada usuário; requer a API REST ativada em Administração → Configurações → API

O Autorregistro tem três modos:

• Desativado (padrão): os assistentes não podem se registrar. Adicione cada um como um aplicativo manual.
• Aprovação necessária: um assistente recém-registrado aguarda um administrador. Os administradores recebem um e-mail, e o assistente aparece em Aguardando aprovação com Aprovar e Rejeitar.
• Automático: qualquer assistente pode se registrar e conectar pessoas imediatamente. Use apenas quando você confia na sua rede.

Aplicativo manual: clique em Adicionar aplicativo, insira um nome e o site do assistente e salve. A página do aplicativo mostra o Client ID e o Client secret para inserir no assistente.

Com ambos os métodos, cada usuário faz login no Easy8 e confirma o acesso na primeira vez que se conecta.

A Política de acesso de um aplicativo limita o que ele pode fazer, além das permissões do usuário. Altere-a na página do aplicativo:

Política de acesso	Permite
Tudo leitura/gravação, Tudo somente leitura	MCP e API REST
MCP leitura/gravação, MCP somente leitura	Apenas MCP
API leitura/gravação, API somente leitura	Apenas API REST; MCP é recusado

Conectar um assistente ¶

Adicione o Easy8 ao assistente como um servidor MCP remoto com o endereço https://yourcompany.easy8.com/mcp. O assistente então abre a página de login do Easy8; faça login e clique em Autorizar.

• Claude (web e desktop): Configurações → Conectores → Adicionar conector personalizado. Para um aplicativo manual, insira o Client ID e o Client secret em Configurações avançadas.
• Microsoft Copilot Studio: adicione o servidor MCP e escolha OAuth 2.0 → Descoberta dinâmica. Consulte a documentação da Microsoft.
• Claude Code: claude mcp add --transport http easy8 https://yourcompany.easy8.com/mcp, depois faça login com /mcp. O login exige autorregistro. Sem ele, use uma chave de API: adicione --header "X-Easy8-API-Key: <your API key>".
• Outros assistentes: ferramentas que solicitam um cabeçalho em vez de fazer login aceitam a chave de API no cabeçalho X-Easy8-API-Key.

Segurança ¶

• O assistente tem as permissões do usuário conectado, nunca mais.
• Uma política de acesso somente leitura ou a Chave de acesso à API somente leitura de Meu perfil permite que o assistente leia sem alterar nada.
• Nenhuma ferramenta exclui tarefas, projetos, registros de tempo ou registros de CRM.
• As alterações são salvas no histórico sob o nome do usuário que as fez por meio do assistente.
• Para aplicativos com autorregistro, para desconectar um usuário, abra o aplicativo em Aplicativos que usam contas Easy8 e clique em Desconectar usuário. Desativar ou excluir o aplicativo desconecta todos que o usam.
• Desativar Ativar MCP interrompe todas as conexões MCP de uma vez. Aplicativos com uma política de acesso Tudo, que é o padrão, mantêm o acesso à API REST até que você os desative. O WebMCP tem sua própria configuração.
• Descrições e comentários escritos por outras pessoas podem conter instruções destinadas a enganar um assistente. Prefira assistentes que perguntam antes de alterar dados.

Solução de problemas ¶

Problema	Verifique
O assistente não consegue encontrar o servidor (HTTP 404)	Ativar MCP está ativado.
A conexão falha antes de a página de login aparecer	O autorregistro não está Desativado, ou adicione o assistente como um aplicativo manual.
O assistente diz que está aguardando aprovação	Um administrador o aprova em Aguardando aprovação.
HTTP 401 com uma chave de API	A chave está correta e a API REST está ativada em Administração → Configurações → API.
HTTP 403	A política de acesso do aplicativo é API leitura/gravação ou API somente leitura, que recusa o MCP.
O assistente pode ler, mas não alterar dados	A política de acesso ou a chave de API é somente leitura, ou o usuário não tem a permissão no Easy8.
Ferramentas de um módulo, como CRM, estão ausentes	O seu Easy8 não inclui esse módulo.
O assistente não consegue abrir anexos	O assistente baixa arquivos do Easy8 para analisá-los. No Claude, ative a execução de código e permita acesso à rede para o seu endereço Easy8. Um login de proxy na frente do Easy8 deve permitir o download do assistente.

O Easy8 registra solicitações MCP em log/mcp.log, com o usuário, a ferramenta e o motivo pelo qual uma solicitação foi recusada. Uma recusa pela política de acesso (HTTP 403) está apenas em log/production.log. No Docker, leia os logs com docker compose exec app tail -f log/mcp.log.

Voltar ao topo