Guía práctica
Conectar otros clientes MCP
Añade el servidor MCP alojado de Emailit a VS Code, Windsurf, Zed o cualquier cliente compatible con servidores remotos Streamable HTTP, con OAuth o con una clave de API.
Cualquier cliente MCP compatible con servidores remotos por Streamable HTTP puede usar Emailit. Todos los clientes necesitan lo mismo: la URL del servidor y una forma de autenticarse.
| Ajuste | Valor |
|---|---|
| URL | https://api.emailit.com/mcp |
| Transporte | Streamable HTTP (algunos clientes lo llaman http o streamable-http) |
| OAuth | Se descubre a partir de https://api.emailit.com/.well-known/oauth-protected-resource/mcp. Los clientes se registran con el registro dinámico de clientes o con un documento de metadatos del ID de cliente, y usan PKCE. |
| Alternativa con clave de API | Cabecera Authorization: Bearer your_api_key |
| Opciones | ?toolsets=… y ?read_only=true, o las cabeceras X-MCP-Toolsets y X-MCP-Readonly. Consulta Conjuntos de herramientas. |
El servidor no tiene estado: los clientes envían mensajes JSON-RPC con POST y no necesitan mantener una sesión.
Usa OAuth cuando trabajes de forma interactiva: eliges los espacios de trabajo en el navegador y no se guarda ninguna clave en el disco. Usa una clave de API en las configuraciones sin interfaz y con los clientes que no admiten la autorización de MCP.
VS Code
VS Code usa los servidores MCP en el modo agente de Copilot Chat. Añade el servidor a .vscode/mcp.json en tu espacio de trabajo, o ejecuta MCP: Add Server desde la paleta de comandos y elige HTTP:
{
"servers": {
"emailit": {
"type": "http",
"url": "https://api.emailit.com/mcp"
}
}
}Inicia el servidor desde la lista de servidores MCP y completa el inicio de sesión en Emailit en tu navegador.
Windsurf
Añade el servidor en la configuración MCP de Windsurf (el archivo mcp_config.json):
{
"mcpServers": {
"emailit": {
"serverUrl": "https://api.emailit.com/mcp"
}
}
}Si tu versión de Windsurf no admite OAuth con servidores remotos, añade en su lugar una cabecera Authorization con una clave de API.
Zed
Zed se conecta a servidores remotos a través de su configuración de servidores de contexto (context servers). Añade un servidor llamado emailit con la URL https://api.emailit.com/mcp y, si Zed no te pide que inicies sesión, una cabecera Authorization: Bearer your_api_key. Consulta la documentación de Zed para conocer el formato de configuración actual.
Cualquier otro cliente
Apunta el cliente a https://api.emailit.com/mcp. Si admite la autorización de MCP, lee el documento de descubrimiento, se registra y abre la página de inicio de sesión de Emailit. Si no, envía una clave de API:
{
"mcpServers": {
"emailit": {
"url": "https://api.emailit.com/mcp",
"headers": {
"Authorization": "Bearer your_api_key"
}
}
}
}Una conexión con clave de API solo funciona en el espacio de trabajo de la clave y solo lista las herramientas que permite el permiso de la clave: una clave Sending Only expone las herramientas de envío de emails y nada más.
Ejecutarlo en local
Para los clientes que solo admiten servidores stdio, usa el servidor local de código abierto. Cubre el conjunto original de herramientas; el servidor alojado tiene las 109 herramientas.