Los servidores MCP pueden definir prompts: instrucciones preescritas y de alta calidad que los clientes pueden usar en lugar de escribir las suyas desde cero. Piensa en los prompts como plantillas cuidadosamente elaboradas que dan mejores resultados que lo que los usuarios podrían escribir por su cuenta.
¿Por qué usar prompts?
Supongamos que quieres que Claude reformatee un documento en markdown. Podrías simplemente pedir "Convierte report.pdf a markdown" y funcionaría bien. Pero probablemente obtendrías resultados mucho mejores con un prompt detallado y bien probado que cubra casos límite y dé instrucciones de formato específicas.

La idea es simple: como desarrolladores de servidores MCP, podemos dedicar tiempo a crear y probar prompts realmente buenos, y luego ponerlos a disposición de cualquiera que use nuestro servidor. Los usuarios obtienen mejores resultados sin tener que convertirse ellos mismos en expertos en ingeniería de prompts.
Definir un prompt
Los prompts usan un patrón de decorador similar al de las herramientas y los recursos. Esta es la estructura básica:
@mcp.prompt(
name="format",
description="Rewrites the contents of the document in Markdown format."
)
def format_document(
doc_id: str = Field(description="Id of the document to format")
) -> list[base.Message]:
# Devuelve una lista de mensajesLa función devuelve una lista de mensajes que se pueden enviar directamente a Claude. Esto te permite construir prompts complejos con varios mensajes de usuario y de asistente si es necesario.
Construir el prompt de formato
Para nuestro servidor de documentos, crearemos un prompt que reformatee documentos a markdown. El prompt necesita:
- Tomar un ID de documento como entrada
- Usar la herramienta read_doc_contents para obtener el documento
- Reformatearlo con la sintaxis de markdown adecuada
- Guardar los cambios de nuevo en el documento
Así es como se ve la implementación:
def format_document(
doc_id: str = Field(description="Id of the document to format")
) -> list[base.Message]:
prompt = f"""
Your goal is to reformat a document to be written with markdown syntax.
The id of the document you need to reformat is:
{doc_id}
Add in headers, bullet points, tables, etc as necessary. Feel free to add in structure.
Use the 'edit_document' tool to edit the document. After the document has been reformatted...
"""
return [
base.UserMessage(prompt)
]Probar el prompt
Una vez que hayas definido tu prompt, puedes probarlo usando el MCP Inspector. Navega a la pestaña Prompts, selecciona tu prompt y proporciona los parámetros requeridos.

El inspector te mostrará los mensajes generados que se enviarían a Claude. Puedes verificar que la interpolación de parámetros funcione correctamente y que tu prompt contenga todas las instrucciones necesarias.
Beneficios clave
- Control de calidad: los autores del servidor pueden probar y refinar los prompts antes de que los usuarios los vean
- Consistencia: todos obtienen el mismo prompt de alta calidad en lugar de improvisar
- Especialización: los prompts se pueden adaptar al dominio y las capacidades específicas de tu servidor
- Reutilización: varias aplicaciones cliente pueden usar los mismos prompts bien elaborados
Recuerda importar el módulo base para los tipos de mensaje:
from mcp.server.fastmcp.prompts import baseLos prompts son particularmente valiosos cuando tu servidor MCP tiene un área de enfoque específica, como la gestión de documentos, el análisis de datos o la generación de código. Puedes proporcionar a los usuarios prompts probados en la práctica que aprovechen las herramientas de tu servidor de manera efectiva.