# Solução de problemas do MCP

> Corrija problemas comuns com o servidor MCP do Emailit, de login e escopos ausentes a workspaces errados, ferramentas exclusivas de Admin e clientes que carregam ferramentas demais.

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](/pt/docs/developers/api-keys/).

## 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](/pt/docs/workspaces/members-and-roles/).

## 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](/pt/docs/mcp/toolsets/).

## Um e-mail é rejeitado

O remetente deve usar um [domínio de envio verificado](/pt/docs/domains/verification/). 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](/pt/docs/workspaces/production-access/), 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](/pt/docs/email-api/retry-and-forward/).

## 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](/pt/docs/mcp/local-server/) 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](https://discord.emailit.com) ou escreva para [support@emailit.com](mailto:support@emailit.com) informando o nome do cliente, a ferramenta que falhou e o texto do erro.

---
Fonte: https://emailit.com/pt/docs/mcp/troubleshooting/