Validar las entradas antes de actuar
Rechace los argumentos incorrectos con mensajes claros.
Validar las entradas antes de actuar es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 3 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.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
Trust Nothing the Model Sends
The arguments your tool receives come from an AI, which can guess. Validate every input before you touch a file, a database, or an API.
Check First, Act Second
Run your checks at the very top of the function. Confirm the input is sane before doing any real or irreversible work.
@mcp.tool()
def set_age(age: int) -> str:
if age < 0 or age > 130:
raise ValueError("age out of range")Reject With a Clear Reason
When input fails a check, say exactly why. A precise message lets the model send a corrected value on the next attempt.
Type Hints Catch a Lot
Your parameter hints become the tool schema, so basic type mismatches are caught before your code even runs. Lean on them first.
@mcp.tool()
def repeat(text: str, times: int) -> str:
return text * timesHints Are Not Enough
Types alone cannot express ranges, formats, or allowed values. You still validate that a count is positive or a status is one you accept.
Bound Your Ranges
Guard numeric inputs against extremes. A limit on page size or loop count stops the model from accidentally overloading your server.
if limit > 100:
raise ValueError("limit must be 100 or less")Whitelist Allowed Values
For fixed choices, check membership instead of trusting free text. A whitelist rejects anything outside the options you actually support.
if status not in {"open", "closed"}:
raise ValueError("status must be open or closed")Sanitize Paths and Queries
Model input that becomes a file path or SQL query is dangerous. Sanitize it so a stray .. or quote cannot reach beyond what you intend.
Required Fields Must Exist
Confirm that anything mandatory is actually present and non-empty. An early guard beats a confusing failure deep inside your logic.
if not query.strip():
raise ValueError("query cannot be empty")Validation Doubles as Docs
Clear checks teach the model your rules. After one rejection it learns the format and sends valid input the rest of the session.
Fail Before Side Effects
The golden rule: never start an irreversible action until every input has passed. Validate up front so half-done writes never happen.
Quick Check
Why validate inputs before performing the tool's real work?
Recap
Treat model input as untrusted: validate types, ranges, and choices at the top, reject with clear reasons, and never act before checks pass. ✅
Preguntas frecuentes
¿La lección «Validar las entradas antes de actuar» es gratis?
Sí — el texto completo de «Validar las entradas antes de actuar» 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 «Validar las entradas antes de actuar»?
Rechace los argumentos incorrectos con mensajes claros. 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 3 de 4.
¿Cuánto tiempo toma la lección «Validar las entradas antes de actuar»?
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
- Errores de herramientas visibles para el modelo
- Errores del protocolo frente a fallos de herramientas
- Validar las entradas antes de actuar
- Fallar de forma segura, sin bloqueos