URIs de recursos explicadas
Como os recursos são identificados por esquema e caminho.
URIs de recursos explicadas é 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.
What a Resource Is
An MCP resource is read-only context your server hands the model, like a file, config, or record. The AI reads it, but never changes it.
Why an Address
Each resource needs a stable name so a client can ask for it by reference. That name is its URI, just like a web page has a URL. 🔗
Scheme Then Path
A resource URI is built from a scheme, then a colon and slashes, then a path. The scheme says what kind of thing the URI points to.
file:///notes/today.txt
config://app/settingsPick Your Own Scheme
You are free to invent a scheme that fits your server, such as config or db. The scheme groups related resources under one clear label.
The file Scheme
The file scheme is common for documents on disk. Three slashes mean the path starts at the root, just like file URLs in a browser.
file:///home/data/report.mdCustom Scheme Example
For app data, a tidy custom scheme keeps things readable. The model sees a name that tells it exactly what the resource holds.
users://profile/active
weather://city/londonURIs Must Be Unique
Every resource needs its own distinct URI so requests are never ambiguous. Two resources sharing one URI would collide and confuse clients.
Declare It in FastMCP
In the Python SDK you attach a URI to a function with the resource decorator. That string is the address clients use to read it.
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("Demo")
@mcp.resource("config://app")
def config(): ...Clients List URIs
When a client connects, it asks the server to list every resource it offers. Each entry carries its URI, a name, and a short description.
Read by URI
To fetch content, the client sends a read request naming the exact URI. The server matches that URI to a handler and returns the body.
Keep URIs Stable
Treat a published URI like a promise. Renaming it later breaks any client or saved reference that pointed at the old address.
Quick Check
Spot the part that defines the resource type.
Recap
Resources are read-only context named by a URI: a scheme plus a path. Keep URIs unique and stable so clients can rely on them. ✅
Perguntas Frequentes
A aula “URIs de recursos explicadas” é grátis?
Sim — o texto completo de “URIs de recursos explicadas” é 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 “URIs de recursos explicadas”?
Como os recursos são identificados por esquema e caminho. 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 “URIs de recursos explicadas”?
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
- URIs de recursos explicadas
- Disponibilizar um recurso de texto estático
- Ler um arquivo do disco
- Definir o tipo MIME correto