Microsoft Planner a MCP: Pilota Microsoft Planner desde cualquier agente IA

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

Microsoft Planner

Deja que tu IA trabaje con Microsoft Planner: consulta tus tareas en todos los planes, explora los planes y depósitos del equipo, crea y asigna tareas, y actualiza el progreso, las fechas de vencimiento y las listas de comprobación. Cuentas profesionales o educativas de Microsoft 365 a través de Microsoft Graph.

Configuración

1. Abre el centro de administración de Microsoft Entra (entra.microsoft.com) o el portal de Azure y ve a Applications → App registrations → New registration.

2. Ponle un nombre a la app (por ejemplo "AnythingMCP Microsoft 365") y elige los Supported account types. La elección decide qué va en MICROSOFT_TENANT_ID:

   • Accounts in this organizational directory only (un solo inquilino): solo pueden iniciar sesión los usuarios de tu organización. Usa el Directory (tenant) ID de la página Overview de la app (un GUID) o tu dominio, por ejemplo contoso.onmicrosoft.com.
   • Accounts in any organizational directory (multiinquilino): usa organizations.
   • Accounts in any organizational directory and personal Microsoft accounts: no para este conector. Planner no admite cuentas personales de Microsoft, así que consumers no funciona, y con common solo pueden usarlo las cuentas profesionales o educativas.

   Si el valor no coincide con el tipo de cuenta, Microsoft rechaza el inicio de sesión (AADSTS50194 o AADSTS50020).

3. En Redirect URI elige la plataforma Web e introduce https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP tú mismo, introduce en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback. El URI debe coincidir carácter por carácter; si no, Microsoft responde AADSTS50011.

4. Abre API permissions → Add a permission → Microsoft Graph → Delegated permissions y añade offline_access, User.Read y Tasks.ReadWrite. offline_access hace que Microsoft emita un refresh token; sin él, el conector deja de funcionar una hora después de autorizarlo.

5. Abre Certificates & secrets → New client secret. Copia el Value del secreto, no el Secret ID; solo se muestra una vez. Anota la fecha de caducidad: cuando el secreto caduca, el conector deja de funcionar hasta que crees uno nuevo y lo pegues.

6. Pega el Application (client) ID de la página Overview en MICROSOFT_CLIENT_ID, el valor del secreto en MICROSOFT_CLIENT_SECRET y el valor del inquilino del paso 2 en MICROSOFT_TENANT_ID, e instala el conector.

7. En la página del conector, haz clic en Authorize with Provider e inicia sesión con la cuenta profesional o educativa cuyos planes debe usar la IA. El refresh token se guarda cifrado y los access tokens (válidos durante una hora aproximadamente) se renuevan automáticamente.

8. Empieza con microsoft_planner_list_my_tasks: muestra las tareas que tienes asignadas en todos tus planes.

Una sola app de Entra para todos los conectores de Microsoft: el registro de app que creaste para el conector de Outlook, OneDrive, SharePoint o Excel también sirve aquí. Ábrelo, añade el permiso del paso 4 en API permissions, conserva el mismo URI de redirección y reutiliza el mismo ID de cliente, el mismo secreto y el mismo inquilino. Cada conector pide solo sus propios permisos cuando lo autorizas:

• Outlook: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite
• OneDrive: Files.ReadWrite
• Excel: Files.ReadWrite (más Files.ReadWrite.All para libros en SharePoint o compartidos contigo)
• SharePoint: Sites.ReadWrite.All y Files.ReadWrite.All
• OneNote: Notes.ReadWrite
• Microsoft To Do: Tasks.ReadWrite
• Planner: Tasks.ReadWrite

Todos necesitan además offline_access y User.Read.

Consentimiento del administrador: estos permisos delegados normalmente no necesitan un administrador, pero muchas organizaciones desactivan el consentimiento de los usuarios. Si el inicio de sesión muestra "Need admin approval" (AADSTS65001 o AADSTS90094), un administrador del inquilino abre una vez el registro de la app y hace clic en API permissions → Grant admin consent para la organización. Después, cualquier usuario puede autorizar. Cada conector sigue trabajando solo con lo que puede ver la cuenta que inició sesión.

