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-clientEén URL. Geen API-sleutel.
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.
- Open Customize → Connectors (opent in een nieuw tabblad) in Claude.
- Kies + → Add custom connector.
- Geef de koppeling de naam AHlert en plak de volledige server-URL uit het groene blok. Laat eventuele OAuth-gegevens onder Advanced settings leeg.
- Klik op Add.
- Open een gesprek. Kies linksonder + → Connectors en zet AHlert aan voor dat gesprek.
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.
- 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.
- Kies Apps → Create. Toont jouw interface Plugins (opent in een nieuw tabblad)? Gebruik daar de plusknop om een developer-mode-app toe te voegen.
- Vul AHlert als naam in en plak de volledige server-URL. Kies No Authentication.
- Laat ChatGPT de tools ophalen. Als je Scan Tools ziet, voer die scan uit en rond af met Create.
- 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.
- Zorg dat Gemini CLI is geïnstalleerd en dat je de CLI al kunt gebruiken.
- Voer onderstaande opdracht uit. Die voegt AHlert toe voor je gebruiker, ook buiten dit project.
gemini mcp add --scope user --transport http ahlert https://mcp.ahlert.nl/mcpHoud --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.
- Controleer de configuratie in je terminal met
gemini mcp list. - Start Gemini CLI opnieuw, of voer in een bestaande CLI-sessie
/mcp reloaduit. - Gebruik binnen de CLI
/mcp listom 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.
{
"mcpServers": {
"ahlert": {
"httpUrl": "https://mcp.ahlert.nl/mcp"
}
}
}VS Code / GitHub Copilot
Gebruik AHlert als MCP-server vanuit je editor.
- Open je project in VS Code. Maak
.vscode\mcp.jsonaan of voeg AHlert toe aan het bestaandeservers-object. - Gebruik de configuratie hieronder, zonder authenticatieheaders of API-sleutel.
{
"servers": {
"ahlert": {
"type": "http",
"url": "https://mcp.ahlert.nl/mcp"
}
}
}- Open het Command Palette en kies MCP: List Servers. Selecteer AHlert en start de verbinding als dat wordt gevraagd.
- 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.
- TypingMind: MCP instellen (opent in een nieuw tabblad)
De persoonlijke versie gebruikt TypingMind Cloud of een eigen connector. Toegang tot een AI-model staat los van de gratis AHlert-koppeling.
- LM Studio: MCP-servers gebruiken (opent in een nieuw tabblad)
Voor lokale modellen die tools kunnen gebruiken. Ook met een lokaal model hebben AHlert-zoekopdrachten internet nodig.
- Cherry Studio: MCP en externe tools (Chinees) (opent in een nieuw tabblad)
Een toegevoegde MCP-server moet ook aan je assistent of agent gekoppeld zijn.
- Msty Studio: Toolbox instellen (opent in een nieuw tabblad)
Deze uitleg is voor Msty Studio, niet voor Msty 1.x. De webversie heeft voor Toolbox een verbinding met Desktop of Sidecar nodig.
- LibreChat: MCP-servers toevoegen (opent in een nieuw tabblad)
Voor een eigen of beheerde LibreChat-installatie. Gebruik een model dat tools ondersteunt.
- Open WebUI: MCP-verbindingen instellen (opent in een nieuw tabblad)
Voor zelfgehoste installaties. Alleen een beheerder kan een MCP-server toevoegen.
- Manus: custom MCP-servers verbinden (opent in een nieuw tabblad)
Manus documenteert custom HTTPS-connectors. De combinatie met AHlert zonder authenticatie en de beschikbaarheid per account zijn nog niet geverifieerd.
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.
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.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.