Miro MCP-Server (Admin-Leitfaden)

Wer kann das tun: Unternehmens- und Team-Admins bei Enterprise‑Preisplänen

Als Unternehmens-Admin eines Enterprise-Abos entscheidest du, ob der Miro MCP Server für deine 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 aktiviert und autorisiert, können KI‑Agenten Kontext von bestimmten Boards lesen und, wo erlaubt, Aktionen ausführen, etwa Inhalte zusammenfassen oder Diagramme erstellen, über einen kuratierten Satz von Miro MCP‑Tools. Dieses Handbuch erläutert Voraussetzungen, Aktivierung, Governance und Fehlerbehebung.

Bevor du beginnst

• Aktiviere MCP für deine Organisation und verwende Zugriffskontrolle, um festzulegen, wer es nutzen darf.
• Du kannst den Zugriff für alle offenhalten oder ihn auf ausgewählte Teams und optional Nutzergruppen beschränken. Board‑Berechtigungen gelten weiterhin.

MCP Server aktivieren oder deaktivieren

Um den MCP Server zu aktivieren:

1. Gehe zu Admin-Einstellungen > Apps und Integrationen > MCP.
2. Unter MCP aktivieren schalte Erlaube Nutzern in deiner Organisation, Miro mit MCP-kompatiblen Clients zu verbinden ein.

Änderungen treten sofort in Kraft.

Um die Nutzung vorübergehend zu stoppen, schalte denselben Schalter aus (verhindert neue Tool‑Aufrufe).

MCP kann Miro AI für die Erstellung von Formaten oder für inhaltsbezogene Aktionen verwenden. Diese Aktionen verbrauchen die Miro KI-Credits deiner Organisation.

Wenn du die MCP-Einstellungen nicht siehst, wende dich an deinen Account Manager.

Zugriff mit Teams und Nutzergruppen steuern

Unter Zugriffskontrolle > Teams und Nutzergruppen legst du fest, wer Miro MCP nutzen kann, nachdem du es aktiviert hast.

Zugriff auf bestimmte Teams und Nutzergruppen beschränken

1. Gehe in der Admin-Konsole zu Apps und Integrationen > MCP.
2. Unter Zugriffskontrolle, öffne das Dropdown Teams und Nutzergruppen und wähle dann Bestimmte Teams und Nutzergruppen.
   Das MCP-Zugriff hinzufügen-Feld öffnet sich.
3. Teams auswählen:
   1. Wähle Alle Teams in deiner Organisation oder Bestimmte Teams.
   2. Wenn du Bestimmte Teams auswählst, öffne die Team-Auswahl, suche und wähle Teams aus, klicke auf Teams hinzufügen und kehre dann zum Feld 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 auswählst, öffne den Nutzergruppen-Selektor, suche und wähle Gruppen aus, klicke auf Nutzergruppen hinzufügen und kehre dann zum Feld zurück.
   3. Klicke auf Weiter.
