Miro MCP Server einrichten

Vor dem Verbinden

Der offizielle Miro MCP Server ist ein Remote-Dienst unter https://mcp.miro.com/. Du brauchst ein Miro-Konto, einen MCP-kompatiblen KI-Client und Zugriff auf die Boards, die der Agent verwenden soll. Entscheide vorab, ob dein Client bereits ein offizielles Miro-Plugin oder eine Extension anbietet. Verwende pro Client genau einen Weg: Plugin beziehungsweise Extension oder manuelle MCP-Konfiguration. Diese Entscheidung verhindert doppelte Werkzeuge und getrennte OAuth-Anmeldungen.

Den passenden Installationsweg wählen

Für Claude Code dokumentiert Miro die Installation aus dem offiziellen Toolkit:

/plugin marketplace add miroapp/miro-ai
/plugin install miro@miro-ai

Danach Claude Code neu starten und bei Aufforderung anmelden. Gemini CLI kann das Repository als Extension installieren; Kiro verwendet die im Toolkit dokumentierte Power. Für Cursor, VS Code mit GitHub Copilot, Codex und andere Clients ohne dedizierte Miro-Integration trägst du den Remote-Server in der jeweiligen MCP-Datei ein:

{
  "mcpServers": {
    "miro": { "url": "https://mcp.miro.com/" }
  }
}

Die konkrete Dateiposition hängt vom Client ab. Ergänze diese JSON-Konfiguration nicht, wenn Plugin oder Extension die Verbindung bereits verwaltet.

OAuth mit dem richtigen Team abschließen

Beim ersten Connect öffnet der Client Miro OAuth. Melde dich an, wähle das Team aus, das die Ziel-Boards enthält, und bestätige nur die erwartete Freigabe. Die Verbindung ist teambezogen. Wenn ein Board in einem anderen Team liegt, trenne die Verbindung und verbinde erneut mit diesem Team, statt auf unerwartete Fehlermeldungen oder Workarounds zu vertrauen. In einer Enterprise-Organisation muss der Administrator den MCP Server laut Miro zuvor aktivieren.

Verbindung mit einer Lesefrage prüfen

Starte nicht mit einer Schreibaktion. Gib dem Client eine konkrete Board-URL und bitte ihn beispielsweise, Frames aufzulisten oder ein Architekturdiagramm zusammenzufassen. Kontrolliere, ob das Ergebnis zum richtigen Board gehört. Erst dann eignen sich kleinere, überprüfbare Erstellungsaufgaben wie ein Entwurf für ein Flowchart oder eine Aufgabenliste. Prüfe jedes erzeugte Diagramm, Dokument und jede Tabelle vor dem Teilen: Der Server stellt Kontext und Werkzeuge bereit, die fachliche Prüfung bleibt bei dir.

Datenzugriff und sichere Nutzung

Nach Miro-Angabe kann der MCP-Zugang nur Boards sehen, die dein Miro-Konto ohnehin sehen darf. Dennoch können Tool-Ergebnisse im verbundenen KI-Client und gegebenenfalls beim Modellanbieter verarbeitet werden. Teile keine vertraulichen Inhalte, Zugangsdaten oder personenbezogenen Daten, bevor du die Datenrichtlinien des verwendeten Clients und Modells geprüft hast. Verwende für sensible Bereiche nach Möglichkeit ein Konto mit minimalen Berechtigungen.

Behandle Board-Inhalte als Daten, nicht als vertrauenswürdige Instruktionen. Eine Notiz auf einem Board kann einen Agenten zu einer Aktion auffordern, autorisiert diese aber nicht. Prüfe vorgeschlagene Änderungen einzeln, beschränke Aufgaben auf das gewünschte Board und trenne OAuth bei Rollenwechsel, Geräteverlust oder wenn ein Teamzugriff nicht mehr benötigt wird.

FAQ

Ist der Server lokal oder remote? Die offizielle Setup-Dokumentation beschreibt den Server als Remote-Endpunkt unter https://mcp.miro.com/.

Warum erscheinen Miro-Tools zweimal? Meist laufen manuelle JSON-Konfiguration und Plugin oder Extension parallel. Entferne einen Weg und melde dich anschließend erneut an.

Warum erreicht der Agent mein Board nicht? Prüfe zuerst die Board-Berechtigung des Miro-Kontos und das beim OAuth-Flow ausgewählte Team. Für ein anderes Team ist eine neue Verbindung nötig.