Miro MCP Server (Admin-Leitfaden)

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

Als Unternehmens-Admin mit einem Enterprise-Abo legst du fest, 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 (wenn erlaubt) Aktionen ausführen, z. B. Inhalte zusammenfassen oder Diagramme erstellen, mithilfe einer kuratierten Auswahl von Miro-MCP-Tools. Dieser Leitfaden erklärt Voraussetzungen, Aktivierung, Governance und Fehlerbehebung.

Bevor du beginnst

• Für die gesamte Organisation oder nur für ausgewählte Teams aktivieren (Board‑Berechtigungen gelten weiterhin).

MCP-Server aktivieren oder deaktivieren

So aktivierst du den MCP-Server:

1. Gehe zu Admin-Einstellungen > Apps & Integrationen > MCP.
2. Wähle den Geltungsbereich.
   1. Organisation: Jeder Nutzer in deiner Organisation kann MCP für Boards autorisieren, auf die er bereits Zugriff hat.
   2. Ausgewählte Teams: Nur Nutzer in diesen Teams können MCP autorisieren. Berechtigungen auf Board‑Ebene gelten weiterhin.
3. Schalte den Schalter ein. Änderungen treten sofort in Kraft.

Um die Nutzung vorübergehend zu stoppen, schalte Miro MCP an derselben Stelle aus (stoppt neue Tool-Aufrufe).

HINWEIS: Wenn du den MCP-Schalter nicht siehst, kontaktiere deinen Account Manager.

Wie Zugriff und Berechtigungen funktionieren

Wenn du MCP aktivierst, erlaubst du:

• externen KI-Agenten, Board-Inhalte zu lesen, sofern diese von Nutzern autorisiert wurden.
• KI-Tools, Inhalte auf Miro-Boards zu erstellen oder zu ändern.
• sicheren Datenaustausch zwischen Miro und Drittanbieter-Apps.

Wichtige Sicherheitsaspekte:

• Alle Zugriffe werden über OAuth 2.1 authentifiziert.
• Nutzer können nur Zugriff auf Boards gewähren, die sie ansehen dürfen.
• Enterprise-Sicherheits-Compliance wird eingehalten.
• 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 dieser Nutzer Inhalte auf einem Board lesen und erstellen können.

MCP in deiner Organisation verwalten

Als Admin solltest du Folgendes berücksichtigen:

1. Communication: Informiere deine Teams über die Verfügbarkeit von Miro MCP und Anwendungsbeispiele.
2. Training: Stelle Anleitungen bereit, damit deine Teams MCP mit verschiedenen KI-Tools effektiv nutzen können.
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: Aktiviere die Funktion für ein oder zwei Pilotteams (z. B. Engineering und Product) und prüfe den Nutzen sowie die Kontrollmöglichkeiten.
• Prompt-Hygiene verstärken: Fordere Nutzer auf, in jedem MCP-Prompt die vollständige Board-URL anzugeben.

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

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

Gehe dazu wie folgt vor:

1. Öffne in der Admin-Konsole Apps und Integrationen > MCP. Falls du MCP noch nicht aktiviert hast, siehe MCP aktivieren.
2. Unter Zugriffskontrolle ist Alle Clients die Standardeinstellung. Um sie zu ändern, klicke auf Alle Clients, dann klicke auf Bestimmte Clients.
   Das Feld Bestimmte MCP-Clients öffnet sich.
3. Aktiviere die Clients, die du zulassen möchtest. Um einen eigenen 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 unter Zugriffskontrolle in einer Reihe angezeigt.

TIPP: Um einen Client nicht mehr zuzulassen, geh zu Apps und Integrationen > MCP > Alle Clients (unter Zugriffskontrolle) und schalte den Client aus. 

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

Fehlerbehebung

• “Ich kann die Miro-MCP-Tools in meinem Client nicht sehen”
  • Bestätige, dass MCP für die Organisation oder das gewünschte Team aktiviert ist und dass der Nutzer zu diesem Team gehört.
  • Führe den OAuth-Flow erneut aus und wähle ein Team aus, bei dem MCP aktiviert ist.
  • Prüfe, ob der Client MCP unterstützt und zu den Clients gehört, die wir unterstützen und dokumentieren.
• “Zugriff verweigert beim Ausführen des Prompts”
  • 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.
• „Wir müssen die Nutzung jetzt pausieren“
  • MCP in Admin-Einstellungen > Integrationen & Apps > Miro MCP deaktivieren.
• „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.