# Collega altri client MCP

> Aggiungi il server MCP ospitato di Emailit a VS Code, Windsurf, Zed o a qualsiasi client che supporti server remoti Streamable HTTP, con OAuth o con una chiave API.

Qualsiasi client MCP che supporti server remoti via Streamable HTTP può usare Emailit. A ogni client servono le stesse due cose: l’URL del server e un modo per autenticarsi.

| Impostazione | Valore |
| --- | --- |
| URL | `https://api.emailit.com/mcp` |
| Trasporto | Streamable HTTP (alcuni client lo chiamano `http` o `streamable-http`) |
| OAuth | Individuato tramite `https://api.emailit.com/.well-known/oauth-protected-resource/mcp`. I client si registrano con la registrazione dinamica del client o con un documento di metadati del client ID (CIMD), e usano PKCE. |
| In alternativa, chiave API | Header `Authorization: Bearer your_api_key` |
| Opzioni | `?toolsets=…` e `?read_only=true`, oppure gli header `X-MCP-Toolsets` e `X-MCP-Readonly`. Vedi [Toolset](/it/docs/mcp/toolsets/). |

Il server è stateless: i client inviano messaggi JSON-RPC con `POST` e non devono mantenere una sessione.

Usa OAuth quando lavori in modo interattivo: scegli i workspace nel browser e nessuna chiave viene salvata su disco. Usa una chiave API per le configurazioni headless e per i client che non supportano l’autorizzazione MCP.

## VS Code

VS Code usa i server MCP nella modalità agente di Copilot Chat. Aggiungi il server a `.vscode/mcp.json` nel tuo workspace, oppure esegui **MCP: Add Server** dalla Command Palette e scegli **HTTP**:

```json title=".vscode/mcp.json"
{
  "servers": {
    "emailit": {
      "type": "http",
      "url": "https://api.emailit.com/mcp"
    }
  }
}
```

Avvia il server dall’elenco dei server MCP e completa l’accesso a Emailit nel browser.

## Windsurf

Aggiungi il server nelle impostazioni MCP di Windsurf (il file `mcp_config.json`):

```json title="mcp_config.json"
{
  "mcpServers": {
    "emailit": {
      "serverUrl": "https://api.emailit.com/mcp"
    }
  }
}
```

Se la tua versione di Windsurf non supporta OAuth per i server remoti, aggiungi invece un header `Authorization` con una chiave API.

## Zed

Zed si collega ai server remoti tramite le impostazioni dei context server. Aggiungi un server chiamato `emailit` con l’URL `https://api.emailit.com/mcp` e, se Zed non ti chiede di accedere, un header `Authorization: Bearer your_api_key`. Controlla la documentazione di Zed per il formato attuale delle impostazioni.

## Qualsiasi altro client

Indirizza il client a `https://api.emailit.com/mcp`. Se supporta l’autorizzazione MCP, legge il documento di individuazione, si registra e apre la pagina di accesso di Emailit. Altrimenti invia una chiave API:

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

Una connessione con chiave API funziona solo nel workspace della chiave ed elenca solo gli strumenti consentiti dal permesso (scope) della chiave: una [chiave di solo invio](/it/docs/developers/api-keys/) espone gli strumenti per l’invio delle email e nient’altro.

## Eseguilo invece in locale

Per i client che supportano solo server stdio, usa il [server locale](/it/docs/mcp/local-server/) open source. Copre il set di strumenti originale; il server ospitato ha tutti i 109 strumenti.

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