Miro MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Miro klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Miro + Microsoft Copilot

Lass deine KI auf deinen Miro-Boards arbeiten: Boards finden, lesen, was darauf steht, Haftnotizen, Formen, Texte, Karten und Frames hinzufügen und bearbeiten, sie mit Linien verbinden, mit Tags ordnen und sehen, wer Zugriff hat. Angemeldet mit deinem Miro-Konto.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

MIRO_CLIENT_ID, MIRO_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

1. Klicke in Miro auf deinen Avatar → Settings → Your apps (oder öffne miro.com/app/settings/user-profile/apps) und dann auf + Create new app. Wenn du noch kein Developer-Team hast, fordert Miro dich zuerst auf, eines anzulegen; das ist kostenlos.
2. Gib der App einen Namen (zum Beispiel „AnythingMCP“), wähle das Developer-Team, setze den Haken bei Expire user authorization token und klicke auf Create app. Diese Wahl lässt sich später nicht mehr ändern. Ohne den Haken läuft der Token nie ab, was auch funktioniert, aber weniger sicher ist.
3. Füge auf der App-Seite unter Redirect URI for OAuth2.0 die Adresse https://cloud.anythingmcp.com/api/mcp-oauth/callback hinzu und klicke auf Add. Wenn du AnythingMCP selbst betreibst, trage stattdessen https://dein-anythingmcp-host/api/mcp-oauth/callback ein. Die URI muss Zeichen für Zeichen übereinstimmen.
4. Setze unter Permissions die Haken bei boards:read und boards:write.
5. Kopiere Client ID und Client secret aus App Credentials in MIRO_CLIENT_ID und MIRO_CLIENT_SECRET. Die Client ID ist eine lange Zahl.
6. Installiere den Connector, klicke auf der Connector-Seite auf Authorize with Provider, wähle das Miro-Team, mit dessen Boards die KI arbeiten soll, und klicke auf Install & authorize.
7. Beginne mit miro_get_token_info, um Benutzer, Team und erteilte Berechtigungen zu prüfen, und lass die KI dann mit miro_list_boards ein Board suchen.

Angemeldet bleiben: Die KI sieht und ändert die Boards, die der autorisierende Miro-Benutzer öffnen kann, und zwar in dem Team, das bei der Autorisierung gewählt wurde. Für die Boards eines anderen Teams autorisierst du erneut und wählst dieses Team. Access-Tokens gelten eine Stunde und werden automatisch erneuert. Der Refresh-Token gilt 60 Tage und verlängert sich bei jeder Nutzung; ein Connector, der zwei Monate lang nicht genutzt wurde, braucht also erneut Authorize with Provider.

Berechtigungen und Nur lesen: Setze nur den Haken bei boards:read, autorisiere erneut und schalte alle Tools aus, die etwas anlegen, ändern oder löschen: miro_create_board, miro_update_board, miro_copy_board, miro_create_sticky_note, miro_update_sticky_note, miro_create_shape, miro_update_shape, miro_create_text, miro_update_text, miro_create_card, miro_update_card, miro_create_frame, miro_update_frame, miro_move_item, miro_delete_item, miro_create_connector, miro_update_connector, miro_delete_connector, miro_create_tag, miro_update_tag, miro_delete_tag, miro_attach_tag und miro_remove_tag_from_item.

Bei der Installation ausgeschaltet: miro_delete_board, das ein ganzes Board mit allem darauf löscht, miro_share_board, über das Miro den genannten Personen eine Einladung per E-Mail schickt, sowie miro_update_board_member und miro_remove_board_member, die den Zugriff einer Person ändern oder entziehen. Schalte sie nur ein, wenn die KI Boards löschen oder Zugriffe verwalten soll.

Löschen ist endgültig: miro_delete_item entfernt ein Element dauerhaft, über die API gibt es kein Rückgängig, und wird ein Frame gelöscht, bleibt sein Inhalt auf dem Board. miro_delete_tag entfernt das Tag von allen Elementen, die es tragen. Die KI fragt nach, bevor sie etwas löscht, das sie nicht gerade selbst angelegt hat.

Tags und Tarife: Nur Karten und Haftnotizen können Tags tragen, höchstens 8 pro Element, und Änderungen an Tags erscheinen auf einem geöffneten Board erst nach dem Neuladen. Die Miro-API ist kostenlos nutzbar, aber kostenlose Teams dürfen nur 3 bearbeitbare Boards haben, daher können miro_create_board und miro_copy_board dort fehlschlagen. Boards in einem Developer-Team tragen ein Wasserzeichen.

Häufige Fehler: 401 (tokenNotProvided) heißt, dass die Autorisierung abgelaufen ist oder widerrufen wurde: Klicke erneut auf Authorize with Provider; wurde die App gelöscht oder ihr Secret neu erzeugt, aktualisiere vorher MIRO_CLIENT_SECRET. 403 heißt, dass eine Berechtigung fehlt (boards:write für Änderungen) oder kein Zugriff auf dieses Board besteht: Setze den Haken in den App-Einstellungen und autorisiere erneut. 404 heißt, dass eine Board- oder Element-ID falsch ist. 400 (invalidParameters) nennt das fehlerhafte Feld. 409 heißt, dass sich das Element im selben Moment geändert hat: Neu lesen und noch einmal versuchen. 429 heißt, dass Miro diesen Benutzer drosselt: Warte eine Minute. Das Anlegen eines Frames scheitert manchmal einige Minuten lang mit 500 „Internal error occurred“; dieselbe Anfrage klappt nach kurzer Wartezeit wieder.

Der Connector unterstützt keine Bilder, Dokumente und Embeds (er listet sie nur auf), keine App-Karten, Kommentare, Mindmaps und Exporte und keine Team- oder Organisationsverwaltung.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Miro-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Finde unser Board „Q3-Retrospektive“ und fasse die Haftnotizen in jedem Frame zusammen.“
• „Wer hat Zugriff auf das Board „Checkout-Redesign“, und welche Rolle hat jede Person?“
• „Leg auf dem Board „Produkt-Roadmap“ einen Frame „Nächster Sprint“ mit drei gelben Haftnotizen an: Login-Fix, Suchfilter und Onboarding-Mails.“
• „Zeig mir alle Karten mit dem Tag „Blockiert“ auf dem Board „Sprintplanung“, mit Zuständigen und Fälligkeitsdatum.“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden