Solução de problemas do MCP

Comece perguntando ao seu assistente “A qual workspace do Emailit estou conectado?”. Ele chama get-current-workspace e informa o workspace, o seu papel e o acesso concedido, o que explica a maioria dos problemas abaixo.

A página de login diz que o cliente é desconhecido

O registro do cliente está desatualizado. Remova o servidor do Emailit da sua ferramenta de IA e adicione-o de novo para que ela registre um cliente novo.

Uma ferramenta diz que precisa de acesso total

A conexão foi aprovada apenas com o escopo sending. Os clientes compatíveis com autorização incremental (step-up), como o ChatGPT, mostram de novo a tela de aprovação: aprove o acesso full. Com outros clientes, revogue a conexão em Account›Connected apps, reconecte e aprove o acesso total. Com uma chave de API, use uma chave Full Access.

As alterações acontecem no workspace errado

Cite o workspace no pedido, por exemplo, “No Marketing, liste os domínios”, ou peça ao assistente para trocar: “Mude para o meu workspace Marketing”. As chaves de API sempre agem no workspace a que pertencem.

Um workspace está faltando

A conexão só cobre os workspaces que você permitiu. Abra Account›Connected apps, escolha Edit access e adicione-o, ou escolha All workspaces. Se você foi removido do workspace, peça a um Admin que convide você de novo.

Uma ferramenta diz que precisa do papel Admin

O erro admin_role_required significa que você tem o papel Member nesse workspace e que a ferramenta gerencia chaves de API ou exclui um domínio. Peça a um Admin do workspace que faça isso ou que altere o seu papel.

O cliente mostra ferramentas demais ou não consegue carregá-las

Alguns clientes limitam o número de ferramentas. Carregue só o que você precisa com ?toolsets= na URL do servidor ou com o cabeçalho X-MCP-Toolsets, por exemplo, https://api.emailit.com/mcp?toolsets=emails,domains. Consulte Toolsets e modo somente leitura.

Um e-mail é rejeitado

O remetente deve usar um domínio de envio verificado. Peça ao assistente para conferir o domínio com get-domain, publicar os registros que faltam e executar verify-domain. Até o seu workspace ter acesso de produção, você só pode enviar para os e-mails das contas dos membros do workspace.

A nova tentativa falha

Só é possível tentar de novo e-mails com bounce, com falha, suprimidos ou retidos, em até 30 dias e enquanto o conteúdo deles ainda estiver armazenado. Consulte Novas tentativas e encaminhamento.

O cliente mostra “Method not allowed”

O servidor não tem estado e só aceita requisições POST. Atualize o seu cliente para uma versão compatível com o transporte Streamable HTTP ou use o servidor local via stdio.

O cliente pede login o tempo todo

O token de atualização expirou depois de 60 dias sem uso, foi reutilizado ou a conexão foi revogada. Faça login de novo pelo cliente. Se isso acontecer repetidamente, garanta que apenas uma cópia do cliente use a conexão por vez.

Ainda com problemas?

Pergunte no Discord ou escreva para support@emailit.com informando o nome do cliente, a ferramenta que falhou e o texto do erro.