Guia prático

Conectar outros clientes MCP

Adicione o servidor MCP hospedado do Emailit ao VS Code, ao Windsurf, ao Zed ou a qualquer cliente compatível com servidores remotos Streamable HTTP, com OAuth ou com uma chave de API.

Atualizado em 2 de out. de 2026

Qualquer cliente MCP compatível com servidores remotos via Streamable HTTP pode usar o Emailit. Todos os clientes precisam das mesmas duas coisas: a URL do servidor e uma forma de autenticação.

Configuração	Valor
URL	`https://api.emailit.com/mcp`
Transporte	Streamable HTTP (alguns clientes o chamam de `http` ou `streamable-http`)
OAuth	Descoberto a partir de `https://api.emailit.com/.well-known/oauth-protected-resource/mcp`. Os clientes se registram com o registro dinâmico de clientes ou com um documento de metadados do client ID e usam PKCE.
Alternativa com chave de API	Cabeçalho `Authorization: Bearer your_api_key`
Opções	`?toolsets=…` e `?read_only=true`, ou os cabeçalhos `X-MCP-Toolsets` e `X-MCP-Readonly`. Consulte Toolsets.

O servidor não tem estado: os clientes enviam mensagens JSON-RPC com POST e não precisam manter uma sessão.

Use OAuth quando trabalhar de forma interativa: você escolhe os workspaces no navegador e nenhuma chave fica guardada em disco. Use uma chave de API em configurações headless e em clientes que não são compatíveis com a autorização do MCP.

VS Code

O VS Code usa servidores MCP no modo agente do Copilot Chat. Adicione o servidor a .vscode/mcp.json no seu workspace ou execute MCP: Add Server na Command Palette e escolha HTTP:

.vscode/mcp.json

{
  "servers": {
    "emailit": {
      "type": "http",
      "url": "https://api.emailit.com/mcp"
    }
  }
}

Inicie o servidor na lista de servidores MCP e conclua o login no Emailit no navegador.

Windsurf

Adicione o servidor nas configurações de MCP do Windsurf (o arquivo mcp_config.json):

mcp_config.json

{
  "mcpServers": {
    "emailit": {
      "serverUrl": "https://api.emailit.com/mcp"
    }
  }
}

Se a sua versão do Windsurf não for compatível com OAuth para servidores remotos, adicione um cabeçalho Authorization com uma chave de API.

Zed

O Zed se conecta a servidores remotos pelas configurações de context servers. Adicione um servidor chamado emailit com a URL https://api.emailit.com/mcp e, se o Zed não pedir para você fazer login, um cabeçalho Authorization: Bearer your_api_key. Consulte a documentação do Zed para ver o formato atual das configurações.

Qualquer outro cliente

Aponte o cliente para https://api.emailit.com/mcp. Quando ele é compatível com a autorização do MCP, lê o documento de descoberta, se registra e abre a página de login do Emailit. Caso contrário, envie uma chave de API:

mcp.json

{
  "mcpServers": {
    "emailit": {
      "url": "https://api.emailit.com/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Uma conexão com chave de API funciona apenas no workspace da chave e lista só as ferramentas que o escopo da chave permite: uma chave Sending Only expõe as ferramentas de envio de e-mails e nada mais.

Executar localmente

Para clientes que só aceitam servidores stdio, use o servidor local de código aberto. Ele cobre o conjunto original de ferramentas; o servidor hospedado tem todas as 109 ferramentas.