Miro

Die Miro-Integration liest und bearbeitet Boards in genau einem ausgewählten Miro-Team. Der Service muss Ihrem Mandanten zugewiesen und für Sie freigegeben sein. Zusätzlich gelten immer die Rechte des verwendeten Miro-Tokens und optionale Tool-Einschränkungen im MCP.

Voraussetzungen

Ein Miro-OAuth-Access-Token für das gewünschte Team.
boards:read für lesende Funktionen und boards:write für Erstellen, Bearbeiten, Löschen oder Teilen.
Das Token-Konto besitzt in Miro Zugriff auf die benötigten Boards und Aktionen.
Miro ist im MCP für Ihren Mandanten und Benutzer freigegeben.

Ein Mandanten-Admin legt fest, ob jeder Benutzer eine persönliche Verbindung hinterlegt oder ob ein mandantenweit zentraler Miro-Zugang verwendet wird. Bei einem zentralen Zugang sehen Benutzer das Token nicht.

Persönliche Verbindung einrichten

Öffnen Sie Persönlicher Zugang > Meine Verbindungen.
Öffnen Sie Miro und tragen Sie das OAuth-Access-Token ein.
Wählen Sie Team laden. Das Portal ermittelt das zum Token gehörende Team.
Prüfen Sie Teamname und Auswahl und speichern Sie die Verbindung.
Testen Sie zuerst miro_status. Rufen Sie danach miro_list_boards auf.

Bei einem mandantenweit zentralen Zugang hinterlegt ein Mandanten-Admin Token und Team unter MCP-Services. Benutzer benötigen weiterhin eine Service- und Toolfreigabe.

Team- und Berechtigungsgrenze

miro_status zeigt das Token-Team, das ausgewählte Team, die Scopes und das Download-Limit.
miro_list_boards listet nur Boards des ausgewählten Teams.
Vor jedem Zugriff auf ein einzelnes Board prüft der Service erneut dessen Teamzugehörigkeit.
Ein Board aus einem anderen Team wird abgelehnt, selbst wenn das Token es grundsätzlich sehen könnte.
Miro-Rollen, Board-Freigaben und MCP-Toolrechte können den Zugriff weiter einschränken.

Funktionen und Sicherheitsgrenzen

Boards und Inhalte

miro_get_board, miro_list_items und miro_get_item lesen Boards und Inhalte.
miro_create_board erstellt standardmäßig ein privates Board im ausgewählten Team.
miro_create_item unterstützt App Cards, Cards, Connectors, Dokumente, Embeds, Frames, Bilder, Shapes, Sticky Notes und Text.
miro_update_board und miro_update_item ändern vorhandene Inhalte.
miro_delete_board und miro_delete_item löschen erst mit confirm=true.

Dateien

miro_list_files findet Bilder, Dokumente und Embeds auf einem Board.
miro_download_file lädt zugängliche Bilder oder Dokumente als MCP-Ressource; das Standardlimit beträgt 15 MB pro Datei.
miro_upload_file und miro_replace_file akzeptieren eine HTTP(S)-Quelle oder Base64-Datei bis 6 MB.

Teilen und Mitglieder

miro_list_board_members listet ausdrücklich eingeladene Mitglieder.
miro_invite_board_members lädt 1 bis 20 Personen ein und versendet Miro-Einladungen erst mit confirm=true.
miro_set_board_public_access ändert öffentliche Linkfreigaben. Jede nicht-private Freigabe verlangt confirm=true.
miro_remove_board_member entfernt ein Mitglied erst mit confirm=true.

Prüfen Sie Empfänger, Rolle und Freigabeart vor jeder bestätigten Aktion. Öffentliche Links können Daten außerhalb des bisherigen Teilnehmerkreises zugänglich machen.

Verbindung widerrufen

Bei einer persönlichen Verbindung öffnen Sie Meine Verbindungen und entfernen die Miro-Verbindung. Einen mandantenweit zentralen Zugang entfernt oder ersetzt der Mandanten-Admin unter MCP-Services. Widerrufen Sie ein nicht mehr benötigtes oder kompromittiertes Token zusätzlich in Miro.

Fehlerbehebung

Team kann nicht geladen werden: Prüfen Sie, ob das Access-Token vollständig und noch gültig ist.
HTTP 401: Token fehlt, ist ungültig oder abgelaufen. Ersetzen Sie die Verbindung.
HTTP 403: Dem Token fehlt boards:read oder boards:write, oder Ihre Miro-Rolle erlaubt die Aktion nicht.
Board oder Element nicht gefunden: Prüfen Sie Board-ID, Miro-Freigabe und das ausgewählte Team.
HTTP 429: Das Miro-Rate-Limit ist erreicht. Warten Sie und versuchen Sie es später erneut.
Tool fehlt: Prüfen Sie zusätzlich die Service- und Toolfreigabe im MCP.

Miro beschreibt die Autorisierung in der offiziellen OAuth-Anleitung und die Board-Berechtigungen in der REST-API-Referenz. Weitere MCP-Statuscodes: Fehlerbehebung.