Hace falta una cuenta profesional o educativa: Planner forma parte de Microsoft 365 para organizaciones. Las cuentas personales de Microsoft, como Outlook.com, no tienen Planner y reciben el error 403 o 400. La IA solo ve los planes de los grupos de Microsoft 365 y los equipos de los que eres miembro.

Permisos: a Planner le basta con Tasks.ReadWrite, que por sí solo no requiere un administrador. Group.Read.All o Group.ReadWrite.All también funcionarían, pero necesitan el consentimiento del administrador, así que el conector no los pide. El conector de Microsoft To Do usa el mismo permiso Tasks.ReadWrite.

Solo lectura: sustituye los scopes en los ajustes OAuth del conector por offline_access User.Read Tasks.Read, vuelve a autorizar y desactiva microsoft_planner_create_task, microsoft_planner_update_task, microsoft_planner_update_task_details y microsoft_planner_create_bucket.

Los cambios esperan tu sí: antes de crear, cambiar o mover una tarea o un depósito, la IA te dice qué va a hacer y espera tu sí. Los planes son compartidos, así que todo el grupo ve cada cambio.

Desactivada al instalar: microsoft_planner_delete_task. Eliminar quita la tarea para todo el equipo y el conector no puede deshacerlo, así que actívala solo si la IA de verdad debe eliminar tareas.

Planes, depósitos y asignaciones: los planes de un equipo viven en su grupo de Microsoft 365. La IA busca el grupo, luego el plan, sus depósitos (las columnas del tablero) y sus tareas. El progreso es 0 (no iniciada), 50 (en curso) o 100 (completada), y la prioridad es Urgente, Importante, Media o Baja. La descripción, la lista de comprobación y los enlaces están en los detalles de la tarea. Para asignar una tarea, la IA necesita el id de usuario de la persona: el tuyo sale de microsoft_planner_get_me y el de un compañero, de una tarea que ya tenga asignada, porque el conector no puede buscar personas por nombre. Planner comprueba una etiqueta de versión en cada cambio; si alguien cambió la tarea mientras tanto, la IA la vuelve a leer y lo intenta de nuevo.

Errores frecuentes: 401 InvalidAuthenticationToken significa que la autorización se revocó o que el client secret caducó; pega un secreto nuevo si hace falta y vuelve a hacer clic en Authorize with Provider. 403 significa que falta Tasks.ReadWrite o que no se dio el consentimiento, que no eres miembro del grupo del plan, que se alcanzó un límite del plan (por ejemplo, demasiadas tareas o depósitos) o que la cuenta es una cuenta personal de Microsoft. 404 significa que el id es incorrecto o que el elemento se eliminó. 409 o 412 significa que el elemento cambió mientras tanto: la IA lo vuelve a leer y lo intenta de nuevo. 400 significa que un valor tiene un formato incorrecto, por ejemplo un depósito de otro plan o una fecha sin zona horaria. 429 significa que Microsoft Graph está limitando la cuenta: espera un momento y vuelve a intentarlo.

El conector no crea ni elimina planes, no lee los comentarios de las tareas (están en las conversaciones del grupo), no sube archivos adjuntos, no abre los planes premium de Planner y no busca personas en el directorio.

Requisitos previos: MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Instalar el conector localmente

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

Abre http://localhost:3000/connectors/store, elige Microsoft Planner e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué tareas de Planner tengo asignadas y cuáles están atrasadas?"
• "Muéstrame el plan del equipo de Marketing: ¿cuántas tareas hay en cada depósito y cuáles siguen abiertas?"
• "Crea la tarea Preparar el stand de la feria en el depósito En curso del plan Eventos, asígnamela, prioridad Importante, vencimiento el 31 de octubre."
• "Añade a esa tarea una lista de comprobación con Pedir folletos, Contratar la limpieza del stand e Imprimir acreditaciones, y ponla en curso."

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT