stackgate.ai
Alle integrationer

Algolia

Læs Algolia-søgeindekser, søg i records, browse objekter, og gennemgå top-søgninger via MCP.

Manual setup 6 værktøjer

Eksempelspørgsmål

Prøv at spørge din AI-klient

  • What are people searching for most on the docs index this week?

  • Did the query MCP gateway start returning the right page?

  • Which searches have zero results that I should fix?

  • Write a short search-quality brief for Amalie - do not change the index.

  • Find records that mention private gateway in the help index.

Oversigt

Forbind Algolia, så AI-klienter kan liste søgeindekser, søge i records, browse objekter og gennemgå top-søgninger via Algolia Search API.

Integrationen er read-first: ingen ændringer af indstillinger eller records.

Forudsætninger

  • En Algolia-konto med mindst ét indeks
  • En API-nøgle med læse/søge-ACL (search-only nøgle anbefales)
  • Dit Algolia Application ID
  • En stackgate.ai-konto

Sådan får du credentials

  1. Log ind på Algolia dashboard.
  2. Gå til Settings → API Keys.
  3. Kopiér dit Application ID.
  4. Opret eller kopiér en Search-Only API Key (eller en custom nøgle begrænset til search, browse, settings og analytics).
  5. I stackgate.ai: Mine integrationer → Algolia.
  6. Indsæt Application ID og API-nøgle, og gem.
  7. Begræns eventuelt allowed indices for at begrænse hvilke indeksnavne værktøjer må bruge.

Se Algolias guide til API-nøgler.

Nøgletyper og sikkerhed

Nøgletype Anbefalet brug Noter
Search-Only Produktion / AI-læseadgang Kan ikke ændre indekser eller records
Admin Undgå til AI-klienter Fuld skriveadgang
Custom ACL Finmasket kontrol Begræns til specifikke indekser og ACL'er

Indekserede records kan indeholde persondata. Brug least-privilege nøgler.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/algolia med Sanctum bearer token
  • Private gateway: brug algolia__* namespaced tools

Eksempel-prompter:

  • "List mine Algolia-indekser."
  • "Søg i products-indekset efter løbesko under 500 kr."
  • "Vis top-søgninger på products-indekset de sidste 7 dage."

Fejlfinding

  • 422 integration not configured — udfyld Application ID og API-nøgle under Mine integrationer.
  • 401/403 fra Algolia — generér ny API-nøgle og tjek ACL for det pågældende indeks.
  • Index not allowed — opdater allowed indices eller fjern begrænsningen.
  • 429 Too many requests — Algolia har rate limits; vent og prøv igen.
  • Analytics-værktøj fejler — get_top_searches kræver analytics ACL på nøglen.

Tilbagekald adgang

  1. Afbryd Algolia under Mine integrationer på stackgate.ai.
  2. Slet eller rotér API-nøglen i Algolia dashboard.

Tilgængelige værktøjer

  • list_indices

    List Algolia-indekser med antal entries og seneste build-tid.

  • get_index_settings

    Hent indstillinger for et Algolia-indeks.

  • search_records

    Søg i records i et Algolia-indeks med query og valgfrie filtre.

  • get_object

    Hent en enkelt Algolia-record efter object ID.

  • browse_index

    Browse alle records i et Algolia-indeks med cursor-paginering.

  • get_top_searches

    Hent top-søgninger for et indeks fra Algolia Analytics API.

MCP-endpoint: https://stackgate.ai/mcp/algolia (HTTP) eller via private gateway.

Opret konto Dokumentation