Voici le fait que la plupart des guides enterrent. Ollama est un serveur de modèles. Son API accepte une liste d’outils et retourne des appels d’outils, et la documentation officielle montre cette boucle en détail. Démarrer un serveur MCP, lire sa liste d’outils, exécuter l’appel que le modèle a demandé et ramener le résultat est un deuxième travail, et Ollama ne fait pas ce travail. Il vous faut un client MCP entre le modèle et les serveurs. Ce tutoriel installe ce client, connecte un serveur sûr et se termine avec un modèle local qui lit et écrit de vrais fichiers sur votre propre machine, sans aucun compte infonuagique dans la boucle.
Ce que vous allez construire ou apprendre
Vous terminerez avec un clavardage en terminal où un modèle local peut utiliser le serveur de fichiers MCP officiel sur un dossier de test que vous choisissez. Le modèle listera ce dossier, créera un fichier dedans quand vous approuverez l’appel et relira le fichier. Le schéma se répète ensuite pour tout autre serveur MCP que vous ajouterez plus tard, parce que le client, et non le modèle, possède la liste des serveurs.
La voie suivie ici utilise ollmcp, le projet MCP Client for Ollama, parce qu’il parle à Ollama dans son API native et reste dans le terminal. Les agents de codage lancés par Ollama, comme les intégrations derrière ollama launch, sont aussi des clients MCP et suivent la même forme. Le client change. La division du travail, non.
Avant de commencer
Commencez par un dossier de test, jamais par votre dossier personnel ni par la racine d’un disque. Le serveur de fichiers peut lire et écrire chaque chemin que vous lui donnez, et un modèle qui lit mal une invite peut faire de vrais dégâts dans ces chemins. L’invite d’approbation dans ollmcp est activée par défaut et montre chaque appel d’outil avant son exécution. Laissez la activée pendant tout ce tutoriel.
Étape 1 : installer Ollama et confirmer que le serveur répond
Action : installez Ollama depuis son site officiel, ou utilisez le script sous Linux et macOS. Confirmez ensuite que le serveur local répond.
curl -fsSL https://ollama.com/install.sh | sh
ollama --version
curl http://localhost:11434/
Résultat attendu : la commande de version affiche votre version d’Ollama, et l’appel final répond avec la ligne de texte brut Ollama is running. Sous Windows et macOS, ouvrez l’application Ollama une fois si le serveur ne répond pas, puisque l’application démarre le serveur en arrière plan. Rien d’autre dans ce tutoriel ne fonctionne tant que cette adresse reste silencieuse.
Étape 2 : télécharger un modèle capable d’appeler des outils
Action : téléchargez un modèle avec prise en charge des outils. Le projet ollmcp liste les gammes qwen2.5 et qwen3 ainsi que llama3.1 et llama3.2 parmi les modèles qui fonctionnent bien avec l’usage d’outils, et la documentation d’appel d’outils d’Ollama construit ses exemples sur qwen3. Commencez par la taille 8B.
ollama pull qwen3:8b
ollama list
Résultat attendu : ollama list montre qwen3:8b sur le disque. Un modèle sans prise en charge des outils continuera de clavarder dans le client et n’appellera jamais un outil, ce qui est la cause la plus fréquente d’une installation qui semble terminée et qui ne fait rien. Si vous changez de modèle plus tard, vérifiez d’abord la prise en charge des outils sur la page du modèle.
Étape 3 : relever le contexte avant l’arrivée des listes d’outils
Action : redémarrez Ollama avec un contexte plus grand. Les listes d’outils mangent le contexte rapidement. Ollama lui même note qu’une fenêtre de contexte de 32k ou plus améliore les performances de l’appel d’outils, et une petite fenêtre par défaut peut ne laisser aucune place pour les définitions d’outils plus votre conversation. Arrêtez d’abord le serveur en cours, puis démarrez le avec le réglage en place.
OLLAMA_CONTEXT_LENGTH=32768 ollama serve
Résultat attendu : Ollama démarre et sert comme d’habitude, maintenant avec de la place pour la liste d’outils du serveur de fichiers et une conversation de travail. L’usage de la mémoire augmente avec le contexte, alors c’est un échange que vous faites exprès. Faites fonctionner ce serveur dans sa propre fenêtre de terminal et laissez la ouverte pendant que vous parcourez le reste des étapes.
Étape 4 : installer le client MCP
Action : installez ollmcp avec pip, ou lancez le en une étape avec l’outil uv si vous utilisez déjà uv.
pip install ollmcp
ollmcp --help
Résultat attendu : le texte d’aide affiche les options du client, dont --mcp-server, --servers-json, --model et --host. L’hôte par défaut est http://localhost:11434, ce qui correspond à l’étape 1, alors aucun travail d’adresse n’est nécessaire pour une installation locale.
Étape 5 : écrire la configuration du serveur
Action : créez un dossier de test et un fichier de configuration qui donne ce seul dossier au serveur de fichiers officiel. Remplacez l’exemple de chemin d’utilisateur par votre propre chemin absolu, et gardez le pointé sur le dossier de test seulement.
mkdir -p ~/ollama-mcp/playground
Enregistrez ceci sous le nom servers.json dans le dossier ~/ollama-mcp :
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/yourname/ollama-mcp/playground"]
}
}
}
Résultat attendu : le fichier nomme un serveur, démarré par npx, avec une seule racine autorisée. Le serveur de fichiers refuse les chemins hors des racines dans sa liste d’arguments, ce qui est le garde fou qui rend le test sûr. Sous Windows, utilisez le chemin Windows complet du dossier de jeu dans le même emplacement d’argument.
Étape 6 : démarrer le client et vérifier les outils chargés
Action : démarrez ollmcp avec votre fichier de configuration et votre modèle téléchargé.
ollmcp --servers-json ~/ollama-mcp/servers.json --model qwen3:8b
Résultat attendu : le client se connecte à Ollama, démarre le serveur de fichiers et ouvre son écran de clavardage. Tapez tools et appuyez sur Entrée. La liste d’outils devrait montrer les outils du système de fichiers, parmi eux des outils pour lister un répertoire, lire un fichier et écrire un fichier. Si la liste est vide, le serveur n’a pas démarré, et c’est à l’étape 5 qu’il faut regarder d’abord.
Étape 7 : donner une vraie tâche au modèle
Action : demandez un travail que seul un outil peut faire, en mots simples.
List the files in the playground folder. Then create a file called hello.txt in that folder with one sentence: the local model was here. Then read hello.txt back and tell me what it says.
Résultat attendu : avant que l’écriture s’exécute, l’invite d’approbation montre le nom de l’outil et ses arguments. Lisez les, confirmez que le chemin se trouve dans le dossier de jeu et approuvez. Le modèle devrait signaler un dossier vide ou presque vide au départ, créer le fichier et vous citer votre phrase à partir de la lecture. Cette citation vient du disque, et non de la mémoire du clavardage, et cette différence est tout l’objet de l’installation.
Vérification
Ouvrez un deuxième terminal et vérifiez le fichier vous même, sans demander au modèle.
ls ~/ollama-mcp/playground
cat ~/ollama-mcp/playground/hello.txt
La liste montre hello.txt, et l’affichage montre votre phrase exactement comme elle a été écrite. Dans le client, tapez tools encore une fois et confirmez que les outils du système de fichiers s’affichent toujours comme activés. Si le fichier existe sur le disque et que le client liste toujours les outils, la boucle fonctionne de bout en bout : invite, appel d’outil, approbation, serveur, résultat, réponse.
Dépannage
| Problème | Cause probable | Correctif |
|---|---|---|
| Le modèle clavarde mais n’appelle jamais un outil | Le modèle téléchargé n’a pas la prise en charge des outils, ou le contexte est trop petit pour la liste d’outils | Téléchargez qwen3:8b, redémarrez Ollama avec le contexte de l’étape 3 et redémarrez le client |
| Le client s’ouvre sans aucun outil listé | Le serveur de fichiers n’a pas réussi à démarrer | Testez le serveur seul avec npx -y @modelcontextprotocol/server-filesystem plus votre chemin de dossier de jeu, et corrigez le chemin ou l’installation Node.js qu’il signale |
Connection refused at localhost:11434 | Ollama ne fonctionne pas | Ouvrez l’application Ollama, ou lancez ollama serve, puis redémarrez le client |
| Le modèle dit qu’il ne peut pas atteindre un dossier | Ce dossier se trouve hors de la racine autorisée dans servers.json | Ajoutez le bon chemin absolu aux arguments du serveur, enregistrez le fichier et tapez reload-servers dans le client |
| Un appel d’outil attendu n’a jamais demandé d’approbation et ne s’est jamais exécuté | L’outil est désactivé dans la liste d’outils du client | Tapez tools, activez l’outil ou son serveur, enregistrez et répétez la demande |
| Le modèle invente le contenu des fichiers au lieu de les lire | Il a répondu sans appel d’outil dans ce tour | Demandez de nouveau, nommez l’action d’outil dans l’invite et surveillez l’invite d’approbation comme preuve que l’appel est parti |
Prochaines étapes
Ajoutez un deuxième serveur au même fichier servers.json et le client offrira les deux ensembles d’outils dans un seul clavardage. La collection officielle des serveurs MCP est l’étagère sûre où magasiner, et le schéma du système de fichiers à l’étape 5 couvre la plupart des serveurs stdio : une commande, ses arguments et un bloc env quand une clé est nécessaire, écrit comme espace réservé dans tout ce que vous partagez. Enregistrez une configuration qui fonctionne avec la commande save-config dans le client pour que ollmcp tout court rouvre la même installation.
Quand le travail passe du clavardage au code, les mêmes serveurs vous suivent. Les agents démarrés par ollama launch, comme OpenCode et Claude Code, lisent leur propre configuration MCP et pilotent le modèle local de la même façon qu’ollmcp ici. Apprenez la boucle d’abord dans le terminal, où chaque appel demande votre permission. Puis donnez lui de plus gros outils, les yeux ouverts.
Commandes et comportement vérifiés par rapport à la documentation d’appel d’outils d’Ollama, à la note d’Ollama sur les appels d’outils en continu et la taille du contexte, à la documentation du projet ollmcp et au format de configuration du serveur de fichiers MCP, octobre 2026. Cette procédure a été vérifiée par rapport à ces documents; exécutez la d’abord sur un dossier de test, comme écrit.
Sources
- Illustration: Ollama
FIN DE LA TRANSMISSION
Restez curieux. Remettez tout en question.
