Definir o escopo do projeto e das ferramentas
Decida quais capacidades seu servidor exporá.
Definir o escopo do projeto e das ferramentas é 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.
Time to Ship Something Real
You have learned the pieces; now you build a complete server. This capstone wraps one real service into a tidy, installable MCP server. 🚀
Start with the User Goal
Before any code, name the job your server helps with. A clear goal like search my notes keeps every later decision focused and small.
Pick One Real Service
Choose a single concrete backend: a notes folder, a SQLite database, or one public API. One source keeps the capstone shippable, not sprawling.
List the Capabilities
Write down what the AI should be able to do, like search, read, and add. This short capability list becomes your map of tools and resources.
Sort Actions from Reads
Split your list: things that change state are tools, things that only fetch context are resources. This sorting decides each primitive up front.
Sketch the Tool Signatures
For each tool, jot a name, its arguments, and what it returns. A quick signature sketch catches missing inputs long before you write logic.
# add_note(title: str, body: str) -> str
# search_notes(query: str) -> list[str]
# A two-line sketch is enough to start.Plan One Resource
Pick one piece of read-only context to expose as a resource, such as a single note by its id. Resources feed the model without taking action.
Plan One Prompt
Add one reusable prompt the user can trigger, like summarize this note. Prompts package your best instructions so callers do not retype them.
Define Done Early
Decide what finished looks like now: the server loads, lists three tools, and answers one real query. A clear scope stops endless feature creep.
Name the Server
Give your project a short, descriptive name like notes-mcp. Clients show this name to users, so make it instantly tell people what it does.
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("notes-mcp")Write a Tiny Spec
Capture the plan in one short spec file: goal, backend, tools, resource, and prompt. This page becomes your checklist as you build the rest.
Quick Check
Let us confirm how you sort capabilities.
Recap
You scoped a real project: one goal, one backend, and a tight list of tools, a resource, and a prompt. A clear plan makes the build easy. 🎯
Perguntas Frequentes
A aula “Definir o escopo do projeto e das ferramentas” é grátis?
Sim — o texto completo de “Definir o escopo do projeto e das ferramentas” é 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 “Definir o escopo do projeto e das ferramentas”?
Decida quais capacidades seu servidor exporá. 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 “Definir o escopo do projeto e das ferramentas”?
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
- Definir o escopo do projeto e das ferramentas
- Implementar ferramentas, recursos e prompts
- Testar, inspecionar e reforçar a segurança
- Documentar e publicar o servidor