Guide pratique

Connecter d’autres clients MCP

Ajoutez le serveur MCP Emailit hébergé à VS Code, Windsurf, Zed ou à tout client qui prend en charge les serveurs distants Streamable HTTP, avec OAuth ou une clé API.

Mis à jour le 2 oct. 2026

Tout client MCP qui prend en charge les serveurs distants via Streamable HTTP peut utiliser Emailit. Chaque client a besoin des deux mêmes éléments : l’URL du serveur et un moyen de s’authentifier.

Paramètre	Valeur
URL	`https://api.emailit.com/mcp`
Transport	Streamable HTTP (certains clients l’appellent `http` ou `streamable-http`)
OAuth	Découvert à partir de `https://api.emailit.com/.well-known/oauth-protected-resource/mcp`. Les clients s’enregistrent par enregistrement dynamique de client ou avec un document de métadonnées d’ID client, et utilisent PKCE.
Alternative par clé API	En-tête `Authorization: Bearer your_api_key`
Options	`?toolsets=…` et `?read_only=true`, ou les en-têtes `X-MCP-Toolsets` et `X-MCP-Readonly`. Voir Groupes d’outils.

Le serveur est sans état : les clients envoient des messages JSON-RPC avec POST et n’ont pas besoin de conserver de session.

Utilisez OAuth quand vous travaillez de façon interactive : vous choisissez les espaces de travail dans le navigateur et aucune clé n’est stockée sur le disque. Utilisez une clé API pour les configurations sans interface et pour les clients qui ne prennent pas en charge l’autorisation MCP.

VS Code

VS Code utilise les serveurs MCP dans le mode agent de Copilot Chat. Ajoutez le serveur à .vscode/mcp.json dans votre espace de travail, ou exécutez MCP: Add Server depuis la palette de commandes et choisissez HTTP :

.vscode/mcp.json

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

Démarrez le serveur depuis la liste des serveurs MCP et terminez la connexion à Emailit dans votre navigateur.

Windsurf

Ajoutez le serveur dans les paramètres MCP de Windsurf (le fichier mcp_config.json) :

mcp_config.json

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

Si votre version de Windsurf ne prend pas en charge OAuth pour les serveurs distants, ajoutez plutôt un en-tête Authorization avec une clé API.

Zed

Zed se connecte aux serveurs distants via ses paramètres de serveurs de contexte. Ajoutez un serveur nommé emailit avec l’URL https://api.emailit.com/mcp et, si Zed ne vous invite pas à vous connecter, un en-tête Authorization: Bearer your_api_key. Consultez la documentation de Zed pour connaître le format actuel des paramètres.

Tout autre client

Faites pointer le client vers https://api.emailit.com/mcp. S’il prend en charge l’autorisation MCP, il lit le document de découverte, s’enregistre et ouvre la page de connexion Emailit. Sinon, envoyez une clé API :

mcp.json

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

Une connexion par clé API ne fonctionne que dans l’espace de travail de la clé et ne liste que les outils autorisés par la portée de la clé : une clé Sending Only n’expose que les outils d’envoi d’e-mails, rien d’autre.

L’exécuter plutôt en local

Pour les clients qui ne prennent en charge que les serveurs stdio, utilisez le serveur local open source. Il couvre l’ensemble d’outils d’origine ; le serveur hébergé dispose des 109 outils.