OneNote MCP mit Microsoft Copilot verbinden

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

Microsoft OneNote + Microsoft Copilot

Lass deine KI in OneNote arbeiten: Notizbücher, Abschnitte und Seiten durchblättern, Seiten lesen, Notizbücher, Abschnitte und Seiten anlegen und Notizen zu bestehenden Seiten hinzufügen. OneNote für Arbeit oder Schule und privates OneNote über Microsoft Graph, angemeldet mit deinem Microsoft-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:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Schritt 1 — Zugangsdaten holen

1. Öffne das Microsoft Entra Admin Center (entra.microsoft.com) oder das Azure-Portal und gehe zu Applications → App registrations → New registration.

2. Gib der App einen Namen (zum Beispiel „AnythingMCP Microsoft 365“) und wähle die Supported account types. Davon hängt ab, was in MICROSOFT_TENANT_ID gehört:

   • Accounts in this organizational directory only (Single-Tenant): Nur Benutzer deiner Organisation können sich anmelden. Trage die Directory (tenant) ID von der Overview-Seite der App ein (eine GUID) oder deine Domain, etwa contoso.onmicrosoft.com.
   • Accounts in any organizational directory (Multi-Tenant): trage organizations ein.
   • Accounts in any organizational directory and personal Microsoft accounts: trage common ein (Geschäfts-, Schul- und private Konten) oder consumers (nur private Konten).

   Passt der Wert nicht zum Kontotyp, lehnt Microsoft die Anmeldung ab (AADSTS50194 oder AADSTS50020).

3. Wähle unter Redirect URI die Plattform Web und trage https://cloud.anythingmcp.com/api/mcp-oauth/callback ein. Wenn du AnythingMCP selbst betreibst, trage stattdessen https://dein-anythingmcp-host/api/mcp-oauth/callback ein. Die URI muss Zeichen für Zeichen übereinstimmen, sonst antwortet Microsoft mit AADSTS50011.

4. Öffne API permissions → Add a permission → Microsoft Graph → Delegated permissions und füge offline_access, User.Read und Notes.ReadWrite hinzu. offline_access sorgt dafür, dass Microsoft einen Refresh-Token ausstellt; ohne diese Berechtigung hört der Connector eine Stunde nach der Autorisierung auf zu arbeiten.

5. Öffne Certificates & secrets → New client secret. Kopiere den Value des Secrets, nicht die Secret ID; er wird nur einmal angezeigt. Notiere dir das Ablaufdatum: Wenn das Secret abläuft, funktioniert der Connector nicht mehr, bis du ein neues erstellst und einträgst.

6. Trage die Application (client) ID von der Overview-Seite in MICROSOFT_CLIENT_ID ein, den Secret-Wert in MICROSOFT_CLIENT_SECRET und den Tenant-Wert aus Schritt 2 in MICROSOFT_TENANT_ID, dann installiere den Connector.

7. Klicke auf der Connector-Seite auf Authorize with Provider und melde dich mit dem Konto an, mit dessen Notizbüchern die KI arbeiten soll. Der Refresh-Token wird verschlüsselt gespeichert, Access-Tokens (etwa eine Stunde gültig) werden automatisch erneuert.

8. Beginne mit microsoft_onenote_list_notebooks: Das Tool listet die Notizbücher, die der Connector öffnen kann, und deine Rolle in jedem davon (Besitzer, Mitwirkender oder Leser).

Eine Entra-App für alle Microsoft-Connectors: Die App-Registrierung, die du für den Outlook-, OneDrive-, SharePoint- oder Excel-Connector angelegt hast, funktioniert auch hier. Öffne sie, füge unter API permissions die Berechtigung aus Schritt 4 hinzu, behalte dieselbe Redirect URI und verwende dieselbe Client-ID, dasselbe Secret und denselben Tenant. Jeder Connector fragt bei der Autorisierung nur nach seinen eigenen Berechtigungen:

• Outlook: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite
• OneDrive: Files.ReadWrite
• Excel: Files.ReadWrite (plus Files.ReadWrite.All für Arbeitsmappen in SharePoint oder solche, die mit dir geteilt wurden)
• SharePoint: Sites.ReadWrite.All und Files.ReadWrite.All
• OneNote: Notes.ReadWrite
• Microsoft To Do: Tasks.ReadWrite
• Planner: Tasks.ReadWrite

Alle brauchen außerdem offline_access und User.Read.

Administratorzustimmung: Diese delegierten Berechtigungen brauchen normalerweise keinen Administrator, aber viele Organisationen schalten die Benutzerzustimmung ab. Zeigt die Anmeldung „Need admin approval“ (AADSTS65001 oder AADSTS90094), öffnet ein Tenant-Administrator einmal die App-Registrierung und klickt auf API permissions → Grant admin consent für die Organisation. Danach kann jeder Benutzer autorisieren. Jeder Connector arbeitet trotzdem nur mit dem, was das angemeldete Konto sehen darf.

