Miro MCP Server (Admin-Anleitung)

Verfügbar für: Unternehmens-Admins und Team-Admins auf Enterprise-Preisplänen

Als Unternehmens-Admin für ein Enterprise-Abo legst du fest, ob der Miro MCP Server in deiner Organisation verfügbar ist. Diese Einstellung bestimmt, ob deine Teams KI-Integrationen nutzen können, die eine Verbindung zu Miro herstellen.

Verwende Miro MCP (Model Context Protocol), um deine Miro-Boards mit MCP‑kompatiblen KI-Tools zu verbinden. Wenn es aktiviert und autorisiert ist, können KI-Agenten Kontext von bestimmten Boards lesen und — sofern erlaubt — Aktionen ausführen, z. B. Inhalte zusammenfassen oder Diagramme erstellen, über eine kuratierte Auswahl an Miro MCP-Tools. Diese Anleitung erklärt Voraussetzungen, Aktivierung, Governance und Fehlerbehebung.

Bevor du beginnst

• Aktiviere MCP für deine Organisation und verwende dann Access control, um zu entscheiden, wer es nutzen darf.
• Du kannst den Zugriff für alle offenlassen oder ihn auf ausgewählte Teams und optional auf Nutzergruppen beschränken. Board‑berechtigungen gelten weiterhin.

MCP Server aktivieren oder deaktivieren

So aktivierst du den MCP Server:

1. Gehe zu Admin-Einstellungen > Apps und Integrationen > MCP.
2. Unter Enable MCP schalte Allow users in your organization to connect Miro to MCP-compatible clients ein.

Änderungen treten sofort in Kraft.

Um die Nutzung vorübergehend zu unterbrechen, schalte denselben Schalter aus (unterbricht neue Tool-Aufrufe).

Wenn du die MCP-Einstellungen nicht siehst, kontaktiere deinen Account-Manager.

Zugriff mit Teams und Nutzergruppen steuern

Unter Access control > Teams and user groups wähle aus, wer Miro MCP nutzen kann, nachdem du es aktiviert hast.

Einstellung	Wer MCP verwenden kann
Everyone (Standard)	Alle Nutzer, die Mitglieder aktivierter Teams sind
Bestimmte Teams und Nutzergruppen	Nur Nutzer, die sowohl in den ausgewählten Teams als auch in den ausgewählten Nutzergruppen sind

Zugriff auf bestimmte Teams und Nutzergruppen beschränken

1. In der Admin-Konsole gehe zu Apps und Integrationen > MCP.
2. Unter Access control öffne das Dropdown Teams and user groups und wähle dann Bestimmte Teams und Nutzergruppen.
   Das Panel MCP-Zugriff hinzufügen öffnet sich.
3. Teams auswählen:
   1. Wähle Alle Teams in deiner Organisation oder Bestimmte Teams.
   2. Wenn du Bestimmte Teams wählst, öffne den Team-Selector, suche und wähle Teams aus, klicke auf Teams hinzufügen und kehre dann zum Panel zurück.
   3. Klicke auf Weiter.
4. Nach Nutzergruppen filtern:
   1. Wähle Alle Nutzer in ausgewählten Teams oder Nur Nutzer, die auch in bestimmten Nutzergruppen sind.
   2. Wenn du bestimmte Nutzergruppen wählst, öffne den Nutzergruppen-Selector, suche und wähle Gruppen aus, klicke auf Nutzergruppen hinzufügen und kehre dann zum Panel zurück.
   3. Klicke auf Weiter.
5. Überprüfen und bestätigen der Zusammenfassung (z. B. Nutzer in 6 Teams, die auch in 1 Nutzergruppe sind, erhalten Zugriff auf Miro MCP). Du kannst auf Bearbeiten klicken, um Teams oder Nutzergruppen zu ändern.
6. Klicke auf Zugriff hinzufügen.

Wie der Zugriff über Teams und Nutzergruppen funktioniert

Wenn du Bestimmte Teams und Nutzergruppen verwendest, kann ein Nutzer Miro MCP nur autorisieren, wenn er beide von dir konfigurierten Bedingungen erfüllt:

1. Er gehört zu einem ausgewählten Team (oder zu einem beliebigen Team, wenn du Alle Teams gewählt hast).
2. Wenn du Nutzergruppen ausgewählt hast, gehört er außerdem zu mindestens einer dieser Nutzergruppen.

Wenn du Alle Nutzer in ausgewählten Teams wählst, gilt nur die Team-Anforderung.

Die Mitgliedschaft in einer Nutzergruppe allein reicht nicht aus. Der Nutzer muss außerdem in einem ausgewählten Team sein.

Wenn du mehr als eine Nutzergruppe auswählst, muss ein Nutzer eine von ihnen entsprechen (nicht alle).

Beispiele

• Everyone: Jeder Nutzer in einem aktivierten Team kann MCP autorisieren.
• Bestimmte Teams (z. B. A und B), alle Nutzer in ausgewählten Teams: Nutzer in Team A oder Team B können MCP autorisieren. Nutzer, die nur in Team C sind, nicht.
• Bestimmte Teams (Team A) und bestimmte Nutzergruppen (Nutzergruppe 1): Nur Nutzer, die sowohl in Team A als auch in Nutzergruppe 1 sind, können MCP autorisieren. Wenn Team A z. B. 100 Mitglieder hat und Nutzergruppe 1 20 davon enthält, können nur diese 20 MCP nutzen.
• Alle Teams und bestimmte Nutzergruppen: Nutzer in jedem Team, die außerdem in einer ausgewählten Nutzergruppe sind, können MCP autorisieren.
• Zurück zu Everyone wechseln: Der Zugriff ist nicht länger auf die im Panel ausgewählten Teams und Nutzergruppen beschränkt.

Wie Zugriff und Berechtigungen funktionieren

Wenn du MCP aktivierst, erlaubst du:

• Externen KI-Agenten, Board-Inhalte zu lesen, wenn Nutzer die Autorisierung erteilen.
• KI-Tools, Inhalte auf Miro-Boards zu erstellen oder zu ändern.
• Sicheren Datenaustausch zwischen Miro und Drittanbieter-Anwendungen.

Wichtige Sicherheitsaspekte:

• Der Zugriff wird über OAuth 2.1 authentifiziert oder über Enterprise-managed authorization (EMA) für Claude, wenn du diese aktivierst. Siehe Enterprise-managed authorization für Miro MCP einrichten.
• Nutzer können nur Zugriff auf Boards gewähren, die sie ansehen dürfen.
• Die Enterprise-Sicherheits-Compliance bleibt erhalten.
• Standardmäßige API-Rate-Limits gelten für alle Vorgänge.
• Nutzer in deiner Organisation können sich am MCP Server authentifizieren, sodass externe oder Drittanbieter-KI-Agenten im Namen der Nutzer Inhalte auf einem Board lesen und erstellen können.
• Wenn du MCP mit Teams und Nutzergruppen einschränkst, können Nutzer außerhalb dieser Auswahl MCP nicht über OAuth autorisieren. EMA verwendet stattdessen das von dir konfigurierte Standardteam und die vertrauenswürdigen Aussteller.

MCP in deiner Organisation verwalten

Als Admin solltest du Folgendes in Betracht ziehen:

1. Kommunikation: Informiere deine Teams über die Verfügbarkeit von Miro MCP und mögliche Einsatzbereiche.
2. Schulung: Biete Anleitungen dazu, wie MCP mit verschiedenen KI-Tools effektiv genutzt wird.
3. Governance: Erstelle Richtlinien für den angemessenen Umgang mit KI-generierten Inhalten.
4. Monitoring: Überprüfe regelmäßig die MCP-Nutzung und passe die Einstellungen bei Bedarf an.

Weitere Informationen zur Verwaltung von Apps in deiner Miro-Umgebung findest du in der Dokumentation zur App-Verwaltung.

Rollout-Empfehlungen

• Starte klein: Unter Access control wähle Bestimmte Teams und Nutzergruppen, wähle ein oder zwei Pilot-Teams und belasse die Nutzergruppen auf Alle Nutzer in ausgewählten Teams.
• Für einen engeren Pilot wähle zusätzlich Nur Nutzer, die auch in bestimmten Nutzergruppen sind, sodass nur diese Gruppe MCP autorisieren kann.
• Stelle Prompt-Hygiene sicher: Fordere Nutzer auf, in jedem MCP-Prompt eine vollständige Board-URL anzugeben.

