Mailbox MCP

Toda a documentação

Configuração em 4 passos

Os mesmos 4 passos em todos os clientes. Apenas o terceiro difere, e a página do seu próprio cliente diz exatamente como fazer.

1. Crie uma conta e adicione uma caixa de correio

   Cadastre-se no painel de controle e adicione a caixa de correio que você quer que seu assistente acesse. Gmail, Microsoft 365 ou qualquer serviço que fale IMAP.

2. Copie a URL do seu conector

   Cada caixa de correio tem a sua própria, e você a copia da aba Conector daquela caixa de correio no seu painel de controle. Ela se parece com https://mcp.mailbox-mcp.com/db/mcp/YOUR-MAILBOX-KEY, com uma chave no final que identifica a caixa de correio. Os trechos abaixo mostram esse espaço reservado, então substitua-o pelo seu. Use a URL certa para cada caixa de correio em vez de usar a mesma duas vezes: o Claude e vários outros clientes tratam 2 conectores com o mesmo endereço como um único conector, então uma URL compartilhada faz sua segunda caixa de correio se recusar a ser adicionada.

3. Coloque-a no seu cliente

   Uma tela de configurações nos clientes de chat, um arquivo JSON ou YAML nos editores. Encontre seu cliente abaixo: a página nomeia o arquivo, a chave e o valor de transporte que ele espera.

Adicionando a caixa de correio

O passo um tem 3 partes e o painel guia você por elas, mas vale a pena saber o que ele vai pedir antes de começar.

• Parte um

  Qual provedor

  O Microsoft 365 faz seu login e não há senha para encontrar. O Gmail quer uma senha de aplicativo. Todo o resto quer 4 configurações que seu cliente de e-mail atual já possui.
• Parte 2

  A verificação de conexão

  O painel abre a caixa de correio antes de salvar qualquer coisa, então um nome de servidor errado ou uma senha rejeitada aparece como uma mensagem no formulário, em vez de uma ferramenta que silenciosamente não retorna nada na semana seguinte.
• Parte 3

  Um nome que você vai reconhecer

  Dê o nome pela caixa de correio, não por nós. Seu cliente lista os conectores por esse nome, e 3 deles chamados mcp-server não dizem nada um mês depois.

O passo que não temos

A maioria das documentações de configuração para um servidor MCP remoto tem um passo em que você copia um client ID e um client secret de um painel e os cola em outro. A nossa não tem, e a diferença merece um parágrafo porque muda o que você precisa manter seguro depois.

Este servidor faz registro dinâmico de cliente, a parte da especificação OAuth que permite que um cliente se apresente e receba credenciais na hora. Seu cliente pergunta ao servidor com quem deve falar, o servidor informa, e os dois resolvem isso entre si. Você cola uma URL e aperta um botão.

Então, quando um cliente mostra uma seção OAuth avançado com campos vazios para client ID e secret, deixe-os vazios. Eles existem para servidores que não conseguem fazer isso. Preenchê-los aqui não torna a conexão mais segura; dá a ela mais uma coisa para dar errado e coloca uma credencial na sua área de transferência que nunca precisava estar lá.

Encontre seu cliente

Cada página nomeia o arquivo, a chave, o valor de transporte e o caminho na interface, e termina na página do fornecedor de onde foi lida e no dia em que foi lida.

Assistentes de IA

Clientes de chat. Cole uma URL, faça login, pronto.

• Configurações, Conectores, Adicionar conector personalizado. Uma URL e um login. Os campos avançados de OAuth ficam vazios, o oposto do que a maioria dos guias de configuração diz.
• A mesma tela de Conectores da web, e a mesma URL. Merece sua própria página porque a maioria dos guias de configuração para desktop ainda manda você para um arquivo JSON e uma ponte local que você não precisa.
• O Plus não precisa de administrador, e enviamos e-mails reais por uma conta Plus nele. Business e Enterprise/Edu precisam que um administrador ative o modo de desenvolvedor primeiro. Somente web.

Editores e agentes de codificação

Um arquivo JSON ou YAML, e as chaves diferem em cada um.

• Um único comando, e uma flag que decide se a caixa de correio segue você entre projetos ou desaparece quando você muda de diretório.