Mit dir geteilte Notizbücher: Notes.ReadWrite deckt deine eigenen Notizbücher ab. Um in Notizbüchern zu arbeiten, die Kollegen mit dir geteilt haben (Geschäfts- oder Schulkonten), füge der App-Registrierung Notes.ReadWrite.All hinzu, ersetze damit in den OAuth-Einstellungen des Connectors Notes.ReadWrite und autorisiere erneut.

Nur lesen: Ersetze in den OAuth-Einstellungen des Connectors die Scopes durch offline_access User.Read Notes.Read, autorisiere erneut und deaktiviere microsoft_onenote_create_notebook, microsoft_onenote_create_section, microsoft_onenote_create_page, microsoft_onenote_append_to_page und microsoft_onenote_update_page.

Änderungen erst nach deinem Ja: Bevor die KI ein Notizbuch, einen Abschnitt oder eine Seite anlegt oder eine Seite ändert, sagt sie dir, was sie wohin schreiben will, und wartet auf dein Ja.

Bei der Installation ausgeschaltet: microsoft_onenote_delete_page. Der Connector kann ein Löschen nicht rückgängig machen; schalte das Tool also nur ein, wenn die KI wirklich Seiten löschen soll.

Seiten finden und lesen: Ein Notizbuch enthält Abschnitte, die optional in Abschnittsgruppen liegen, und jeder Abschnitt enthält Seiten. Die KI kann Seitentitel durchsuchen und nach dem Datum der letzten Änderung filtern, aber Microsoft Graph durchsucht nicht den Text innerhalb der Seiten; die KI öffnet deshalb die passenden Seiten und liest sie. Bilder auf einer Seite öffnen sich nur mit deiner Anmeldung, Freihandzeichnungen sind nicht enthalten, und sehr lange Seiten werden bei etwa 200 KB abgeschnitten. Hast du sehr viele OneNote-Elemente, kann die Seitenliste über alle Notizbücher mit Fehler 10008 scheitern; die KI geht dann Abschnitt für Abschnitt vor.

Seiten schreiben: Neue Seiten unterstützen einfache Formatierung: Überschriften, Listen, Tabellen, Links, Aufgaben-Kontrollkästchen und Bilder von einer öffentlichen Webadresse. Mit microsoft_onenote_append_to_page fügst du am einfachsten Notizen am Ende einer Seite hinzu. Eine neue Seite braucht ein paar Sekunden, bevor OneNote Änderungen daran annimmt: Antwortet das Ergänzen direkt nach dem Anlegen mit 404, wartet die KI kurz und versucht es erneut.

Häufige Fehler: 401 InvalidAuthenticationToken heißt, dass die Autorisierung widerrufen wurde oder das Client Secret abgelaufen ist; trage bei Bedarf ein neues Secret ein und klicke erneut auf Authorize with Provider. 403 (Code 40004 oder 40002) heißt, dass Notes.ReadWrite fehlt oder nicht zugestimmt wurde oder dass das Notizbuch nur zum Lesen mit dir geteilt ist. 404 (oder Code 20102 bzw. 20112) heißt, dass die ID falsch ist oder das Element gelöscht wurde. 20117 heißt, dass dort schon ein Notizbuch oder Abschnitt mit diesem Namen existiert; 20115, 20153 oder 20155 heißen, dass der Name ein unzulässiges Zeichen enthält oder zu lang ist (128 Zeichen für Notizbücher, 50 für Abschnitte). 30105 oder 30108 heißen, dass dein OneDrive for Business noch nicht eingerichtet ist: Öffne OneDrive einmal oder bitte deinen Admin, deine Lizenz zu prüfen. 429 heißt, dass Microsoft Graph das Konto drosselt: Warte einen Moment und versuche es noch einmal.

Der Connector lädt keine Bilder oder Dateien in Seiten hoch, verarbeitet keine Freihandzeichnungen, kopiert keine Seiten oder Abschnitte und öffnet keine Notizbücher von Microsoft-365-Gruppen oder SharePoint-Websites.

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 Microsoft OneNote-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

• „Welche OneNote-Notizbücher habe ich, und welche Abschnitte hat mein Notizbuch Arbeit?“
• „Finde meine Seiten aus dem letzten Monat mit Budget im Titel und fasse zusammen, was darin steht.“
• „Leg im Abschnitt Besprechungen eine Seite Kickoff Acme mit diesen Notizen an, mit einem Aufgaben-Kontrollkästchen für jeden To-do-Punkt.“
• „Ergänze auf der Seite Lieferantengespräch: am Freitag bei Anna wegen des Liefertermins nachhaken.“

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