Använd OneMacTools som MCP-server för Claude, Claude Code, Cursor och Codex

Vad OneMacTools MCP-server gör

Model Context Protocol (MCP) är standardsättet för AI-assistenter att använda appar och verktyg. OneMacTools har en MCP-server, så att en assistent du redan använder kan svara på frågor som ”vad finns på port 3000?”, ”vad tar plats i min hemmapp?” eller ”när går mitt pass ut?” utifrån vad OneMacTools vet om din Mac, och kan be OneMacTools köra verktyg som Komprimera PDF eller Transkribera på dina filer.

Servern är själva OneMacTools-appen, startad av assistenten med argumentet --mcp. Den pratar med assistenten via standard in och ut, så ingen nätverksport öppnas och inget laddas upp. Den visar inget eget fönster; när en assistent ber om en åtgärd öppnar OneMacTools-appen ett godkännandefönster (och öppnar sig själv i bakgrunden om den inte var igång).

Den är av tills du slår på den, och den kräver en aktiverad licens. Om något av det saknas får assistenten ett enkelt meddelande om det i stället för data.

Vilka AI-assistenter OneMacTools kan konfigurera

Inställningar › AI-assistenter har en rad för varje assistent som OneMacTools kan konfigurera åt dig, och en kodsnutt för allt annat:

En rads Lägg till i …-knapp är nedtonad när assistenten inte verkar vara installerad (OneMacTools letar efter dess app eller dess inställningsmapp). Håll pekaren över knappen för att se vilken fil den kommer att ändra.

Så ansluter du Claude, Cursor eller Codex till din Mac

1. Öppna OneMacTools och välj OneMacTools › Inställningar (⌘,).
2. Rulla till AI-assistenter och slå på Låt AI-assistenter använda OneMacTools.
3. Klicka på Lägg till i Claude Desktop… (eller Claude Code, Cursor eller Codex).
4. Läs bekräftelsen: ”OneMacTools lägger till en post som heter ”onemactools” i … efter att ha säkerhetskopierat filen. Inget annat i den ändras.” Klicka på Lägg till.
5. Raden visar nu Tillagd med en grön bock, och en rad under avsnittet säger vad du ska göra härnäst, till exempel ”Avsluta och öppna Claude igen för att läsa in den.” Den anger också säkerhetskopians namn om det fanns en befintlig fil.
6. Starta om eller läs in assistenten igen enligt beskrivningen och be den sedan om något i stil med ”Använd OneMacTools för att berätta hur min Mac mår.”

När du lägger till i en assistent slås även Låt AI-assistenter använda OneMacTools på om det var avstängt. Om du flyttar OneMacTools till en annan mapp klickar du på Uppdatera bredvid assistenten så att posten pekar på appens nya plats.

Manuell MCP-konfiguration för andra assistenter

För andra assistenter som har stöd för MCP över stdio klickar du på Kopiera konfigurationskod bredvid Andra assistenter och klistrar in den i assistentens MCP-inställningar. Kodsnutten är samma post som OneMacTools skriver för Claude och Cursor:

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

Kommandot är sökvägen till appen på din Mac, så den kopierade kodsnutten har alltid rätt sökväg även om du har OneMacTools någon annanstans än i Program. För Claude Code har posten också "type": "stdio". Codex använder TOML i stället för JSON, så dess post är en tabell:

[mcp_servers.onemactools] följt av command = "/Applications/OneMacTools.app/Contents/MacOS/OneMacTools" och args = ["--mcp"].

OneMacTools känner igen assistenten på namnet när den ansluter och använder det namnet i godkännandefönster och i Historik: Claude, Claude Code, Cursor, Codex, Windsurf, Gemini CLI eller VS Code, eller det namn assistenten uppger.

Vad en assistent kan läsa utan att fråga

Läsverktyg svarar direkt, eftersom de bara tittar. De är markerade som skrivskyddade för assistenten:

Sammanfattningar av papper innehåller aldrig ID-, kort- eller kontonummer; life_admin rapporterar bara hur många filer som innehåller dem och deras namn. Att läsa ett dokuments faktiska text är en åtgärd och frågar alltid. Mer om detta i Behörigheter och godkännanden för AI-assistenter. De Filer-baserade verktygen bygger på Filer och Pappersarbete.

Vad en assistent måste be dig om

De här verktygen ändrar något, så vart och ett öppnar ett godkännandefönster i OneMacTools och väntar på att du klickar på Tillåt:

• run_tool: kör valfritt OneMacTools-verktyg på filer eller text, med alternativ. Resultaten hamnar i en ny mapp; original ändras inte. Verktyg som kräver att du sitter vid Macen, som Skärminspelning eller Spela in möte, kan inte köras av en assistent.
• quit_app: avsluta en app på vanligt sätt, så att den kan be om att spara. Finder kan inte avslutas på det här sättet.
• stop_process och stop_agent_session: stoppa en av dina egna processer, eller en AI-agentsession och allt den startat.
• stop_container: stoppa en Docker-behållare som körs.
• start_recording och stop_recording: registrera Macen sekund för sekund och få sedan veta vad som toppade och vilka appar som låg bakom.
• read_document: ge assistenten texten i ett dokument.
• move_to_trash: flytta filer i din hemmapp till papperskorgen, aldrig radera dem.

Exempel på uppmaningar att prova

• ”Varför är min Mac långsam just nu?” (använder mac_health och list_apps)
• ”Vad körs på port 5173, och vilket projekt startade det? Stoppa det.” (läser med whats_on_port och ber sedan om att få köra stop_process)
• ”Vilka av mina projekt har gamla node_modules-mappar, och hur mycket utrymme skulle jag få tillbaka?”
• ”Registrera min Mac medan jag kör det här bygget, och berätta sedan vad som toppade.”
• ”Hitta PDF:erna jag hämtade från Gmail den här veckan och slå ihop dem.” (hittar med find_files och ber sedan om att få köra run_tool)
• ”Hur mycket spenderade jag på Amazon förra månaden?” (kräver Filer)
• ”Komprimera de här tre skärmbilderna till JPEG.” (run_tool med Komprimera bilder)

Allmän bakgrund om portar och agenter finns i guiden Vad använder en port på min Mac? och i dokumentationen för Utveckling och agenter.

Så stänger du av MCP-servern

Stäng av Låt AI-assistenter använda OneMacTools i Inställningar › AI-assistenter. Assistenter som fortfarande har posten kan starta servern, men varje läsning och åtgärd får svaret ”OneMacTools släpper inte in AI-assistenter” och inget annat.

Om du vill ta bort OneMacTools helt från en assistent raderar du posten onemactools ur dess inställningsfil (sökvägarna finns i tabellen ovan), eller återställer säkerhetskopian som OneMacTools gjorde. När du avslutar assistenten avslutas även serverprocessen.

Frågor

Relaterad dokumentation