Leer errores en el protocolo
Interprete los códigos y mensajes de error cuando fallan las llamadas.
Leer errores en el protocolo es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de MCP Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de MCP Academy incluye 4 lecciones en total.
Cuando las llamadas fallan
No todas las solicitudes tienen éxito. Cuando algo falla, JSON-RPC devuelve un objeto error en lugar de un resultado, y leerlo es la forma más rápida de encontrar una solución.
El objeto error
Una respuesta de error conserva el id de la solicitud, pero sustituye result por un objeto error que contiene un código y un mensaje.
{"jsonrpc": "2.0", "id": 3,
"error": {"code": -32601, "message": "Method not found"}}Los códigos son números
Cada error contiene un code numérico. Los códigos estándar de JSON-RPC son números negativos y algunos aparecen una y otra vez en la comunicación.
Error de análisis: -32700
El código -32700 significa que el servidor ni siquiera pudo analizar su JSON. Normalmente, una coma sobrante o unas comillas mal formadas dañaron el mensaje.
{"error": {"code": -32700, "message": "Parse error"}}Método no encontrado: -32601
El código -32601 indica que el nombre del método no existe. Busque una errata o un método que el servidor nunca anunció, como toolz/list.
{"error": {"code": -32601, "message": "Method not found"}}Parámetros no válidos: -32602
El código -32602 señala que params no es válido: falta un argumento o el tipo es incorrecto. El método existe, pero las entradas enviadas no son adecuadas.
{"error": {"code": -32602, "message": "Invalid params"}}Error interno: -32603
El código -32603 es el error interno general del servidor. La solicitud era correcta, pero algo falló al procesarla.
{"error": {"code": -32603, "message": "Internal error"}}Lea el campo message
El código indica la categoría; el campo message cuenta la historia. Léalo siempre, ya que los servidores suelen añadir el campo exacto o el motivo del fallo.
Datos opcionales para más detalles
Los errores también pueden incluir un campo data con información estructurada adicional, como el parámetro rechazado. Resulta muy útil para depurar cuando está presente.
{"error": {"code": -32602, "data": {"field": "a"}}}Error del protocolo frente a fallo de la herramienta
Un error de JSON-RPC significa que el propio protocolo falló. Una herramienta que se ejecuta pero devuelve isError sigue siendo un resultado normal, así que no debe confundir ambos casos.
Un reflejo de depuración
Adquiera este hábito: lea el code para clasificar el error, lea el mensaje para localizarlo y después revise data para encontrar la causa exacta. Así, la mayoría de los errores de MCP se resuelven rápidamente.
Comprobación rápida
Ha enviado un método válido, pero falta un argumento. ¿Qué código de error corresponde?
Resumen: descifrar errores
Ahora puede interpretar los fallos con soltura: un objeto error contiene un código, un mensaje y, a veces, datos. El código clasifica, el mensaje explica y los datos señalan la causa.
Preguntas frecuentes
¿La lección «Leer errores en el protocolo» es gratis?
Sí — el texto completo de «Leer errores en el protocolo» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de MCP Academy, actualiza a CoddyKit PRO. El curso de MCP Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Leer errores en el protocolo»?
Interprete los códigos y mensajes de error cuando fallan las llamadas. Practicas MCP Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar MCP Academy?
No se requiere experiencia previa. MCP Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Leer errores en el protocolo»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de MCP Academy?
Sí. Cada lección de MCP Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Solicitudes, respuestas y notificaciones
- Anatomía de una llamada JSON-RPC
- El protocolo de inicialización
- Leer errores en el protocolo