Guida pratica

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.

Aggiornato il 2 ott 2026

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.

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:

.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):

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:

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 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 open source. Copre il set di strumenti originale; il server ospitato ha tutti i 109 strumenti.