Conecte sua caixa de entrada ao VS Code
e ao modo agente do Copilot
Adicione uma caixa de correio real ao editor que você já tem aberto. Leia, pesquise, envie, responda, encaminhe, agende e organize e-mails pelo modo agente do Copilot.
O VS Code abre com o MCPEmails já preenchido. Confirme e, na página do navegador que vem em seguida, crie sua conta e escolha sua caixa de entrada. Instalar no VS Code Insiders
O único valor de que você precisa
Rode MCP: Add Server na Paleta de Comandos, escolha HTTP (HTTP or Server-Sent Events), cole https://mcpemails.com/api/mcp e escolha Global e depois Copilot Global. Aprove o pedido de login para autorizar com o MCPEmails. Nenhuma chave de API entra na história.
| 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 VS Code se conecta: OAuth, sem chave de API
O VS Code 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 VS Code à 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.
Rode MCP: Add Server
Abra a Paleta de Comandos com Shift Cmd P, ou Shift Ctrl P no Windows e no Linux, e rode MCP: Add Server (adicionar servidor; o nome do comando aparece em inglês na interface em inglês).
Escolha HTTP e Global
Escolha HTTP (HTTP or Server-Sent Events), cole https://mcpemails.com/api/mcp e digite mcpemails como ID do servidor. Como destino, escolha Global e depois Copilot Global. O VS Code grava a entrada abaixo em ~/.copilot/mcp-config.json.
Autorize
Aprove o pedido de login e autorize com o MCPEmails. Aprove os escopos que você quer que o Copilot tenha.
{
"mcpServers": {
"mcpemails": {
"type": "http",
"url": "https://mcpemails.com/api/mcp"
}
}
}Documentação oficial do VS Code sobre servidores MCP remotos: https://code.visualstudio.com/docs/copilot/customization/mcp-servers
Prefere um passo a passo completo? E-mail para agentes de IA no Cursor, Cline e VS Code
Na dúvida sobre qual caixa de correio conectar primeiro? Veja a tabela de compatibilidade de provedores
Onde as pessoas costumam tropeçar no VS Code
O transporte é mesmo HTTP, não stdio, e escolher errado falha em silêncio
O fluxo Add Server oferece primeiro um servidor stdio baseado em comando, que é o que a maioria dos servidores MCP é. Este é remoto e hospedado, então não tem comando para rodar. Escolha HTTP, e repare que a chave de configuração é type definida como http. Uma entrada stdio apontada para uma URL gera um servidor que nunca inicia, sem motivo aparente.
As ferramentas só aparecem no modo agente
As ferramentas MCP ficam disponíveis para o Copilot no modo agente. Se as ferramentas de e-mail não aparecem no seletor de ferramentas depois de uma conexão bem-sucedida, a causa comum é estar no modo de pergunta ou de edição, e não no modo agente. A visão MCP é onde você confirma que o servidor está mesmo rodando.
Escolha Global e mantenha as chaves fora dos repositórios
O destino Global grava ~/.copilot/mcp-config.json na sua pasta pessoal, fora de qualquer projeto. O antigo .vscode/mcp.json, com um objeto servers no nível de cima, ainda funciona, mas o fluxo guiado o marca como obsoleto, e ele fica dentro do projeto, onde pode ser commitado. A URL é pública e os tokens OAuth não são gravados em nenhum dos dois arquivos. Isso deixa de valer no momento em que alguém escreve uma chave de API bearer direto no arquivo. Qualquer chave que chegue a um repositório deve ser revogada no painel, em Chaves de API.
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.
VS Code e e-mail: perguntas e respostas
Como conecto o e-mail ao VS Code?
Rode MCP: Add Server na Paleta de Comandos, escolha HTTP, cole https://mcpemails.com/api/mcp, escolha Global e depois Copilot Global, e aprove o pedido de login. O modo agente do Copilot passa a ter ferramentas para ler, pesquisar, enviar, responder, encaminhar, organizar e agendar e-mails.
Preciso de uma chave de API para o VS Code?
Não. O VS Code executa o fluxo OAuth no navegador com este servidor, então nenhum token é gravado na sua configuração. Uma chave de API bearer continua disponível para uso headless ou em scripts.
Funciona com o Copilot em outros editores?
Esta página trata especificamente do VS Code, porque o fluxo Add Server é um recurso do VS Code. O JetBrains AI Assistant tem uma configuração separada e usa uma chave de API bearer em vez de OAuth; há uma página para ele.
Quais caixas de correio o VS Code 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 VS Code 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 VS Code uma caixa de entrada real
Um comando, um login. Uma caixa de entrada grátis para sempre, sem cartão.