Algolia MCP mit Microsoft Copilot verbinden

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

Algolia + Microsoft Copilot

Lass deine KI deine Algolia-Indizes durchsuchen und prüfen: Indizes auflisten, Datensätze suchen und durchblättern, Einstellungen, Synonyme und Rules lesen, Top-Suchen und Suchen ohne Ergebnis ansehen und nach deiner Bestätigung Datensätze hinzufügen oder aktualisieren.

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:

ALGOLIA_APP_ID, ALGOLIA_API_KEY, ALGOLIA_ANALYTICS_REGION

Schritt 1 — Zugangsdaten holen

1. Öffne im Algolia-Dashboard Settings → API Keys (https://dashboard.algolia.com/account/api-keys) und kopiere die Application ID in ALGOLIA_APP_ID.
2. Erstelle unter All API keys → New API key einen eigenen Key, statt den Admin-Key wiederzuverwenden. Gib ihm eine Beschreibung wie AnythingMCP, beschränke ihn bei Bedarf auf einzelne Indizes und gib ihm die ACL search, browse, listIndexes, settings und analytics. Füge ihn in ALGOLIA_API_KEY ein.
3. Setze ALGOLIA_ANALYTICS_REGION auf us oder de, die Analytics-Region, die das Dashboard unter Settings → Infrastructure → Analytics anzeigt. Die meisten Anwendungen nutzen us.
4. Installiere den Connector. Die Verbindungsprüfung listet deine Indizes auf, so wie algolia_list_indices.

Warum nicht der Search-Only-Key: Die Verbindungsprüfung braucht die ACL listIndexes. Der Standard-Search-Only-API-Key von Algolia hat nur search und scheitert deshalb an der Prüfung mit 403 „Method not allowed with this API key“, obwohl die Suche selbst damit funktionieren würde. Erstelle stattdessen den eigenen Lese-Key aus Schritt 2. Nimm auch nicht den Admin-API-Key: Er kann Indizes löschen und Keys verwalten, und kein Tool hier braucht das. ACL, Index-Beschränkungen und Rate Limit jedes Keys stehen unter Settings → API Keys → All API keys.

Was die KI kann: einen Index so durchsuchen, wie es deine Website tut, mit Tippfehlertoleranz, Filtern wie brand:Apple AND price < 500, Facettenzählungen und Seiten (standardmäßig 10 Treffer, höchstens 100); mit algolia_browse Datensätze in großen Mengen lesen; und einzelne Datensätze, Index-Einstellungen, Synonyme und Rules lesen, um zu erklären, warum Ergebnisse so gerankt werden. Suchen der KI fließen nicht in deine Analytics ein.

Suchanalysen: algolia_top_searches, algolia_no_result_searches (wonach Leute suchen und nichts finden), algolia_top_hits und algolia_search_count. Standardzeitraum sind die letzten 8 Tage. Analytics hinken bis zu einige Stunden hinterher, und ein Index braucht Traffic, bevor es überhaupt Daten gibt.

Schreiben fragt vorher: algolia_save_object fügt einen Datensatz hinzu oder ersetzt ihn vollständig, und algolia_partial_update_object ändert einzelne seiner Attribute. Vor jedem Aufruf zeigt dir die KI Index, objectID und Inhalt und wartet auf dein Ja. Beide brauchen zusätzlich die ACL addObject, so bleibt ein Lese-Key wirklich nur zum Lesen. Algolia übernimmt Änderungen im Hintergrund; einen Moment später sind sie durchsuchbar.

Bei der Installation deaktiviert: algolia_delete_object, das einen Datensatz endgültig löscht. Ein Administrator schaltet es bewusst ein, und es braucht die ACL deleteObject.

Häufige Fehler: 403 „Invalid Application-ID or API key“: Die Application ID oder der Key ist falsch, oder der Key wurde gelöscht. 401 „Invalid credentials“ bedeutet dasselbe bei der Analytics API; prüfe auch die Analytics-Region. 403 „Method not allowed with this API key“: Dem Key fehlt eine ACL. „Index not allowed with this API key“: Der Key ist auf andere Indizes beschränkt. 404: Index oder Datensatz existiert nicht; bei Indexnamen zählt die Groß- und Kleinschreibung. 429: Der Key hat sein Rate Limit erreicht.

Der Connector legt keine Indizes an, kopiert oder löscht keine, ändert weder Einstellungen noch Synonyme oder Rules, verwaltet keine API-Keys und deckt Insights-Events, Recommend, Query Suggestions und den Crawler nicht ab.

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 Algolia-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 Algolia-Indizes haben wir, und wie viele Datensätze enthält jeder?“
• „Wonach haben Leute in den letzten 30 Tagen im Index products am häufigsten gesucht, und welche Suchen hatten kein Ergebnis?“
• „Durchsuche den Index products nach Laufschuhen mit dem Filter brand:Nike und zeig mir die Top 10 mit Preis.“
• „Warum rankt Datensatz 4711 bei ‚Sneaker‘ so weit hinten? Prüf die Index-Einstellungen, Synonyme und Rules.“
• „Ändere den Preis von Datensatz 4711 im Index products auf 89,90. Zeig mir die Änderung vorher.“

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