Miro

Servidor MCP de Miro, que expone todas las funcionalidades disponibles en el SDK oficial de Miro.

Documentación

Servidor MCP Miro

Trust Score smithery badge

Servidor del Model Context Protocol (MCP) que se integra con la plataforma Miro. Permite que asistentes de IA (como Claude) accedan a los tableros de Miro y gestionen su contenido a través de una interfaz estandarizada.


Requisitos

  • Node.js v16 o más reciente instalado
  • Cuenta de Miro con token de API

Generar token de acceso de Miro

  1. Ve al Portal de desarrolladores de Miro
  2. Crea una nueva aplicación o usa una existente
  3. Asegúrate de crear el token con los permisos seleccionados a continuación
  4. Genera el token OAuth seleccionando Install app and get OAuth token
PermisoRequerido
boards:read✅
boards:write✅
identity:read✅
identity:write✅
team:read✅
team:write✅
microphone:listen❌
screen:record❌
webcam:record❌
auditlogs:read❌
sessions:delete❌

Conexión con Claude Desktop

  1. Instala Claude Desktop

  2. Abre o crea el archivo de configuración:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. Actualízalo para incluir este servidor:

{
   "mcpServers":{
      "miro":{
         "command":"npx",
         "args":[
            "-y",
            "@k-jarzyna/mcp-miro"
         ],
         "env":{
            "MIRO_ACCESS_TOKEN":"your_miro_access_token"
         }
      }
   }
}
  1. Reinicia Claude Desktop

Herramientas y recursos disponibles

Herramientas

Función del SDK de MiroHerramienta MCPDisponible
Listar tableroslist-boards✅
Crear tablerocreate-board✅
Actualizar tableroupdate-board✅
Eliminar tablerodelete-board✅
Copiar tablerocopy-board✅
Obtener tablero específicoget-specific-board✅
Obtener elementos del tableroget-items-on-board✅
Obtener elemento específicoget-specific-item✅
Actualizar posición del elementoupdate-item-position✅
Eliminar elementodelete-item✅
Crear elemento de tarjeta de aplicacióncreate-app-card-item✅
Obtener elemento de tarjeta de aplicaciónget-app-card-item✅
Actualizar elemento de tarjeta de aplicaciónupdate-app-card-item✅
Eliminar elemento de tarjeta de aplicacióndelete-app-card-item✅
Crear elemento de tarjetacreate-card-item✅
Obtener elemento de tarjetaget-card-item✅
Actualizar elemento de tarjetaupdate-card-item✅
Eliminar elemento de tarjetadelete-card-item✅
Crear conectorcreate-connector✅
Obtener conectoresget-connectors✅
Obtener conector específicoget-specific-connector✅
Actualizar conectorupdate-connector✅
Eliminar conectordelete-connector✅
Crear elemento de nota adhesivacreate-sticky-note-item✅
Obtener elemento de nota adhesivaget-sticky-note-item✅
Actualizar elemento de nota adhesivaupdate-sticky-note-item✅
Eliminar elemento de nota adhesivadelete-sticky-note-item✅
Crear marcocreate-frame✅
Obtener elemento de marcoget-frame-item✅
Actualizar elemento de marcoupdate-frame-item✅
Eliminar elemento de marcodelete-frame-item✅
Crear elemento de documentocreate-document-item✅
Obtener elemento de documentoget-document-item✅
Actualizar elemento de documentoupdate-document-item✅
Eliminar elemento de documentodelete-document-item✅
Crear elemento de textocreate-text-item✅
Obtener elemento de textoget-text-item✅
Actualizar elemento de textoupdate-text-item✅
Eliminar elemento de textodelete-text-item✅
Crear elementos en lotecreate-items-in-bulk✅
Crear elemento de imagen usando URLcreate-image-item-using-url✅
Crear elemento de imagen usando archivocreate-image-item-using-file✅
Obtener elemento de imagenget-image-item✅
Actualizar elemento de imagenupdate-image-item✅
Actualizar elemento de imagen usando archivoupdate-image-item-using-file✅
Eliminar elemento de imagendelete-image-item✅
Crear elemento de formacreate-shape-item✅
Obtener elemento de formaget-shape-item✅
Actualizar elemento de formaupdate-shape-item✅
Eliminar elemento de formadelete-shape-item✅
Crear elemento incrustadocreate-embed-item✅
Obtener elemento incrustadoget-embed-item✅
Actualizar elemento incrustadoupdate-embed-item✅
Eliminar elemento incrustadodelete-embed-item✅
Crear etiquetacreate-tag✅
Obtener etiquetaget-tag✅
Obtener todas las etiquetasget-all-tags✅
Actualizar etiquetaupdate-tag✅
Eliminar etiquetadelete-tag✅
Adjuntar etiquetaattach-tag✅
Desadjuntar etiquetadetach-tag✅
Obtener etiquetas del elementoget-item-tags✅
Obtener todos los miembros del tableroget-all-board-members✅
Obtener miembro específico del tableroget-specific-board-member✅
Eliminar miembro del tableroremove-board-member✅
Compartir tableroshare-board✅
Actualizar miembro del tableroupdate-board-member✅
Crear grupocreate-group✅
Obtener todos los gruposget-all-groups✅
Obtener grupoget-group✅
Obtener elementos del grupoget-group-items✅
Actualizar grupoupdate-group✅
Desagrupar elementosungroup-items✅
Eliminar grupodelete-group✅
Crear elementos en lote usando archivocreate-items-in-bulk-using-file✅
Crear nodo de mapa mentalcreate-mindmap-node✅
Obtener nodo de mapa mentalget-mindmap-node✅
Obtener nodos de mapa mentalget-mindmap-nodes✅
Eliminar nodo de mapa mentaldelete-mindmap-node✅
Agregar miembro del proyectoadd-project-member✅
Crear trabajo de exportación de tablerocreate-board-export-job✅
Obtener todos los casosget-all-cases✅
Obtener todas las retenciones legalesget-all-legal-holds✅
Obtener registros de auditoríaget-audit-logs✅
Obtener clasificación del tableroget-board-classification✅
Obtener registros de contenido del tableroget-board-content-logs✅
Obtener resultados del trabajo de exportación del tableroget-board-export-job-results✅
Obtener estado del trabajo de exportación del tableroget-board-export-job-status✅
Obtener casoget-case✅
Obtener retención legalget-legal-hold✅
Obtener elementos de contenido de retención legalget-legal-hold-content-items✅
Obtener información de la organizaciónget-organization-info✅
Obtener miembro de la organizaciónget-organization-member✅
Obtener miembros de la organizaciónget-organization-members✅
Obtener miembro del proyectoget-project-member✅
Eliminar miembro del proyectoremove-project-member✅
Actualizar clasificación del tableroupdate-board-classification✅

Desarrollo local

  1. Instala las dependencias:
npm install
  1. Crea un archivo .env basado en la plantilla:
cp .env.template .env
  1. Edita el archivo .env y agrega tu token de acceso de Miro

  2. Compila el servidor:

npm run build

Ejecutar el servidor

Para ejecutar el servidor:

node build/index.js

Licencia

Licencia Apache 2.0

Este proyecto está licenciado bajo la Licencia Apache, Versión 2.0. Consulta el archivo LICENSE para más detalles.