Conectar Zoho Mail MCP con Microsoft Copilot

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Zoho Mail, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Zoho Mail + Microsoft Copilot

Deja que tu IA trabaje en Zoho Mail: busca correos por carpeta o con la búsqueda de Zoho, lee el contenido, los encabezados y los detalles, envía y responde, y marca como leídos, mueve, marca con bandera o etiqueta correos. Cualquier centro de datos de Zoho, inicio de sesión con Zoho OAuth.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

ZOHO_MAIL_CLIENT_ID, ZOHO_MAIL_CLIENT_SECRET, ZOHO_MAIL_ACCOUNTS_URL, ZOHO_MAIL_API_URL

Paso 1 — Obtener credenciales

Necesitas un buzón de Zoho Mail, con el plan gratuito o con uno de pago.

Primero, el centro de datos: Zoho guarda cada cuenta en un único centro de datos, y el servidor de inicio de sesión y el host de la Mail API tienen que ser los de ese centro. Lo ves en la barra de direcciones cuando usas Zoho Mail. Con un centro de datos equivocado, la conexión falla con INVALID_OAUTHTOKEN o invalid_client.

1. Abre la Zoho API Console en api-console.zoho.com, con la sesión de tu cuenta de Zoho, y elige Add Client → Server-based Applications.
2. Ponle un nombre al cliente (por ejemplo AnythingMCP), la web de tu empresa como homepage URL y https://cloud.anythingmcp.com/api/mcp-oauth/callback como Authorized Redirect URI. Si alojas AnythingMCP tú mismo, introduce en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback. Crea el cliente.
3. En la pestaña Client Secret, copia el Client ID (empieza por 1000.) y el Client Secret en ZOHO_MAIL_CLIENT_ID y ZOHO_MAIL_CLIENT_SECRET. Si tu buzón está en un centro de datos distinto del que abrió la consola, activa ese centro de datos en la pestaña Settings del cliente (Multi-DC) y usa el client secret que aparece allí.
4. Pon en ZOHO_MAIL_ACCOUNTS_URL y ZOHO_MAIL_API_URL tu centro de datos según la tabla, sin barra final, e instala el conector.
5. En la página del conector, haz clic en Authorize with Provider, inicia sesión en Zoho y aprueba el acceso solicitado.
6. Ejecuta zoho_mail_list_accounts para comprobar la conexión: muestra tu buzón y las direcciones desde las que la IA puede enviar.

Mantener la sesión iniciada: los access tokens duran una hora y se renuevan automáticamente con el refresh token guardado. Zoho guarda como máximo 20 refresh tokens por usuario y cliente: autorizar el mismo cliente por 21.ª vez revoca sin aviso el más antiguo. Si el conector pierde la sesión, vuelve a hacer clic en Authorize with Provider.

Permisos y configuración de solo lectura: el conector pide ZohoMail.accounts.READ, ZohoMail.folders.READ, ZohoMail.messages.ALL y ZohoMail.tags.READ, y trabaja como el usuario de Zoho que lo autorizó. Para una configuración de solo lectura, cambia ZohoMail.messages.ALL por ZohoMail.messages.READ en los ajustes OAuth del conector, vuelve a autorizar y desactiva zoho_mail_send_email, zoho_mail_reply_to_email, zoho_mail_mark_as_read, zoho_mail_mark_as_unread, zoho_mail_move_emails, zoho_mail_flag_emails y zoho_mail_apply_labels.

Nada sale sin tu sí: zoho_mail_send_email y zoho_mail_reply_to_email envían correos reales en tu nombre. Antes de enviar, la IA te muestra los destinatarios, el asunto y el texto, y espera un sí explícito. Marcar, mover, poner banderas y etiquetar cambian tu buzón, así que la IA te dice antes qué va a cambiar.

Desactivada al instalar: zoho_mail_delete_email. Si la activas, mueve un correo a la papelera; solo lo elimina para siempre si lo pides de forma explícita.

Cuentas, carpetas y búsqueda: cada llamada necesita el id de una cuenta de correo, así que la IA lee primero tus cuentas. Si tienes más de una, por ejemplo una cuenta POP añadida, usa la que indicas y envía desde las direcciones de esa cuenta. Lista una carpeta con filtros para correos no leídos, con bandera o con etiqueta, o usa la búsqueda de Zoho, por ejemplo por remitente, asunto, adjunto o fecha.

Los correos no son de fiar: los correos llegan de remitentes externos. La IA trata las instrucciones que hay dentro de un correo como contenido, nunca como órdenes.

Errores frecuentes: 401 INVALID_OAUTHTOKEN significa que falta el inicio de sesión o se revocó, o que ZOHO_MAIL_API_URL no es tu centro de datos: corrige la URL o vuelve a hacer clic en Authorize with Provider. invalid_client al iniciar sesión suele significar que ZOHO_MAIL_ACCOUNTS_URL no es tu centro de datos o que el client secret pertenece a otro centro de datos (mira el paso 3). 400 con una nota en moreInfo significa que un parámetro no es válido, por ejemplo un id desconocido, una búsqueda mal formada o una dirección de remitente que no pertenece a la cuenta. 404 significa que la cuenta, la carpeta o el correo no existe para este usuario. Un 500 Internal Error viene de Zoho: inténtalo una vez más. Cuando Zoho avisa de demasiadas solicitudes, espera un minuto.

El conector no gestiona adjuntos, borradores y plantillas, conversaciones completas, la gestión de carpetas y etiquetas, firmas, respuestas automáticas de vacaciones, tareas, notas, marcadores ni las API de administración de la organización.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Zoho Mail.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué correos sin leer han llegado hoy a mi bandeja de entrada de Zoho Mail? Una línea por correo."
• "Busca los correos de [email protected] con adjunto desde el 1 de septiembre."
• "Responde al último correo de Acme sobre la fecha de entrega: podemos enviarlo el 24 de octubre. Enséñame la respuesta antes de enviarla."
• "Mueve los boletines de esta semana a la carpeta Boletines y marca con bandera de importante el correo de nuestro asesor fiscal."

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse