Werkt een server niet zoals je verwacht, zoek dan hieronder de melding of het symptoom. De codes en meldingen staan ook bij Foutcodes.
Verbinden
De tool meldt auth vereist
De server antwoordt met 401 en auth vereist. Mogelijke oorzaken:
- De header ontbreekt, of begint niet met
Beareren een spatie. - De sleutel is ingetrokken of klopt niet, bijvoorbeeld omdat er nog
<jouw sleutel>staat. - De sleutel hoort bij een andere server. Een sleutel voor Kennisbank werkt niet op Klanten.
Controleer de header in je configuratie en kijk bij Bureau > MCP en API voor welke server de sleutel is. Is hij kwijt of ingetrokken, maak dan een nieuwe.
Melding kent geen klant-scope
De server antwoordt met 403 en kent geen klant-scope; gebruik een bureau-token. Je gebruikt een sleutel met een selectie klanten op Websites of Kennisbank. Die servers kennen geen selectie. Bij Bureau > MCP en API krijgt een sleutel voor die servers nooit een selectie; heb je de sleutel van LeadForge gekregen, vraag dan om een sleutel zonder selectie.
Server niet geconfigureerd
De server antwoordt met 503 en bijvoorbeeld kb-mcp niet geconfigureerd. De server is aan de kant van LeadForge nog niet klaar voor gebruik. Neem contact op met LeadForge.
Not Found
Je krijgt 404 met Not Found. Het adres klopt niet. De servers staan alleen op https://api.leadforge.nl, met daarachter /client-mcp, /cro-mcp of /kb-mcp.
Methode niet toegestaan
Je krijgt 405. De server werkt alleen met POST en stuurt geen stream. Kies in je AI-tool het transport HTTP, zoals in de configuratie uit de app.
Tijdens het werken
Te veel aanroepen
De server antwoordt met 429 en te veel aanroepen: hooguit 120 per minuut per sleutel, met het aantal seconden dat je moet wachten. Wacht die seconden en probeer het opnieuw. Gebeurt het vaak, geef dan elke persoon of tool een eigen sleutel: elke sleutel heeft zijn eigen limiet.
De schrijftools ontbreken
klant_voorstel en klant_voorstel_intrekken staan niet in de lijst, of je krijgt Deze sleutel mag alleen lezen. De sleutel heeft geen schrijfrecht. Laat de bureaubeheerder Schrijven aan zetten bij de sleutel. Zie Schrijven aan of uit.
Een tool van een kanaal ontbreekt
Je sleutel heeft een selectie klanten en de agent van dat kanaal staat bij die klant niet aan. De tool ontbreekt dan in de lijst, of je krijgt:
De agent 'google_ads' staat niet aan voor dit account, dus deze gegevens zijn hier niet in te zien.
Zet de agent aan bij de klant als die erbij hoort. Welke tool welke agent vraagt, staat bij Welke tools je ziet.
Onbekende klant
Je krijgt Onbekende klant. Vraag eerst klant_lijst op. of, bij Websites, Onbekende klant. Vraag eerst cro_klanten op. De naam klopt niet, de klant is gearchiveerd of hij valt buiten het bereik van je sleutel. Vraag de AI-tool eerst de lijst op te halen met klant_lijst of cro_klanten, en gebruik de naam of het id daaruit.
De daglimiet voor voorstellen is bereikt
Voor deze klant is vandaag de daglimiet voor voorstellen via de MCP bereikt, standaard 10. De tool noemt de limiet en hoeveel er vandaag al zijn. Ga de volgende dag verder; de dag begint om middernacht UTC. Zie Daglimiet.