Cómo conectar Miro a Cursor vía MCP

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

Miro + Cursor

Deja que tu IA trabaje en tus tableros de Miro: busca tableros, lee lo que contienen, añade y edita notas adhesivas, formas, textos, tarjetas y marcos, conéctalos con líneas, organízalos con etiquetas y consulta quién tiene acceso. Con el inicio de sesión de tu cuenta de Miro.

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:

MIRO_CLIENT_ID, MIRO_CLIENT_SECRET

Paso 1 — Obtener credenciales

1. En Miro, haz clic en tu avatar → Settings → Your apps (o abre miro.com/app/settings/user-profile/apps) y luego en + Create new app. Si todavía no tienes un developer team, Miro te pide que crees uno primero; es gratis.
2. Ponle nombre a la app (por ejemplo "AnythingMCP"), elige el developer team, marca Expire user authorization token y haz clic en Create app. Esta opción no se puede cambiar más adelante. Sin ella el token no caduca nunca, lo que también funciona pero es menos seguro.
3. En la página de la app, en Redirect URI for OAuth2.0, añade https://cloud.anythingmcp.com/api/mcp-oauth/callback y haz clic en Add. 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.
4. En Permissions, marca boards:read y boards:write.
5. Copia el Client ID y el Client secret de App Credentials en MIRO_CLIENT_ID y MIRO_CLIENT_SECRET. El Client ID es un número largo.
6. Instala el conector, haz clic en Authorize with Provider en la página del conector, elige el equipo de Miro con cuyos tableros debe trabajar la IA y haz clic en Install & authorize.
7. Empieza con miro_get_token_info para comprobar el usuario, el equipo y los permisos concedidos, y después deja que la IA busque un tablero con miro_list_boards.

Mantener la sesión iniciada: la IA ve y modifica los tableros que puede abrir el usuario de Miro que autorizó, en el equipo elegido durante la autorización. Para llegar a los tableros de otro equipo, vuelve a autorizar y elige ese equipo. Los access tokens duran una hora y se renuevan automáticamente. El refresh token dura 60 días y se renueva con cada uso, así que un conector que lleva dos meses sin usarse necesita de nuevo Authorize with Provider.

Permisos y solo lectura: marca solo boards:read, vuelve a autorizar y desactiva todas las herramientas que crean, modifican o eliminan: miro_create_board, miro_update_board, miro_copy_board, miro_create_sticky_note, miro_update_sticky_note, miro_create_shape, miro_update_shape, miro_create_text, miro_update_text, miro_create_card, miro_update_card, miro_create_frame, miro_update_frame, miro_move_item, miro_delete_item, miro_create_connector, miro_update_connector, miro_delete_connector, miro_create_tag, miro_update_tag, miro_delete_tag, miro_attach_tag y miro_remove_tag_from_item.

Desactivadas al instalar: miro_delete_board, que elimina un tablero entero con todo lo que contiene, miro_share_board, con la que Miro envía por correo una invitación a las personas indicadas, y miro_update_board_member y miro_remove_board_member, que cambian o retiran el acceso de una persona. Actívalas solo si la IA debe eliminar tableros o gestionar quién tiene acceso.

Eliminar es definitivo: miro_delete_item borra un elemento para siempre, sin deshacer a través de la API, y al eliminar un marco su contenido se queda en el tablero. miro_delete_tag quita la etiqueta de todos los elementos que la llevan. La IA pregunta antes de eliminar algo que no acaba de crear.

Etiquetas y planes: solo las tarjetas y las notas adhesivas pueden llevar etiquetas, como máximo 8 cada una, y los cambios de etiquetas aparecen en un tablero abierto después de recargarlo. La API de Miro es gratuita, pero los equipos gratuitos solo pueden tener 3 tableros editables, así que allí miro_create_board y miro_copy_board pueden fallar. Los tableros de un developer team llevan una marca de agua.

Errores frecuentes: 401 (tokenNotProvided) significa que la autorización caducó o se revocó: vuelve a hacer clic en Authorize with Provider y, si la app se eliminó o se regeneró su secret, actualiza antes MIRO_CLIENT_SECRET. 403 significa que falta un permiso (boards:write para los cambios) o que no hay acceso a ese tablero: marca el permiso en los ajustes de la app y vuelve a autorizar. 404 significa un ID de tablero o de elemento incorrecto. 400 (invalidParameters) indica el campo erróneo. 409 significa que el elemento cambió en ese mismo momento: vuelve a leerlo y reintenta. 429 significa que Miro está limitando a este usuario: espera un minuto. Crear un marco a veces falla durante unos minutos con 500 "Internal error occurred"; la misma solicitud vuelve a funcionar tras una breve espera.

El conector no gestiona imágenes, documentos ni contenidos incrustados (solo los lista), app cards, comentarios, mapas mentales, exportaciones ni la administración de equipos y organizaciones.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Miro.

Herramientas disponibles

Ejemplos de prompts

• "Busca nuestro tablero "Retrospectiva T3" y resume las notas adhesivas de cada marco."
• "¿Quién tiene acceso al tablero "Rediseño del checkout" y qué rol tiene cada persona?"
• "En el tablero "Hoja de ruta del producto", añade un marco llamado "Próximo sprint" con tres notas adhesivas amarillas: Arreglo del login, Filtros de búsqueda y Correos de bienvenida."
• "Muéstrame todas las tarjetas con la etiqueta "Bloqueado" del tablero "Planificación del sprint", con su responsable y su fecha de vencimiento."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

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