Ga naar de hoofdinhoud

Handleiding / AI-koppeling

Neem AHlert mee in je AI-gesprek.

Laat Claude, ChatGPT of een andere ondersteunde assistent aanbiedingen en winkels opzoeken in AHlert. Via MCP haalt je assistent gegevens op, in plaats van prijzen te raden.

MCP staat voor Model Context Protocol: een standaard waarmee een AI-app tools kan gebruiken. Je kiest zelf welke koppeling je inschakelt.

Kies je AI-client
Alleen lezen. Geen bestellingen.

Eén URL. Geen API-sleutel.

Server-URL
https://mcp.ahlert.nl/mcp

Verbinding
Streamable HTTP
Authenticatie
Geen / None

Plak de volledige URL in de MCP-instellingen van je AI-app. Dit adres is geen gewone webpagina. Je hebt geen AHlert-account nodig.

Andere client? Bekijk de officiële handleidingen

De AHlert-koppeling is gratis. Je AI-dienst kan een account, passend abonnement of toestemming van een werkruimtebeheerder vereisen. De gewone Gemini-app is niet hetzelfde als Gemini CLI.

Claude

Gebruik een custom connector in Claude op het web of in Claude Desktop.

  1. Open Customize → Connectors (opent in een nieuw tabblad) in Claude.
  2. Kies + → Add custom connector.
  3. Geef de koppeling de naam AHlert en plak de volledige server-URL uit het groene blok. Laat eventuele OAuth-gegevens onder Advanced settings leeg.
  4. Klik op Add.
  5. Open een gesprek. Kies linksonder + → Connectors en zet AHlert aan voor dat gesprek.
Werk- of schoolaccount? In Team en Enterprise moet een eigenaar de connector mogelijk eerst toevoegen via Organization settings → Connectors. Leden kunnen hem daarna verbinden. Je abonnement kan het aantal custom connectors beperken.

Gebruik ook voor Desktop deze remote-connectorroute, niet een configuratie voor een lokale stdio-server. AHlert vraagt geen gebruikersnaam, wachtwoord of token.

ChatGPT

Voeg AHlert in de browser toe als custom app via developer mode.

Niet elk account toont deze opties. Beschikbaarheid hangt af van je abonnement en werkruimtebeleid. OpenAI documenteert verschillende menuvarianten; volg hieronder de route die jouw interface toont. Deze stappen zijn voor ChatGPT op het web.
  1. Open Settings en schakel Developer mode in. De optie staat, afhankelijk van de interface, onder Security and login of Apps → Advanced Settings. Lees de waarschuwing voordat je bevestigt.
  2. Kies Apps → Create. Toont jouw interface Plugins (opent in een nieuw tabblad)? Gebruik daar de plusknop om een developer-mode-app toe te voegen.
  3. Vul AHlert als naam in en plak de volledige server-URL. Kies No Authentication.
  4. Laat ChatGPT de tools ophalen. Als je Scan Tools ziet, voer die scan uit en rond af met Create.
  5. Kies in je gesprek + → Developer mode en selecteer AHlert, of gebruik de appkiezer die jouw interface toont. Selecteer of vermeld AHlert opnieuw bij een vervolgvraag waarvoor nieuwe gegevens nodig zijn.

Ontbreken Developer mode of Create? Vraag bij een werkaccount je beheerder om toegang en controleer de actuele OpenAI-hulp. Alleen een link naar AHlert in de chat plakken maakt nog geen MCP-koppeling.

Gemini: via de CLI

Deze route is voor Gemini CLI, het aparte terminalprogramma van Google.

Niet voor de gewone Gemini-website of mobiele app. Daar hebben we geen officieel gedocumenteerde mogelijkheid gevonden om zelf deze MCP-URL toe te voegen. Een Gem of een schakelaar bij Connected Apps is niet hetzelfde.
  1. Zorg dat Gemini CLI is geïnstalleerd en dat je de CLI al kunt gebruiken.
  2. Voer onderstaande opdracht uit. Die voegt AHlert toe voor je gebruiker, ook buiten dit project.
Gemini CLI-opdracht
gemini mcp add --scope user --transport http ahlert https://mcp.ahlert.nl/mcp

Houd --transport http aan: dat kiest Streamable HTTP. Wil je de koppeling alleen in het huidige project, gebruik dan --scope project in plaats van --scope user. Voeg geen --trust toe; laat toolbevestigingen beschikbaar.

  1. Controleer de configuratie in je terminal met gemini mcp list.
  2. Start Gemini CLI opnieuw, of voer in een bestaande CLI-sessie /mcp reload uit.
  3. Gebruik binnen de CLI /mcp list om te zien of AHlert verbonden is.
Liever handmatig je Gemini-instellingen aanpassen?

Voeg dit samen met je bestaande Gemini-instellingen; vervang niet het hele bestand. Voor deze verbinding heet de sleutel httpUrl. De sleutel url is daar voor het oudere SSE-transport.

Gemini-instellingen
{
  "mcpServers": {
    "ahlert": {
      "httpUrl": "https://mcp.ahlert.nl/mcp"
    }
  }
}

VS Code / GitHub Copilot

Gebruik AHlert als MCP-server vanuit je editor.

  1. Open je project in VS Code. Maak .vscode\mcp.json aan of voeg AHlert toe aan het bestaande servers-object.
  2. Gebruik de configuratie hieronder, zonder authenticatieheaders of API-sleutel.
VS Code-configuratie
{
  "servers": {
    "ahlert": {
      "type": "http",
      "url": "https://mcp.ahlert.nl/mcp"
    }
  }
}

  1. Open het Command Palette en kies MCP: List Servers. Selecteer AHlert en start de verbinding als dat wordt gevraagd.
  2. Controleer de server-URL voordat je een eventuele vertrouwensvraag bevestigt. Controleer in Copilot-chat via Configure Tools of de AHlert-tools ingeschakeld zijn.

Voor alle projecten: gebruik MCP: Open User Configuration in plaats van een projectbestand. Je organisatie kan MCP beperken. Bij verbindingsproblemen vind je details via MCP: List Servers → AHlert → Show Output.

Andere clients: officiële handleidingen

Gebruik je een van onderstaande programma's? Volg dan de instructies van de maker zelf. Zo hoef je hier geen mogelijk verouderde kopie van hun installatiehandleiding te volgen.

Kies een externe HTTP-server, gebruik de server-URL bovenaan en stel authenticatie in op geen. De client moet Streamable HTTP ondersteunen. Je hoeft geen lokale AHlert-server te starten en er is geen apart SSE-adres.

Deze links verwijzen naar documentatie, niet naar afzonderlijk met AHlert geteste koppelingen. Accountvoorwaarden en modeltoegang verschillen per programma. Authenticatievoorbeelden in hun handleiding gelden voor andere servers; AHlert zelf vereist geen API-sleutel of token.

Van koppeling naar vraag

Probeer het in je gesprek

Selecteer eerst AHlert in je client. Maak daarna duidelijk dat je gegevens uit AHlert wilt, niet alleen een algemeen antwoord van het taalmodel.

Voorbeeldvraag: zoeken op stad
Gebruik AHlert om koffiedeals in Utrecht te zoeken. Vergelijk de prijs per artikel en vermeld per winkel wanneer de voorraad voor het laatst is waargenomen.

Voorbeeldvraag: zoeken binnen een straal
Gebruik AHlert om aanbiedingen binnen 5 km van 52.0907, 5.1214 te vinden. Geef een korte selectie met winkel, afstand en laatst waargenomen voorraad. Beschrijf voorraad niet als gegarandeerd actueel.

Welke 7 tools krijgt mijn assistent?
search_deals
Aanbiedingen zoeken op product, winkel of locatie.
get_top_deals
Aanbiedingen vergelijken op besparing, korting of bereik.
search_products
Een productnaam opzoeken en het juiste product kiezen.
find_stores
Winkels vinden in een stad of binnen een zoekstraal.
get_store
Winkelgegevens en de laatst bekende verversingsstatus bekijken.
list_categories
Beschikbare productcategorieën opvragen.
get_data_status
Controleren hoe recent en volledig de waarnemingen zijn.

Als verbinden niet lukt

Ik zie “internal only” of “method not allowed” in mijn browser.

Het basisadres en de diagnostische paden zijn niet openbaar. Het /mcp-endpoint verwacht MCP-verzoeken, geen gewone browserpagina. Gebruik de volledige URL in een MCP-client; een browsermelding alleen bewijst niet dat de koppeling stuk is.

Mijn AI-app toont geen knop om een eigen server toe te voegen.

Controleer je account, abonnement en werkruimtebeleid in de officiële hulp van die client. De gewone Gemini-app heeft in de geraadpleegde documentatie geen invoer voor een eigen MCP-URL. Gebruik daarvoor Gemini CLI of een andere ondersteunde client.

De client vraagt om een API-sleutel of wachtwoord.

Kies geen authenticatie of No Authentication. AHlert verstrekt voor deze publieke koppeling geen API-sleutel. Vul geen wachtwoorden of tokens van andere diensten in.

AHlert is toegevoegd, maar mijn assistent gebruikt het niet.

Selecteer de connector of app ook in het gesprek en controleer of de tools aanstaan. Vraag expliciet om AHlert te gebruiken en vraag om de tijd van de waarneming. Een opgeslagen koppeling is niet automatisch bij elke vraag actief.

Ik krijg 429, 502 of 503.

Bij 429 is een gebruikslimiet bereikt: wacht de aangegeven Retry-After-tijd af en vermijd herhaalde bulkvragen. Gebruikers via dezelfde AI-aanbieder kunnen een limiet delen. Bij 502 of 503 kan AHlert tijdelijk onbereikbaar zijn; probeer later opnieuw.

Vragen over AHlert? Mail [email protected]. Deel geen wachtwoorden, tokens of volledige configuraties met geheimen.

Bronnen gecontroleerd op

Deze stappen zijn gebaseerd op officiële documentatie, niet op een test van elk abonnement of account. Menunamen, beschikbaarheid en beheerrechten kunnen veranderen. Je prompts en gedeelde zoekgegevens vallen ook onder het privacybeleid van je AI-aanbieder.