Conecte sua caixa de entrada ao Windsurf
e ao Cascade
Adicione uma caixa de correio real ao Cascade no Devin Desktop, antigo Windsurf. Leia, pesquise, envie, responda, encaminhe, agende e organize e-mails pelo editor, em todas as caixas de entrada que você conectou.
O único valor de que você precisa
Devin Desktop é o novo nome do Windsurf. No painel do Cascade, abra o menu ... no canto superior direito e clique em Open MCP config file, na seção MCPs. Adicione uma entrada em mcpServers usando o campo serverUrl, não url, com https://mcpemails.com/api/mcp, salve o arquivo e faça login com o MCPEmails quando for pedido.
| 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 Windsurf se conecta: OAuth, sem chave de API
O Devin Desktop (antigo Windsurf) 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 Windsurf à 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 o arquivo de configuração MCP
No painel do Cascade, clique no menu ... no canto superior direito e, na seção MCPs, clique em Open MCP config file (abrir o arquivo de configuração MCP). O arquivo é ~/.config/devin/mcp_config.json no macOS e no Linux, e %APPDATA%\devin\mcp_config.json no Windows.
Adicione o servidor
Adicione a entrada abaixo. O nome do campo aqui é serverUrl, não url.
Salve e faça login
Salve o arquivo e faça login com o MCPEmails quando for pedido. Aprove os escopos que você quer que o Cascade tenha.
{
"mcpServers": {
"mcpemails": {
"serverUrl": "https://mcpemails.com/api/mcp"
}
}
}Documentação oficial do Windsurf sobre servidores MCP remotos: https://docs.devin.ai/desktop/cascade/mcp
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 Windsurf
O campo é serverUrl, e url falha em silêncio
Esse é o erro mais comum na configuração do Windsurf, e é totalmente compreensível: Cursor, Zed e VS Code leem url, então um trecho copiado de qualquer um deles parece certo. O Devin Desktop lê serverUrl. Com a chave errada, a entrada é lida, o servidor aparece na lista e nenhuma ferramenta chega.
Guias antigos apontam para o caminho de configuração do Windsurf
O Windsurf guardava a configuração MCP em ~/.codeium/windsurf/mcp_config.json, e muitos guias ainda dizem isso. O Devin Desktop usa ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json no Windows). O item Open MCP config file no menu ... do Cascade abre o arquivo que ele realmente lê, então comece por ali em vez de digitar um caminho.
Decida de antemão se o Cascade pode enviar
É na tela de consentimento que isso se resolve. Escopos de leitura e rascunho combinam com um assistente de editor, e deixar send:email de fora significa que nenhum prompt, jailbreak ou loop confuso consegue disparar e-mails a partir desta conexão. A aprovação humana no painel é a proteção extra se você quiser mesmo poder enviar.
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.
Windsurf e e-mail: perguntas e respostas
Como conecto o e-mail ao Windsurf?
No Devin Desktop, antigo Windsurf, abra o menu ... no painel do Cascade e clique em Open MCP config file. Adicione uma entrada em mcpServers com serverUrl definido como https://mcpemails.com/api/mcp, salve e faça login com o MCPEmails quando for pedido. O Cascade passa a ter ferramentas para ler, pesquisar, enviar, responder, encaminhar, organizar e agendar e-mails.
Por que minha configuração do Windsurf não funciona se o mesmo JSON funciona no Cursor?
Quase sempre é o nome do campo. O Cursor lê url, o Devin Desktop lê serverUrl. O resto da entrada é idêntico, e é exatamente por isso que o erro passa por uma leitura cuidadosa.
Preciso de uma chave de API para o Windsurf?
Não. O Devin Desktop (antigo Windsurf) executa o fluxo OAuth com este servidor, então o arquivo de configuração guarda só uma URL pública. Uma chave de API bearer continua disponível para uso em scripts ou headless.
Quais caixas de correio o Windsurf 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 Cascade 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 Cascade uma caixa de entrada real
Uma entrada de configuração, um login. Uma caixa de entrada grátis para sempre, sem cartão.