• Cursor

  Apenas URL, provavelmente 2 linhas de JSON em mcpServers. O Cursor documenta uma chave type apenas para servidores locais, então uma entrada remota que a carrega foi copiada de onde não pertencia.
• O único cliente onde a chave de nível superior é servers, não mcpServers. Cole a errada e nada aparece, sem erro para explicar o porquê.
• A chave é context_servers, e a ausência de um bloco headers é uma configuração, não uma omissão. É o que diz ao Zed para fazer login em vez de esperar um token.

• Windsurf

  Apenas URL, provavelmente A chave da URL é serverUrl, que nenhum outro cliente usa. E a documentação em que você vai cair é da marca Devin, então você vai achar que está na página errada.

• Cline

  URL e um token de acesso O transporte é streamableHttp em camel case, único entre todos os clientes aqui. E OAuth não aparece em lugar nenhum na documentação do Cline, então este aceita um token de acesso.

Agentes e automação

Plataformas que rodam sem alguém assistindo.

• Goose

  URL e um token de acesso YAML em vez de JSON, extensions em vez de mcpServers, uri em vez de url, e streamable_http com sublinhado. Nada aqui combina com qualquer outra coisa.

• LibreChat

  URL e um token de acesso O transporte é streamable-http com hífen. Um token dá a todos a conexão do proprietário; Team Access dá a cada pessoa sua própria entrada, nível e login.

• n8n

  URL e um token de acesso A documentação e o nó discordam. Quais campos você vê depende da versão do nó no seu fluxo de trabalho, e um antigo não consegue fazer MCP OAuth de jeito nenhum.
• Escolha Dynamic discovery e ele não precisa de nada além da URL. 2 armadilhas primeiro: orquestração generativa está desligada por padrão, e as políticas DLP do seu locatário também governam servidores MCP.

Para administradores

Se sua organização exige que um administrador aprove aplicativos de terceiros, a pessoa conectando uma caixa de correio é parada na tela da Microsoft ou do Google e recebe uma nota para encaminhar. Estas 2 páginas são o que o administrador lê: o aplicativo por seus identificadores, o que ele pede e por quê, a aprovação em um passo e como revogá-la.

• Administradores do Microsoft 365

  Leia antes de aprovar Escrito para o administrador para quem um usuário do Microsoft 365 foi enviado: o aplicativo pelo seu ID, as permissões e para que serve cada uma, o link de aprovação para todo o locatário e como revogá-lo.

• Administradores do Google Workspace

  Leia antes de aprovar O Gmail não precisa de nada seu: uma senha de aplicativo via IMAP, sem cliente OAuth para colocar na lista de permissões. O aplicativo de calendário precisa: seu client ID, seus 3 escopos e o caminho no Admin console para marcá-lo como Confiável.

Se a aprovação vier com um questionário de segurança do fornecedor, a página abaixo responde: onde o serviço roda e em qual país, quem são os subprocessadores, o que é mantido e por quanto tempo, como uma violação é notificada e o que não temos.

• Para TI e segurança

  Para o questionário As respostas que um questionário de fornecedor pede, na ordem em que pede: onde roda, quem são os subprocessadores, o que é mantido e por quanto tempo, como uma violação é notificada e o que não temos.

9 clientes, 4 nomes para uma chave

Esta é a tabela que não encontramos em nenhum outro lugar, e é por isso que está aqui. Cada valor foi lido da documentação oficial do respectivo fornecedor em 30 de agosto de 2026, e a razão de valer a pena é que cada um desses clientes está sendo configurado para o mesmo servidor, pelo mesmo transporte, e nenhum dois o descrevem da mesma forma.

Cliente	Chave de nível superior	Chave da URL	Transporte
Claude Code	mcpServers	url	"type": "http"
Cursor	mcpServers	url	nenhum documentado
VS Code	servers	url	"type": "http"
Zed	context_servers	url	nenhum documentado
Windsurf	mcpServers	serverUrl	nenhum documentado
Cline	mcpServers	url	"type": "streamableHttp"
Goose	extensions	uri	type: streamable_http
LibreChat	mcpServers	url	type: streamable-http
n8n	sem arquivo	Endpoint	HTTP Streamable

