OneMacTools als MCP-Server für Claude, Claude Code, Cursor und Codex nutzen

Was der MCP-Server von OneMacTools macht

Das Model Context Protocol (MCP) ist der Standardweg, auf dem KI-Assistenten Apps und Werkzeuge nutzen. OneMacTools enthält einen MCP-Server, sodass ein Assistent, den du schon nutzt, Fragen wie „Was läuft auf Port 3000?“, „Was belegt Platz in meinem Benutzerordner?“ oder „Wann läuft mein Reisepass ab?“ aus dem beantworten kann, was OneMacTools über deinen Mac weiß, und OneMacTools bitten kann, Werkzeuge wie „PDF komprimieren“ oder „Transkribieren“ auf deine Dateien anzuwenden.

Der Server ist die App OneMacTools selbst, vom Assistenten mit dem Argument --mcp gestartet. Er kommuniziert mit dem Assistenten über Standardein- und -ausgabe, daher wird kein Netzwerkport geöffnet und nichts hochgeladen. Er zeigt kein eigenes Fenster; wenn ein Assistent eine Aktion anfragt, öffnet die Haupt-App OneMacTools ein Freigabefenster (und startet sich dafür im Hintergrund, falls sie nicht lief).

Er ist aus, bis du ihn einschaltest, und braucht eine aktivierte Lizenz. Fehlt eines davon, bekommt der Assistent statt Daten eine klare Meldung, die das sagt.

Welche KI-Assistenten OneMacTools einrichten kann

Einstellungen › KI-Assistenten hat eine Zeile für jeden Assistenten, den OneMacTools für dich konfigurieren kann, und ein Snippet für alles andere:

Die Taste Zu … hinzufügen einer Zeile ist ausgegraut, wenn der Assistent anscheinend nicht installiert ist (OneMacTools sucht nach seiner App oder seinem Einstellungsordner). Fahre mit dem Zeiger über die Taste, um zu sehen, welche Datei sie ändert.

So verbindest du Claude, Cursor oder Codex mit deinem Mac

1. Öffne OneMacTools und wähle OneMacTools › Einstellungen (⌘,).
2. Scrolle zu KI-Assistenten und schalte KI-Assistenten OneMacTools nutzen lassen ein.
3. Klicke auf Zu Claude Desktop hinzufügen … (oder Claude Code, Cursor oder Codex).
4. Lies die Bestätigung: „OneMacTools fügt nach einer Sicherung der Datei einen Eintrag namens „onemactools“ zu … hinzu. Sonst ändert sich nichts darin.“ Klicke auf Hinzufügen.
5. Die Zeile zeigt jetzt Hinzugefügt mit einem grünen Häkchen, und eine Zeile unter dem Abschnitt sagt dir, was als Nächstes zu tun ist, etwa „Beende Claude und öffne es erneut, um es zu laden.“ Sie nennt außerdem die Sicherungsdatei, falls es bereits eine Datei gab.
6. Starte oder lade den Assistenten wie beschrieben neu und frag ihn dann etwa: „Nutze OneMacTools, um mir zu sagen, wie es meinem Mac geht.“

Das Hinzufügen zu einem Assistenten aktiviert auch KI-Assistenten OneMacTools nutzen lassen, falls es aus war. Verschiebst du OneMacTools in einen anderen Ordner, klicke neben dem Assistenten auf Aktualisieren, damit der Eintrag auf den neuen Ort der App zeigt.

Manuelle MCP-Konfiguration für andere Assistenten

Für jeden anderen Assistenten, der MCP über stdio unterstützt, klicke neben Andere Assistenten auf Setup-Snippet kopieren und füge es in die MCP-Einstellungen des Assistenten ein. Das Snippet ist derselbe Eintrag, den OneMacTools für Claude und Cursor schreibt:

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

Der Befehl ist der Pfad zur App auf deinem Mac, sodass das kopierte Snippet immer den richtigen Pfad enthält, auch wenn du OneMacTools nicht in „Programme“ aufbewahrst. Für Claude Code enthält der Eintrag außerdem "type": "stdio". Codex verwendet TOML statt JSON, daher ist sein Eintrag eine Tabelle:

