Registrar seu primeiro prompt
Adicione um decorador a uma função para publicar um prompt.
Registrar seu primeiro prompt é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
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. ✅
Perguntas Frequentes
A aula “Registrar seu primeiro prompt” é grátis?
Sim — o texto completo de “Registrar seu primeiro prompt” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.
O que vou aprender em “Registrar seu primeiro prompt”?
Adicione um decorador a uma função para publicar um prompt. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar MCP Academy?
Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Registrar seu primeiro prompt”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de MCP Academy?
Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Registrar seu primeiro prompt
- Adicionar argumentos a um prompt
- Retornar mensagens, não apenas texto
- Um modelo de prompt para revisão de código