Lido em 30 de agosto de 2026. Cada linha vem da documentação atual do respectivo fornecedor, vinculada no rodapé da sua página aqui. Quando a página de um cliente nomeava um transporte em prosa mas não documentava uma chave para ele, a célula diz isso em vez de repetir a prosa como se fosse um campo.

Um transporte, 5 grafias

Cada cliente nessa tabela se conecta via Streamable HTTP. 4 deles querem que você digite o nome num arquivo, e nenhum dois o escrevem igual: http, streamableHttp, streamable_http e streamable-http. Camel case, snake case, kebab case e uma palavra simples, para a mesma coisa. O n8n o transforma numa escolha de menu e o chama de HTTP Streamable, que é uma quinta grafia e a única com espaço.

Isso não é descuido de ninguém. O protocolo diz como um cliente e um servidor conversam uma vez conectados e não diz nada sobre a aparência do arquivo de configuração, então cada cliente inventou seu próprio vocabulário e cada um está certo dentro do seu próprio programa. Só vira uma armadilha quando você configura um segundo cliente adaptando o trecho do primeiro, que é o que todo mundo faz, inclusive nós: o painel de controle enviou um bloco JSON para 3 clientes e não funcionou em nenhum deles até esta leitura ser feita.

O formato do erro

Uma chave errada geralmente não produz um erro. O cliente lê um arquivo que não reconhece, não encontra nada que entenda e inicia sem servidor anexado, o que parece exatamente um servidor fora do ar. Se um cliente não mostra nenhuma ferramenta, desconfie da chave antes de desconfiar de nós.

3 sites de documentação que mudaram

Se você pesquisou pela documentação MCP do seu cliente antes de chegar aqui, há uma boa chance de ter caído em algo desatualizado. 3 das páginas nas quais esta seção se baseia não estão mais onde os resultados de busca apontam:

• docs.claude.com/en/docs/claude-code/mcp 301 code.claude.com/docs/en/mcp
• docs.windsurf.com/windsurf/cascade/mcp 307 docs.devin.ai/desktop/cascade/mcp
• block.github.io/goose/docs/ 404 A documentação do Goose está em goose-docs.ai

A do Windsurf é a que merece atenção. Sua documentação MCP agora é servida sob a marca Devin da Cognition e a página usa "Devin" e "Windsurf" de forma intercambiável, então um leitor que segue o redirecionamento conclui razoavelmente que está na página errada e volta a pesquisar.

O que digitar primeiro

Um conector configurado corretamente não diz nada, então a forma honesta de verificá-lo é usá-lo. Peça algo que você possa verificar na sua própria caixa de correio num relance.

Tente isto primeiro

Resuma meus 5 e-mails não lidos mais recentes, do mais antigo para o mais novo, e me diga quais realmente precisam de mim.

Se as mensagens que ele nomeia são as mensagens que você espera, o conector funciona. Nada é marcado como lido ao perguntar: ler através deste servidor nunca define o sinalizador de visto, então seus marcadores de não lido sobrevivem ao teste.

Quando isso funcionar, os casos de uso valem uma olhada para as coisas menos óbvias, e a referência completa de ferramentas lista tudo que um assistente pode acessar e marca quais ferramentas são somente leitura.

Perguntas frequentes

Preciso de um client ID e um client secret?

Não. Este servidor registra seu cliente para você na primeira conexão, usando a parte de registro dinâmico de cliente da especificação OAuth. Você cola uma URL e faz login. Se um guia de configuração pedir para você copiar um client ID e um secret de um painel, ele está descrevendo um servidor que não consegue fazer isso, e colar valores nesses campos aqui só dá à conexão algo mais para dar errado.

Em qual arquivo de configuração o trecho vai?

Depende do cliente, e cada página nesta seção nomeia o arquivo no topo do bloco, porque um trecho correto no arquivo errado é a forma mais comum de uma configuração falhar silenciosamente. O Cursor lê ~/.cursor/mcp.json, o VS Code lê .vscode/mcp.json ou um arquivo de usuário que ele abre por comando, o Zed lê seu settings.json e o Goose lê ~/.config/goose/config.yaml.

Por que a chave de nível superior muda entre clientes? Porque nenhum padrão o nomeia. O protocolo especifica como um cliente e um servidor conversam uma vez conectados; ele não especifica como o arquivo de configuração se parece. Então Cursor, Windsurf, Cline e LibreChat usam mcpServers, VS Code usa servers, Zed usa context_servers e Goose usa extensions, e todos os 4 estão corretos para seus próprios clientes.

