Enregistrer votre première instruction
Décorez une fonction pour publier une instruction.
Enregistrer votre première instruction est une leçon MCP Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage MCP Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours MCP Academy comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Your First Prompt
Time to publish a prompt: a reusable, user-triggered template that starts a task with well-crafted wording every time. 💬
The Decorator
You turn a plain Python function into a prompt with the @mcp.prompt() decorator, just like you marked tools with @mcp.tool().
@mcp.prompt()
def greet() -> str:
return "Say hello warmly."Name Comes from the Function
By default the prompt's name is the function name. Clients show that name in a slash menu, so make it short and clear.
The Return Value
The simplest prompt returns a string. That text becomes the opening user message handed to the model when someone picks the prompt.
Add a Description
The function's docstring becomes the prompt description. It tells the user what this prompt is for before they trigger it.
@mcp.prompt()
def greet() -> str:
"""Start a friendly greeting."""
return "Say hello warmly."User-Triggered, Not Automatic
Unlike tools, a prompt only runs when the user explicitly chooses it. The model never invokes a prompt on its own.
It Lives on the Server
Your prompt is registered on the same FastMCP server instance that holds your tools and resources. One server, three primitive kinds.
mcp = FastMCP("my-server")
@mcp.prompt()
def greet() -> str:
return "Say hello warmly."Clients Can List It
Once registered, clients call prompts/list to discover it. That is how a host fills its slash-command or template menu.
Pick It, Get the Message
When the user selects your prompt, the host fetches it and seeds the chat with your returned text. They start from a polished opener.
Keep the Text Focused
A good prompt body gives the model clear instructions, not a wall of options. State the goal and the tone, then stop.
Why Bother
A registered prompt saves everyone from retyping the same request and keeps phrasing consistent across a whole team. ✨
Quick Check
Let's confirm how prompts get registered.
Recap: First Prompt
Nice work! The @mcp.prompt() decorator publishes a function as a user-triggered template, with its name and docstring shown to users. ✅
Questions Fréquemment Posées
La leçon « Enregistrer votre première instruction » est-elle gratuite ?
Oui — le texte complet de « Enregistrer votre première instruction » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours MCP Academy, passe à CoddyKit PRO. Le cours MCP Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Enregistrer votre première instruction » ?
Décorez une fonction pour publier une instruction. Tu pratiques MCP Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer MCP Academy ?
Aucune expérience préalable n'est requise. MCP Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Enregistrer votre première instruction » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon MCP Academy ?
Oui. Chaque leçon MCP Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Enregistrer votre première instruction
- Ajouter des arguments à une instruction
- Renvoyer des messages, pas seulement du texte
- Un modèle d’instruction pour la revue de code