Problemen oplossen

Als een tool een fout geeft.

Je AI-assistent geeft de foutmelding door die hij kreeg, soms in eigen woorden. Zoek hem hieronder op, met de oplossing. Eerst de fouten die bij elke tool kunnen voorkomen, dan die van elke tool zelf.

Elke tool

Fouten van MCP Hosted zelf, welke tool je ook koppelt.

De server heeft een actief abonnement nodig
Elke tool heeft een eigen abonnement. Start het op de instellingenpagina van de tool, onder Connections, en vraag het opnieuw.
Er is geen account gekoppeld
Koppel je account op de instellingenpagina van de tool, onder Connections, en vraag het opnieuw.
De koppeling achter deze URL is ontkoppeld
De URL in je assistent hoort bij een koppeling die er niet meer is. Kopieer de URL van een andere koppeling op de instellingenpagina en zet die in je assistent. De URL zonder nummer aan het eind bereikt alleen de eerste koppeling die je maakte, en schuift nooit door naar een andere.
Je tool weigert de key
De key is ingetrokken of verlopen in de tool zelf, of heeft een recht verloren. Maak een nieuwe en vervang de oude op de instellingenpagina. De URL blijft hetzelfde.
Je assistent vraagt je opnieuw in te loggen
Zijn login is uitgezet onder Settings, AI clients, of verlopen. Log opnieuw in vanuit je assistent en geef toestemming. Je andere assistenten blijven werken.
Je assistent toont de tools niet
Controleer of de URL dezelfde is als op de instellingenpagina. Koppel de server daarna opnieuw in je assistent, of start je assistent opnieuw: de meeste laden de tools alleen bij het verbinden. Bij sommige kun je tools per chat uitzetten, dus kijk of ze aan staan.
Too Many Attempts (HTTP 429)
Elk account kan 60 verzoeken per minuut doen, voor al zijn tools en assistenten samen. Wacht een minuut en vraag het opnieuw, of vraag om minder dingen tegelijk.

WeFact

Fouten van WeFact zelf.

WeFact zegt dat er geen toegang is tot de API
WeFact antwoordt alleen adressen die op de whitelist staan. Zet ons IP-adres 46.101.201.38 op de whitelist, in WeFact onder Instellingen en dan API. Draai je de server op je eigen computer? Zet dan het publieke IP-adres van die computer erop.

Laravel Forge

Fouten van Laravel Forge zelf.

Forge zegt Invalid scope(s) provided
Je API token mist de scope die de tool nodig heeft, vaak met opzet, zodat je AI alleen kan meekijken. Forge kan geen scope toevoegen aan een bestaand token. Maak dus een nieuw token met die scope en vervang het oude op de instellingenpagina. Hieronder staat de scope van elke tool.

De scope die elke tool nodig heeft

list_organizations
organization:view
list_servers
server:view
get_server
server:view
list_sites
server:view
get_site
server:view
create_site
site:create
update_site
site:create
update_site_repository
site:manage-project
list_site_domains
site:meta
create_certificate
site:manage-ssl
set_environment_variables
server:viewsite:manage-environment
get_deployment_script
server:view
update_deployment_script
site:manage-deploys
deploy_site
site:manage-deploys
list_deployments
server:view
get_deployment
server:view
get_deployment_log
site:manage-deploys
reset_deployment_status
site:manage-deploys
run_site_command
site:manage-commands
get_command_output
server:view
create_database
server:create-databases
create_database_user
server:create-databases
create_background_process
server:create-daemons
update_background_process
server:create-daemons
enable_octane
server:create-daemons
enable_inertia_ssr
server:create-daemons
enable_scheduler
server:create-schedulers

Zenvoices

Fouten van Zenvoices zelf.

Zenvoices weigert de login
Controleer de organisatiecode, en het e-mailadres en wachtwoord van de API-gebruiker. Tweestapsverificatie en Wachtwoord wijzigen bij volgende login moeten uit staan voor die gebruiker, want de server logt zelf in.
Zenvoices zegt Required permissions are not granted
Open Rechten van de API-gebruiker in Zenvoices en vink API aan, of in elk geval Administraties, Boekingen, Relaties en Uploaden & inlezen daaronder.

Google Search Console

Fouten van Google Search Console zelf.

Google accepteert deze koppeling niet meer
De toegang is ingetrokken in je Google-account, of verlopen. Klik op Reconnect op de instellingenpagina en log opnieuw in met Google. De URL blijft hetzelfde.
De koppeling is read-only, dus je AI kan niets wijzigen
Klik op Reconnect op de instellingenpagina, kies Read and write en log opnieuw in met Google. De URL blijft hetzelfde.
Er ontbreekt een site
De instellingenpagina toont de sites die elke koppeling kan lezen. Log in met een Google-account dat toegang heeft tot de property in Search Console.

e-Boekhouden

Fouten van e-Boekhouden zelf.

e-Boekhouden zegt Login failed
Het token klopt niet of is verwijderd. Maak een nieuw token onder e-Boekhouden API, niet API/SOAP (oud), en vervang het oude op de instellingenpagina. Blijf het oude niet proberen: e-Boekhouden blokkeert een token na mislukte logins.
e-Boekhouden zegt Access token has expired (API_SESSION_004)
Het token is voorbij zijn einddatum. Maak een nieuw token, laat Einddatum leeg en vervang het oude op de instellingenpagina.

Rompslomp

Fouten van Rompslomp zelf.

Rompslomp weigert elke aanroep
Rompslomp opent zijn API alleen vanaf Puur Factuur of een hoger pakket, dus een administratie op het gratis pakket Gratis is niet te lezen. Rompslomp weigert ook als de eigenaar van het API token geen toegang meer heeft tot de administratie. Kies een hoger pakket, of maak het token met een account dat wel toegang heeft en vervang het oude op de instellingenpagina.
Rompslomp zegt dat het token een scope mist
Maak een nieuw API token in Rompslomp, onder Mijn account en dan Mijn API tokens, met alle scopes hieronder aangevinkt, en vervang het oude op de instellingenpagina.

De scope die elke tool nodig heeft

list_companies
public
list_contacts
manage:contacts
get_contact
manage:contacts
list_sales_invoices
manage:sales_invoices
get_sales_invoice
manage:sales_invoices
list_payments
manage:payments
list_quotations
manage:quotations
list_expenses
manage:expenses
list_accounts
read:accounts

Zelf draaien

Fouten van de server die je met npx op je eigen computer draait.

De tools verschijnen niet
De server is niet gestart. Voer het npx-commando van de instellingenpagina uit in een terminal, met dezelfde omgevingsvariabelen: dan zie je waarom, bijvoorbeeld een ontbrekende of geweigerde licentiecode.
Er is geen key ingesteld
Zet de omgevingsvariabelen die de instellingenpagina noemt in de env van de config van je MCP-client, en start de client opnieuw.
No license key found
Zet MCPHOSTED_LICENSE_KEY in de env van de config van je MCP-client, naast de key van je tool. Je licentiecode staat op de instellingenpagina van de tool.
This license covers builds made until (datum), and this one is newer
Een licentie dekt de builds van één jaar. Zet de versie die de melding noemt in plaats van mcphosted in de config van je MCP-client, of koop een nieuwe licentie op de instellingenpagina.

Kom je er niet uit?

Meld het, dan zoeken we het uit. Geeft een tool een fout, dan eindigt de melding die je assistent krijgt met een link naar het formulier, met de fout al ingevuld.

Meld een probleem