Ler uma mensagem marca como lida?

Não. Ler através deste servidor nunca define o sinalizador seen, então um assistente pode percorrer um acúmulo sem destruir seus próprios marcadores de não lido. Isso é uma regra de design deliberada, não um efeito colateral, e é verificada contra uma caixa de correio real, não apenas afirmada. Marcar algo como lido é uma ferramenta separada que só é executada quando você pede.

Meu cliente não está nesta lista. Ainda funcionará?

Provavelmente. Este é um servidor MCP remoto comum sobre Streamable HTTP, então qualquer coisa que fale o protocolo pode usá-lo, e os SDKs falam diretamente com ele. As páginas aqui existem porque as configurações ficam em lugares diferentes em cada cliente, não porque o servidor precisa de algo especial de qualquer um deles. Diga-nos qual cliente você está usando e leremos sua documentação e adicionaremos uma página.

O que acontece com a conexão se eu mudar minha senha da caixa de correio?

A caixa de correio para de responder e as ferramentas começam a falhar, porque a credencial que temos é a que você nos deu. Atualize-a no painel de controle e o conector volta a funcionar. A URL do conector em si não muda, então nada no seu cliente precisa ser tocado.

Preciso do ChatGPT Business para conectar um servidor MCP?

Não. ChatGPT Plus é suficiente, e você ativa o modo de desenvolvedor sozinho, sem administrador. Conectamos este servidor a uma conta Plus em um navegador em 1º de setembro de 2026 e ele leu, pesquisou e enviou. O FAQ da OpenAI diz que MCP completo é um recurso Business e Enterprise/Edu e dá até mesmo Pro leitura e fetch, e não menciona Plus de forma alguma, então trate isso como testado, não prometido. Free não foi testado.

O ChatGPT pode enviar e-mail através de um servidor MCP?

Sim. A afirmação de que MCP no ChatGPT é somente leitura descrevia um modelo de conector anterior. Pedimos a uma conta Plus para enviar um e-mail sem ferramenta e sem pasta nomeada, e a mensagem foi entregue do endereço correto com a assinatura da própria conta. O ChatGPT pede confirmação antes de algumas ações de escrita, dependendo das permissões do aplicativo, e a OpenAI bloqueia algumas especialmente arriscadas diretamente, em vez de oferecê-las para aprovação.

Minha caixa de correio funcionará no aplicativo de telefone do ChatGPT?

Não. A OpenAI responde isso diretamente: aplicativos MCP são somente web. Configure o conector em um navegador e espere que ele esteja ausente no celular. Se você quiser a mesma caixa de correio no telefone, o Claude.ai a suporta em qualquer plano e seus aplicativos móveis veem o conector como qualquer outro.

Alguma coisa disso é específica do Claude?

Não, e a tabela-chave nesta página é a evidência. Claude foi o primeiro cliente que a maioria das pessoas conectou porque foi o primeiro a lançar suporte remoto a MCP, mas há 13 clientes documentados aqui e o servidor não consegue distingui-los. Ele responde ao protocolo, não a uma marca.

O que esta seção não cobre

A mesma regra do resto do site. Dizer o que está faltando é mais barato do que deixar alguém descobrir.

• Não é documentação de protocolo

  Se você está construindo seu próprio servidor MCP em vez de conectar a um, a especificação em modelcontextprotocol.io é o que deve ler. Estas páginas são sobre configurar clientes.

• Sem capturas de tela do painel

  Telas do painel de controle ficam desatualizadas mais rápido do que qualquer outra coisa em um site, e uma errada custa mais do que uma ausente. O painel se descreve enquanto você o usa.

• Sem preços de outros fornecedores

  Se o seu cliente precisa de um nível pago para MCP é algo que o fornecedor deve declarar, e isso muda. Cada página linka para a página deles em vez de repetir um número que estará errado.

• E-mail e um calendário que você conecta

  Este servidor lê e escreve e-mails, e um calendário uma vez que um tenha sido conectado à caixa de correio, que é uma etapa separada. Sem contatos, sem arquivos em um drive.