5. Überprüfe und bestätige die Zusammenfassung (z. B. haben Nutzer in 6 Teams, die auch in 1 Nutzergruppe sind, 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 auswählst, kann ein Nutzer Miro MCP nur autorisieren, wenn er beide von dir festgelegten Bedingungen erfüllt:

1. Der Nutzer gehört zu einem ausgewählten Team (oder zu jedem Team, wenn du Alle Teams ausgewählt hast).
2. Wenn du Benutzergruppen ausgewählt hast, gehört der Nutzer außerdem zu mindestens einer dieser Benutzergruppen.

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

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

Wenn du mehr als eine Benutzergruppe auswählst, muss ein Nutzer einer dieser Gruppen angehören (nicht allen).

Beispiele

• Alle Nutzer: 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, können das nicht.
• Bestimmte Teams (Team A) und bestimmte Nutzergruppen (User Group 1): Nur Nutzer, die sowohl in Team A und in User Group 1 sind, können MCP autorisieren. Zum Beispiel: Wenn Team A 100 Mitglieder hat und die Nutzergruppe User Group 1 20 davon umfasst, können nur diese 20 MCP verwenden.
• Alle Teams und bestimmte Nutzergruppen: Nutzer in beliebigen Teams, die außerdem Mitglied einer ausgewählten Nutzergruppe sind, können MCP autorisieren.
• Zurück zu „Alle“: Der Zugriff ist nicht mehr auf die Teams und Nutzergruppen beschränkt, die du im Feld ausgewählt hast.

Wie Zugriff und Berechtigungen funktionieren

Wenn du MCP aktivierst, erlaubst du:

• Externe KI-Agenten dürfen Board-Inhalte lesen, wenn Nutzer sie autorisieren.
• KI-Tools dürfen Inhalte auf Miro-Boards erstellen oder ändern.
• Sicheren Datenaustausch zwischen Miro und Drittanbieter-Apps ermöglichen.

Wichtige Sicherheitsaspekte:

• Alle Zugriffe werden über OAuth 2.1 authentifiziert.
• Nutzer können nur Zugriff auf Boards gewähren, die sie ansehen dürfen.
• Unternehmenssicherheit und Compliance werden gewährleistet.
• Für alle Vorgänge gelten die standardmäßigen API-Rate-Limits.
• Nutzer in deiner Organisation können sich beim MCP Server authentifizieren, sodass externe oder Drittanbieter-KI-Agenten im Auftrag der Nutzer Inhalte auf einem Board lesen und erstellen können.
• Wenn du MCP auf bestimmte Teams und Nutzergruppen beschränkst, können Nutzer außerhalb dieser Auswahl MCP nicht autorisieren.

MCP in deiner Organisation verwalten

Als Admin solltest du Folgendes beachten:

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

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

Rollout-Empfehlungen

• Klein anfangen: Unter Zugriffskontrolle, wähle Bestimmte Teams und Nutzergruppen, wähle ein oder zwei Pilot-Teams und lasse die Nutzergruppen auf Alle Nutzer in ausgewählten Teams.
• Für einen engeren Pilot wähle außerdem Nur Nutzer, die zusätzlich in bestimmten Nutzergruppen sind, damit nur diese Gruppe MCP autorisieren kann.
• Achte auf gute Prompt-Hygiene: Fordere Nutzer auf, in jedem MCP-Prompt die vollständige Board-URL anzugeben.

Steuere, welche MCP-Clients sich mit Miro verbinden können

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

Gehe dazu wie folgt vor:

1. Gehe in der Admin-Konsole zu Apps und Integrationen > MCP. Wenn du MCP noch nicht aktiviert hast, siehe MCP-Server aktivieren oder deaktivieren.
2. Unter Zugriffskontrolle ist Alle Clients die Standardeinstellung. Um sie zu ändern, klicke auf Alle Clients, dann auf Bestimmte Clients.
   Das Feld 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 dann auf Hinzufügen. Für weitere Informationen siehe Miro MCP-Entwicklerdokumentation.
4. Klicke auf Speichern.
   Das Feld schließt sich, und deine angegebenen Clients werden in einer Reihe unter Zugriffskontrolle angezeigt.

Um einen Client zu deaktivieren, rufe in der Admin-Konsole Apps und Integrationen > MCP > Alle Clients (unter Zugriffskontrolle) auf und schalte den Client aus.

Wenn du einen benutzerdefinierten MCP-Client hinzufügst und ihn später wieder deaktivierst, wird der Client aus der Liste entfernt. Um ihn erneut zuzulassen, musst du den Client wieder hinzufügen. Siehe Schritt 3 in Steuere, welche MCP-Clients sich mit Miro in deiner Organisation verbinden können.

Fehlerbehebung

• “Ich sehe die Miro MCP‑Tools in meinem Client nicht”
  • Stelle sicher, dass MCP für die Organisation aktiviert ist.
  • Unter Zugriffskontrolle > Teams und Nutzergruppen bestätige, dass der Nutzer enthalten ist (in einem ausgewählten Team und in einer ausgewählten Nutzergruppe, falls du eine konfiguriert hast).
  • Führe den OAuth‑Flow erneut aus und wähle ein Team, das Zugriff auf MCP hat.
  • Vergewissere dich, dass der Client MCP unterstützt und zu den Clients gehört, die wir unterstützen oder in unserer Dokumentation aufführen.
• “Zugriff verweigert beim Prompt”
  • Stelle sicher, dass der Prompt eine vollständige Board‑URL enthält; KI‑Agenten entdecken Boards nicht automatisch.
  • Stelle sicher, 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 sich die Zugriffskontrolle unter Teams und Nutzergruppen geändert hat oder ob er aus einem ausgewählten Team oder einer ausgewählten Nutzergruppe entfernt wurde.
• “Wir müssen die Nutzung jetzt pausieren”
  • Schalte MCP in Admin-Einstellungen > Apps und Integrationen > MCP aus.
• "Der Client eines Nutzers ist blockiert / gibt einen Zugriffsfehler zurück"
  • Stelle sicher, dass der Client unter Zugriffskontrolle aktiviert ist, oder füge ihn als benutzerdefinierten Client hinzu.