[mcp_servers.onemactools] gefolgt von command = "/Applications/OneMacTools.app/Contents/MacOS/OneMacTools" und args = ["--mcp"].

OneMacTools erkennt den Assistenten beim Verbinden an seinem Namen und verwendet diesen Namen in Freigabefenstern und im Verlauf: Claude, Claude Code, Cursor, Codex, Windsurf, Gemini CLI oder VS Code, oder den Namen, den der Assistent meldet.

Was ein Assistent ohne Nachfrage lesen kann

Lesende Werkzeuge antworten sofort, weil sie nur nachsehen. Für den Assistenten sind sie als schreibgeschützt markiert:

Zusammenfassungen von Papieren enthalten nie Ausweis-, Karten- oder Kontonummern; life_admin meldet nur, wie viele Dateien solche enthalten, und deren Namen. Den eigentlichen Text eines Dokuments zu lesen ist eine Aktion und fragt immer nach. Mehr dazu unter Berechtigungen und Freigaben für KI-Assistenten. Die Werkzeuge auf Basis von Dateien hängen von Dateien und Papierkram ab.

Wofür ein Assistent dich fragen muss

Diese Werkzeuge ändern etwas, daher öffnet jedes ein Freigabefenster in OneMacTools und wartet, bis du auf Erlauben klickst:

• run_tool: ein beliebiges Werkzeug von OneMacTools mit Optionen auf Dateien oder Text ausführen. Ergebnisse kommen in einen neuen Ordner; Originale werden nicht verändert. Werkzeuge, die dich am Mac brauchen, etwa „Bildschirmaufnahme“ oder „Meeting aufnehmen“, kann ein Assistent nicht ausführen.
• quit_app: eine App normal beenden, damit sie zum Sichern auffordern kann. Der Finder lässt sich so nicht beenden.
• stop_process und stop_agent_session: einen deiner eigenen Prozesse stoppen oder eine KI-Agentensitzung samt allem, was sie gestartet hat.
• stop_container: einen laufenden Docker-Container stoppen.
• start_recording und stop_recording: den Mac Sekunde für Sekunde aufzeichnen und dann erfahren, was Spitzenwerte erreicht hat und welche Apps dahinterstanden.
• read_document: dem Assistenten den Text eines Dokuments geben.
• move_to_trash: Dateien in deinem Benutzerordner in den Papierkorb legen, nie löschen.

Beispielanfragen zum Ausprobieren

• „Warum ist mein Mac gerade langsam?“ (nutzt mac_health und list_apps)
• „Was läuft auf Port 5173, und welches Projekt hat es gestartet? Stopp es.“ (liest mit whats_on_port und fragt dann nach stop_process)
• „Welche meiner Projekte haben alte node_modules-Ordner, und wie viel Platz bekäme ich zurück?“
• „Zeichne meinen Mac auf, während ich diesen Build laufen lasse, und sag mir dann, was Spitzenwerte erreicht hat.“
• „Finde die PDFs, die ich diese Woche aus Gmail geladen habe, und füge sie zusammen.“ (findet mit find_files und fragt dann nach run_tool)
• „Wie viel habe ich letzten Monat bei Amazon ausgegeben?“ (braucht Dateien)
• „Komprimiere diese drei Bildschirmfotos zu JPEG.“ (run_tool mit „Bilder komprimieren“)

Allgemeines zu Ports und Agenten findest du in der Anleitung Was belegt einen Port auf meinem Mac? und in der Doku zu Entwicklung & Agenten.

So schaltest du den MCP-Server aus

Schalte KI-Assistenten OneMacTools nutzen lassen unter Einstellungen › KI-Assistenten aus. Assistenten, die den Eintrag noch haben, können den Server starten, aber jeder Lesezugriff und jede Aktion erhält nur die Antwort „OneMacTools isn't letting AI assistants in“ (OneMacTools lässt keine KI-Assistenten zu).

Um OneMacTools vollständig aus einem Assistenten zu entfernen, lösche den Eintrag onemactools aus dessen Einstellungsdatei (die Pfade stehen in der Tabelle oben) oder stelle die Sicherung wieder her, die OneMacTools angelegt hat. Wenn du den Assistenten beendest, endet auch der Serverprozess.

Fragen

Verwandte Dokumentation