Lire les erreurs sur le réseau

Toutes les requêtes n’aboutissent pas. Lorsqu’un problème survient, JSON-RPC renvoie un objet erreur au lieu d’un résultat ; sa lecture est le moyen le plus rapide de trouver une solution.

Une réponse d’erreur conserve l’id de la requête, mais remplace le résultat par un objet d’erreur contenant un code et un message.

Chaque erreur contient un code numérique. Les codes JSON-RPC standard sont des nombres négatifs, et quelques-uns reviennent très souvent sur le réseau.

Le code -32700 signifie que le serveur n’a même pas réussi à analyser votre JSON. En général, une virgule en trop ou un guillemet mal placé a rendu le message lui-même invalide.

Le code -32601 indique que le nom de la méthode n’existe pas. Vérifiez s’il y a une faute de frappe ou si vous utilisez une méthode que le serveur n’a jamais annoncée, comme toolz/list.

Le code -32602 signale des paramètres incorrects : un argument manquant ou un type erroné. La méthode existe, mais les entrées envoyées ne correspondent pas à ce qu’elle attend.

Le code -32603 est l’erreur interne générique du serveur. La requête était correcte, mais un problème est survenu pendant son traitement.

Le code vous indique la catégorie ; le message vous explique ce qui s’est passé. Lisez-le toujours, car les serveurs y ajoutent souvent le champ précis ou la raison de l’échec.

Les erreurs peuvent également contenir un champ data avec des informations structurées supplémentaires, par exemple le paramètre qui a été refusé. C’est très utile pour le débogage lorsque ces informations sont présentes.

Une erreur JSON-RPC signifie que le protocole lui-même a échoué. Un outil qui s’exécute mais renvoie isError produit un résultat normal : ne confondez donc pas ces deux cas.

Prenez cette habitude : lisez le code pour classer le problème, le message pour le localiser, puis vérifiez data pour trouver la cause exacte. La plupart des problèmes MCP se résolvent rapidement ainsi.

Vous savez maintenant lire les échecs avec aisance : un objet erreur contient un code, un message et parfois des données. Le code classe le problème, le message l’explique et les données en précisent la cause.