Problemen oplossen
Bepaal of het probleem verbindingstoegang, toolmachtigingen of de upstream-service is.
Automatisch vertaald uit het Engels. Lees de Engelse brontekst
2 minuten leestijd · Klantengids
Begin met het identificeren van de falende fase: het toevoegen van de verbinding, het ontdekken van tools, het uitvoeren van één tool of het verifiëren van een schrijfactie. Leg de tijd en een korte beschrijving vast voordat u de instellingen wijzigt.
Verbinding kan niet worden bereikt#
Controleer het exact toegewezen eindpunt en of de AI-client de transport- en authenticatiemethode ondersteunt. Een platformthuisadres is geen MCP-eindpunt. Gebruik de normale beveiligde verbinding; omzeil een certificaatwaarschuwing niet.
Als dezelfde toegewezen verbinding eerder werkte, rapporteer dan wanneer deze voor het laatst is gelukt en wat er is gewijzigd in de client. Vermijd het verwijderen van werkende verbindingsgegevens voordat een vervanging is geverifieerd.
Foutreferentie#
| Symptoom | Wat te controleren |
|---|---|
401 bij verbinding of ontdekking | Ontbrekende, verkeerde, verlopen of ingetrokken inloggegevens; onjuiste header of eindpunt. |
403 voor een operatie | Referentiebereik, tooltoestemming of upstream-servicerol; identificeren welke laag het heeft geretourneerd. |
429 | Aanvraagtoeslag overschreden; respecteer de vertraging bij nieuwe pogingen en verminder de verzoekfrequentie. |
404 | Eindpunt of record waarnaar wordt verwezen, is mogelijk verkeerd of niet beschikbaar; controleer het exacte pad en de context. |
5xx of niet beschikbaar | Platform- of upstream-serviceprobleem; leg tijd en verzoekfase vast. |
| Ongeldige argumenten | Vereist veld, invoertype, niet-ondersteund extra veld of een niet-overeenkomende ID. |
| Verbonden maar geen verwacht hulpmiddel | Toegewezen bereik, inactieve of niet-geverifieerde toevoeging, of verouderde clientdetectie. |
| Tools verschijnen, maar oproepen mislukken | Upstream-autorisatie, accountrechten of operatiespecifieke invoer. |
Dit zijn diagnostische uitgangspunten. De daadwerkelijke bron van een HTTP-fout is van belang; de toestemmingsfout van een service wordt niet opgelost door de MCP-authenticatie te verzwakken.
Een veilige diagnostische reeks#
Bevestig het eindpunt, ververs de toollijst, vergelijk deze met de overdracht en voer de overeengekomen alleen-lezen-test uit. Als dit mislukt, noteer dan de toolnaam en de geredigeerde fout. Stop voordat u een schrijfactie herhaalt waarvan het resultaat onzeker is.
Wat u ondersteuning moet sturen#
Gebruik de ondersteuningscontrolelijst. Voeg een geretourneerd screenshot of de relevante foutmelding toe, geen volledige conversatie-export of configuratie met een sleutel.