Algolia über MCP mit Cursor 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 + Cursor

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 Cursor 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.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Algolia-Tools aufrufen.

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

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden