Comprendre les URI de ressources
Découvrez comment les ressources sont désignées par un schéma et un chemin.
Comprendre les URI de ressources 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.
Qu’est-ce qu’une ressource ?
Une ressource MCP est un contexte en lecture seule que votre serveur transmet au modèle, comme un fichier, une configuration ou un enregistrement. L’IA le lit, mais ne le modifie jamais.
Pourquoi une adresse ?
Chaque ressource a besoin d’un nom stable pour qu’un client puisse la demander par référence. Ce nom est son URI, tout comme une page web possède une URL. 🔗
Schéma puis chemin
L’URI d’une ressource se compose d’un schéma, puis de deux-points et de barres obliques, suivis d’un chemin. Le schéma indique le type d’élément vers lequel pointe l’URI.
file:///notes/today.txt
config://app/settingsChoisir votre propre schéma
Vous pouvez inventer librement un schéma adapté à votre serveur, comme config ou db. Le schéma regroupe les ressources associées sous une même étiquette claire.
Le schéma file
Le schéma file est courant pour les documents enregistrés sur le disque. Trois barres obliques signifient que le chemin commence à la racine, comme pour les URL file dans un navigateur.
file:///home/data/report.mdExemple de schéma personnalisé
Pour les données d’une application, un schéma personnalisé bien organisé permet de conserver une bonne lisibilité. Le modèle voit un nom qui lui indique exactement ce que contient la ressource.
users://profile/active
weather://city/londonLes URI doivent être uniques
Chaque ressource doit avoir son propre URI distinct afin que les demandes ne soient jamais ambiguës. Deux ressources partageant un même URI entreraient en conflit et perturberaient les clients.
La déclarer dans FastMCP
Dans le SDK Python, vous associez un URI à une fonction à l’aide du décorateur de ressource. Cette chaîne correspond à l’adresse que les clients utilisent pour la lire.
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("Demo")
@mcp.resource("config://app")
def config(): ...Les clients répertorient les URI
Lorsqu’un client se connecte, il demande au serveur de répertorier toutes les ressources proposées. Chaque entrée contient son URI, un nom et une brève description.
Lire par URI
Pour récupérer du contenu, le client envoie une demande de lecture indiquant l’URI exact. Le serveur associe cet URI à un gestionnaire et renvoie le contenu.
Conserver des URI stables
Considérez un URI publié comme une promesse. Le renommer ultérieurement rompt tout client ou toute référence enregistrée qui pointait vers l’ancienne adresse.
Vérification rapide
Repérez la partie qui définit le type de ressource.
Récapitulatif
Les ressources sont un contexte en lecture seule identifié par un URI : un schéma suivi d’un chemin. Gardez les URI uniques et stables afin que les clients puissent compter dessus. ✅
Apprends Python avec un tuteur IA — gratuit
Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.
- Cours
- 30
- Leçons
- 120
Questions Fréquemment Posées
La leçon « Comprendre les URI de ressources » est-elle gratuite ?
Oui — le texte complet de « Comprendre les URI de ressources » 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 « Comprendre les URI de ressources » ?
Découvrez comment les ressources sont désignées par un schéma et un chemin. 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 « Comprendre les URI de ressources » ?
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
- Comprendre les URI de ressources
- Fournir une ressource textuelle statique
- Lire un fichier sur le disque
- Définir le bon type MIME