# 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.

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](/pt/docs/mcp/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**:

```json title=".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`):

```json title="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:

```json title="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](/pt/docs/developers/api-keys/) 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](/pt/docs/mcp/local-server/) de código aberto. Ele cobre o conjunto original de ferramentas; o servidor hospedado tem todas as 109 ferramentas.

---
Fonte: https://emailit.com/pt/docs/mcp/other-clients/