Enterprise-managed authorization für Claude einrichten

Enterprise-managed authorization (EMA) erlaubt deinem Identitätsanbieter, Miro MCP-Zugriff für Claude zu gewähren, sodass sich Personen nicht separat über Miro OAuth anmelden müssen. Andere MCP-Clients verwenden weiterhin OAuth.

Auf der MCP-Seite wählst du unter Enterprise-Managed Authorization ein Standardteam aus, fügst vertrauenswürdige Aussteller von deinem Identitätsanbieter hinzu (Okta in der ersten Version) und schließt die Einrichtung in der Anthropic-Admin-Konsole ab.

Mehr Informationen: Siehe Enterprise-managed authorization für Miro MCP einrichten.

Steuern, welche MCP-Clients eine Verbindung zu Miro herstellen können

Als Unternehmens-Admin kannst du allen Clients den Zugriff aus deiner Organisation erlauben oder eine Zulassungsliste für Clients verwalten, einschließlich eigener benutzerdefinierter MCP-Clients.

Gehe wie folgt vor:

1. In der Admin-Konsole gehe zu Apps und Integrationen > MCP. Wenn du MCP noch nicht aktiviert hast, siehe MCP Server aktivieren oder deaktivieren.
2. Unter Access control ist Alle Clients die Standardeinstellung. Um dies zu ändern, klicke auf Alle Clients und dann auf Bestimmte Clients.
   Das Panel Bestimmte MCP-Clients öffnet sich.
3. Schalte die Clients ein, die du zulassen möchtest. Um einen benutzerdefinierten MCP-Client zuzulassen, gib den Namen deines Clients in die Suchleiste (oben) ein und klicke auf Hinzufügen. Weitere Informationen findest du in der Miro MCP-Entwicklerdokumentation.
4. Klicke auf Speichern.
   Das Panel schließt sich und deine ausgewählten Clients werden in einer Reihe unter Access Control angezeigt.

Um einen Client zu sperren, kehre zu Apps und Integrationen > MCP > Alle Clients (unter Access Control) zurück und schalte den Client aus.

Wenn du einen benutzerdefinierten MCP-Client hinzufügst und später sperrst, wird der Client aus der Liste entfernt. Um ihn wieder zuzulassen, musst du den Client erneut hinzufügen. Siehe Schritt 3 in Steuern, welche MCP-Clients eine Verbindung zu Miro herstellen können.

Fehlerbehebung

• „Ich sehe die Miro MCP-Tools in meinem Client nicht"
  • Bestätige, dass MCP für die Organisation aktiviert ist.
  • Unter Access control > Teams and user groups bestätige, dass der Nutzer eingeschlossen ist (in einem ausgewählten Team und, falls konfiguriert, in einer ausgewählten Nutzergruppe).
  • Führe den OAuth‑Flow erneut aus und wähle ein Team, das MCP-Zugriff hat.
  • Für Claude mit Enterprise-managed authorization bestätige, dass EMA aktiviert ist, der Nutzer im Standard-EMA-Team ist, der vertrauenswürdige Aussteller Discovery resolved und Keys reachable anzeigt und EMA für den Miro-Connector in der Anthropic-Admin-Konsole eingeschaltet ist.
  • Überprüfe, ob der Client MCP unterstützt und zu den Clients gehört, die wir ansteuern/dokumentieren.
• „Zugriff verweigert beim Prompten"
  • Stelle sicher, dass der Prompt eine vollständige Board-URL enthält; Agenten entdecken Boards nicht automatisch.
  • Bestätige, dass der Nutzer bereits Zugriff auf dieses Board in Miro hat.
  • Wenn der Nutzer zuvor Zugriff hatte und es nicht mehr funktioniert, prüfe, ob die Zugriffssteuerung unter Teams and user groups geändert wurde oder ob er aus einem ausgewählten Team oder einer Nutzergruppe entfernt wurde.
• „Wir müssen die Nutzung jetzt pausieren"
  • Schalte MCP aus unter Admin-Einstellungen > Apps und Integrationen > MCP.
• „Der Client eines Nutzers ist blockiert / liefert einen Zugriffsfehler"
  • Bestätige, dass der Client unter Access control aktiviert ist, oder füge ihn als benutzerdefinierten Client hinzu.