Utiliser OneMacTools comme serveur MCP pour Claude, Claude Code, Cursor et Codex

Ce que fait le serveur MCP de OneMacTools

Le Model Context Protocol (MCP) est la manière standard dont les assistants IA utilisent les apps et les outils. OneMacTools inclut un serveur MCP : un assistant que vous utilisez déjà peut répondre à des questions comme « qu'y a-t-il sur le port 3000 ? », « qu'est-ce qui prend de la place dans mon dossier personnel ? » ou « quand expire mon passeport ? » à partir de ce que OneMacTools sait de votre Mac, et peut demander à OneMacTools d'exécuter des outils comme Compresser un PDF ou Transcrire sur vos fichiers.

Le serveur est l'app OneMacTools elle-même, lancée par l'assistant avec l'argument --mcp. Il communique avec l'assistant par l'entrée et la sortie standard : aucun port réseau n'est ouvert et rien n'est envoyé en ligne. Il n'affiche aucune fenêtre propre ; quand un assistant demande une action, l'app OneMacTools principale ouvre une fenêtre d'autorisation (en se lançant en arrière-plan si elle n'était pas ouverte).

Il est désactivé tant que vous ne l’activez pas, et il nécessite une licence activée. Si l’une de ces conditions manque, l’assistant reçoit un message simple l’indiquant au lieu de données.

Quels assistants IA OneMacTools peut configurer

Réglages › Assistants IA comporte une ligne pour chaque assistant que OneMacTools peut configurer pour vous, et un extrait de configuration pour tous les autres :

Le bouton Ajouter à … d’une ligne est grisé quand l’assistant ne semble pas installé (OneMacTools cherche son app ou son dossier de réglages). Survolez le bouton pour voir quel fichier il modifiera.

Comment connecter Claude, Cursor ou Codex à votre Mac

1. Ouvrez OneMacTools et choisissez OneMacTools › Réglages (⌘,).
2. Faites défiler jusqu'à Assistants IA et activez Permettre aux assistants IA d'utiliser OneMacTools.
3. Cliquez sur Ajouter à Claude Desktop… (ou Claude Code, Cursor ou Codex).
4. Lisez la confirmation : « OneMacTools ajoute une entrée nommée “onemactools” à … après avoir sauvegardé le fichier. Rien d'autre n'y change. » Cliquez sur Ajouter.
5. La ligne affiche maintenant Ajouté avec une coche verte, et une ligne sous la section vous indique la suite, comme « Quittez et rouvrez Claude pour le charger. » Elle nomme aussi le fichier de sauvegarde s'il en existait un.
6. Redémarrez ou rechargez l'assistant comme indiqué, puis demandez-lui par exemple « Use OneMacTools to tell me how my Mac is doing. »

Ajouter OneMacTools à un assistant active aussi Permettre aux assistants IA d’utiliser OneMacTools si ce réglage était désactivé. Si vous déplacez OneMacTools dans un autre dossier, cliquez sur Mettre à jour à côté de l’assistant pour que l’entrée pointe vers le nouvel emplacement de l’app.

Configuration MCP manuelle pour les autres assistants

Pour tout autre assistant qui prend en charge MCP via stdio, cliquez sur Copier l’extrait de configuration à côté de Autres assistants et collez-le dans les réglages MCP de cet assistant. L’extrait est la même entrée que celle que OneMacTools écrit pour Claude et Cursor :

{ "mcpServers": { "onemactools": { "command": "/Applications/OneMacTools.app/Contents/MacOS/OneMacTools", "args": ["--mcp"] } } }

La commande est le chemin de l'app sur votre Mac : l'extrait copié a donc toujours le bon chemin, même si vous gardez OneMacTools ailleurs que dans Applications. Pour Claude Code, l'entrée contient aussi "type": "stdio". Codex utilise TOML au lieu de JSON, son entrée est donc une table :

[mcp_servers.onemactools] suivi de command = "/Applications/OneMacTools.app/Contents/MacOS/OneMacTools" et args = ["--mcp"].

OneMacTools reconnaît l'assistant à son nom lorsqu'il se connecte et utilise ce nom dans les fenêtres d'autorisation et l'Historique : Claude, Claude Code, Cursor, Codex, Windsurf, Gemini CLI ou VS Code, ou le nom que l'assistant indique.

Ce qu'un assistant peut lire sans demander

Les outils de lecture répondent tout de suite, car ils ne font que regarder. Ils sont signalés à l'assistant comme étant en lecture seule :

Les résumés de papiers n'incluent jamais de numéros d'identité, de carte ou de compte ; life_admin indique seulement combien de fichiers en contiennent et leurs noms. Lire le texte réel d'un document est une action et demande toujours une autorisation. Plus de détails dans Autorisations et approbations des assistants IA. Les outils basés sur Fichiers dépendent de Fichiers et de Paperasse.

Ce qu'un assistant doit vous demander

Ces outils modifient quelque chose : chacun ouvre donc une fenêtre d'autorisation dans OneMacTools et attend que vous cliquiez sur Autoriser :

• run_tool : exécuter n'importe quel outil OneMacTools sur des fichiers ou du texte, avec des options. Les résultats vont dans un nouveau dossier ; les originaux ne sont pas modifiés. Les outils qui ont besoin de vous devant le Mac, comme Enregistrement d'écran ou Enregistrer une réunion, ne peuvent pas être exécutés par un assistant.
• quit_app : quitter une app normalement, pour qu'elle puisse proposer d'enregistrer. Le Finder ne peut pas être quitté de cette façon.
• stop_process et stop_agent_session : arrêter l'un de vos propres processus, ou une session d'agent IA et tout ce qu'elle a lancé.
• stop_container : arrêter un conteneur Docker en cours d'exécution.
• start_recording et stop_recording : enregistrer l'activité du Mac seconde par seconde, puis obtenir les pics et les apps qui en étaient la cause.
• read_document : transmettre à l'assistant le texte d'un document.
• move_to_trash : placer dans la corbeille des fichiers de votre dossier personnel, sans jamais les supprimer.

Exemples de demandes à essayer

• « Pourquoi mon Mac est-il lent en ce moment ? » (utilise mac_health et list_apps)
• « Qu'est-ce qui tourne sur le port 5173, et quel projet l'a lancé ? Arrête-le. » (lit avec whats_on_port, puis demande stop_process)
• « Lesquels de mes projets ont d'anciens dossiers node_modules, et combien de place récupérerais-je ? »
• « Enregistre l'activité de mon Mac pendant cette compilation, puis dis-moi ce qui a atteint un pic. »
• « Trouve les PDF que j'ai téléchargés depuis Gmail cette semaine et fusionne-les. » (trouve avec find_files, puis demande run_tool)
• « Combien ai-je dépensé sur Amazon le mois dernier ? » (nécessite Fichiers)
• « Compresse ces trois captures d'écran en JPEG. » (run_tool avec Compresser des images)

Pour des informations générales sur les ports et les agents, voir le guide Qu’est-ce qui utilise un port sur mon Mac ? et la documentation Dev et agents.

Comment désactiver le serveur MCP

Désactivez Permettre aux assistants IA d'utiliser OneMacTools dans Réglages › Assistants IA. Les assistants qui ont encore l'entrée peuvent démarrer le serveur, mais chaque lecture et action reçoit la réponse « OneMacTools ne laisse pas entrer les assistants IA » et rien d'autre.

Pour retirer complètement OneMacTools d'un assistant, supprimez l'entrée onemactools de son fichier de réglages (les chemins figurent dans le tableau ci-dessus), ou restaurez la sauvegarde faite par OneMacTools. Quitter l'assistant met aussi fin au processus du serveur.

Questions

Documentation associée