Conecte sua caixa de entrada ao Zed
pelo Agent Panel
Adicione uma caixa de correio real ao Zed como context server. Leia, pesquise, envie, responda, encaminhe, agende e organize e-mails sem sair do editor.
O único valor de que você precisa
Nas configurações do Agent Panel, clique em Add Custom Server, ou adicione uma entrada em context_servers no settings.json com a url https://mcpemails.com/api/mcp. O Zed inicia o fluxo OAuth quando nenhum header Authorization está definido.
| Campo | Valor |
|---|---|
| URL do servidor MCP | https://mcpemails.com/api/mcp |
| Transporte | Streamable HTTP (MCP 2025-06-18) |
| Autenticação | OAuth 2.1, código de autorização com PKCE. Sem chave de API. |
Como o Zed se conecta: OAuth, sem chave de API
O Zed executa o fluxo OAuth padrão do MCP com este servidor. Ele se registra com registro dinâmico de cliente RFC 7591, então não há client ID para criar, e autoriza com authorization code mais PKCE usando S256. Nenhum client secret é transmitido, e o token carrega só os escopos que você aprova na nossa tela de consentimento. O token de acesso que ele recebe dura uma hora e se renova sozinho; ele aparece no painel, em Chaves de API, como OAuth: seguido do nome do cliente, e é ali que você revoga a conexão.
Como conectar o Zed à sua caixa de entrada
Quatro passos. Os dois primeiros são iguais para todos os clientes, os demais são específicos deste.
Crie uma conta grátis e conecte uma caixa de correio
Crie sua conta em mcpemails.com, sem cartão, e conecte sua caixa de correio no painel, em Caixas de entrada. Uma caixa de entrada é grátis, para sempre.
Abra as configurações do Agent Panel
Nas configurações do Agent Panel, clique em Add Custom Server (adicionar servidor personalizado), ou edite o settings.json diretamente.
Adicione o servidor
Adicione a entrada abaixo em context_servers.
Autorize
O Zed inicia o fluxo OAuth quando nenhum header Authorization está definido. Faça login com o MCPEmails e aprove os escopos que você quer que o Zed tenha.
{
"context_servers": {
"mcpemails": {
"url": "https://mcpemails.com/api/mcp"
}
}
}Documentação oficial do Zed sobre servidores MCP remotos: https://zed.dev/docs/ai/mcp
Na dúvida sobre qual caixa de correio conectar primeiro? Veja a tabela de compatibilidade de provedores
Onde as pessoas costumam tropeçar no Zed
Deixe o header Authorization vazio de propósito
O Zed escolhe entre OAuth e um token estático conforme você tenha configurado ou não um header Authorization. Defina um e o Zed o usa e nunca pede login; deixe vazio e o Zed executa o fluxo no navegador. Preencher esse campo pela metade é como as pessoas acabam com um servidor que nem pede login nem autentica.
O Zed chama de context servers, todo mundo chama de servidores MCP
A chave de configuração é context_servers. É o mesmo MCP, e um trecho de outro cliente está certo, tirando a chave que envolve a entrada, que é exatamente o tipo de diferença que passa por uma leitura cuidadosa.
O Agent Panel é onde as ferramentas aparecem
As ferramentas de e-mail são ferramentas do agente. Uma conexão bem-sucedida não muda nada nos autocompletes inline; o lugar para confirmar que funcionou, e ver quais ferramentas chegaram, é o Agent Panel.
Limites que vale a pena conhecer
- As solicitações têm limite de taxa por chave, em janelas por minuto, por hora e por dia dimensionadas para o seu plano. Uma resposta 429 traz Retry-After.
- O servidor funciona só com solicitação e resposta. Não há webhooks nem eventos iniciados pelo servidor, então um e-mail novo nunca acorda seu agente sozinho. Para reagir a e-mails que chegam, faça polling em intervalos programados.
- Os e-mails são buscados ao vivo no seu provedor a cada chamada e nunca armazenados. Só o token OAuth ou a senha de app criptografados ficam guardados, então um token revogado ou uma senha da caixa de correio alterada encerra o acesso na hora.
Zed e e-mail: perguntas e respostas
Como conecto o e-mail ao Zed?
Adicione um servidor personalizado nas configurações do Agent Panel, ou adicione uma entrada em context_servers no settings.json com a url https://mcpemails.com/api/mcp. Deixe o header Authorization vazio e o Zed executa o fluxo OAuth. O Agent Panel passa a ter ferramentas para ler, pesquisar, enviar, responder, encaminhar, organizar e agendar e-mails.
Preciso de uma chave de API para o Zed?
Não, desde que você deixe o header Authorization sem valor, que é o que faz o Zed iniciar o fluxo OAuth. Uma chave bearer é a alternativa se você preferir gerenciar o token por conta própria.
Quais caixas de correio o Zed alcança assim?
Outlook.com e Microsoft 365 com Entrar com a Microsoft, em que uma conta de trabalho pode precisar que um administrador de TI aprove o app uma vez; Gmail, iCloud, Fastmail, Yahoo, Zoho e Yandex com uma senha específica de app; e qualquer outra caixa de correio que fale IMAP e SMTP nas portas padrão. O cliente vê todas pela mesma conexão: seu agente chama inbox_list primeiro para descobrir cada caixa conectada e o id dela, então não há UUIDs para colar em lugar nenhum.
O Zed pode enviar e-mails sem eu ver?
Só se você deixar. O envio depende do escopo send:email, então uma chave ou um token sem esse escopo não consegue enviar nada. Além disso, o dono de uma caixa de entrada pode exigir aprovação humana no painel, que segura todo envio, resposta, encaminhamento, envio de rascunho e envio agendado até que uma pessoa libere.
Meus e-mails ficam armazenados nos seus servidores?
Não. Cada mensagem é buscada ao vivo no seu provedor para a solicitação que a pediu e entregue direto ao seu cliente. Só o token OAuth ou a senha de app criptografados ficam guardados, para que as próximas chamadas possam autenticar. Excluir a caixa de entrada no painel, ou revogar o acesso no seu provedor, encerra a conexão na hora.
Dê ao Zed uma caixa de entrada real
Um context server, um login. Uma caixa de entrada grátis para sempre, sem cartão.