Використання OneMacTools як MCP-сервера для Claude, Claude Code, Cursor і Codex

Що робить MCP-сервер OneMacTools

Model Context Protocol (MCP) — це стандартний спосіб, у який ШІ-асистенти користуються програмами й інструментами. OneMacTools має вбудований MCP-сервер, тож асистент, яким ви вже користуєтеся, може відповідати на запитання на кшталт «що працює на порту 3000?», «що займає місце в моїй домашній папці?» чи «коли спливає термін мого паспорта?» на основі того, що OneMacTools знає про ваш Mac, а також просити OneMacTools запускати для ваших файлів такі інструменти, як «Стиснення PDF» чи «Транскрибувати».

Сервер — це сама програма OneMacTools, яку асистент запускає з аргументом --mcp. Вона спілкується з асистентом через стандартні ввід і вивід, тож жоден мережевий порт не відкривається й нічого не вивантажується. Власного вікна сервер не має; коли асистент просить виконати дію, основна програма OneMacTools відкриває вікно схвалення (запускаючись у фоні, якщо її не було запущено).

Він вимкнений, доки ви його не ввімкнете, і потребує активованої ліцензії. Якщо чогось із цього бракує, асистент отримує просте повідомлення про це замість будь-яких даних.

Яких ШІ-асистентів може налаштувати OneMacTools

Параметри › ШІ-асистенти містить рядок для кожного асистента, якого OneMacTools може налаштувати за вас, і фрагмент для всіх інших:

Кнопка Додати до … в рядку неактивна, коли схоже, що цей асистент не встановлено (OneMacTools шукає його програму чи папку налаштувань). Наведіть указівник на кнопку, щоб побачити, який файл вона змінить.

Як під'єднати Claude, Cursor чи Codex до вашого Mac

1. Відкрийте OneMacTools і виберіть OneMacTools › Параметри (⌘,).
2. Прокрутіть до ШІ-асистенти й увімкніть Дозволити ШІ-асистентам використовувати OneMacTools.
3. Натисніть Додати до Claude Desktop… (або Claude Code, Cursor чи Codex).
4. Прочитайте підтвердження: «OneMacTools додає запис “onemactools” до … після створення резервної копії файлу. Більше нічого в ньому не змінюється». Клацніть Додати.
5. Тепер у рядку видно Додано із зеленою позначкою, а рядок під розділом підказує, що робити далі, наприклад «Закрийте й знову відкрийте Claude, щоб завантажити його». Якщо файл уже існував, там також названо файл резервної копії.
6. Перезапустіть або перезавантажте асистента, як описано, а потім попросіть його про щось на кшталт «Скористайся OneMacTools і скажи, як почувається мій Mac».

Додавання до асистента також вмикає Дозволити ШІ-асистентам використовувати OneMacTools, якщо це було вимкнено. Якщо ви перемістите OneMacTools в іншу папку, натисніть Оновити поруч з асистентом, щоб запис указував на нове розташування програми.

Ручне налаштування MCP для інших асистентів

Для будь-якого іншого асистента, що підтримує MCP через stdio, натисніть Скопіювати фрагмент налаштування поруч з Інші асистенти і вставте його в налаштування MCP цього асистента. Фрагмент — це той самий запис, який OneMacTools записує для Claude і Cursor:

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

Команда — це шлях до програми на вашому Mac, тож скопійований фрагмент завжди має правильний шлях, навіть якщо OneMacTools зберігається не в папці «Програми». Для Claude Code запис також містить "type": "stdio". Codex використовує TOML замість JSON, тож його запис — це таблиця:

[mcp_servers.onemactools], а за ним command = "/Applications/OneMacTools.app/Contents/MacOS/OneMacTools" і args = ["--mcp"].

OneMacTools розпізнає асистента за назвою, коли той підключається, і показує цю назву у вікнах схвалення та в Історії: Claude, Claude Code, Cursor, Codex, Windsurf, Gemini CLI чи VS Code або назву, яку повідомляє сам асистент.

Що асистент може читати без запиту

Інструменти читання відповідають одразу, бо вони лише переглядають. Для асистента вони позначені як лише для читання:

Підсумки паперів ніколи не містять номерів документів, карток чи рахунків; life_admin повідомляє лише, скільки файлів їх містить, і їхні назви. Читання справжнього тексту документа — це дія, і на неї завжди потрібен дозвіл. Докладніше — у статті Дозволи й схвалення для ШІ-асистентів. Інструменти на основі Файлів залежать від Файлів і Документів.

Про що асистент має вас запитати

Ці інструменти щось змінюють, тож кожен відкриває в OneMacTools вікно схвалення й чекає, доки ви клацнете Дозволити:

• run_tool: запустити будь-який інструмент OneMacTools для файлів чи тексту з параметрами. Результати потрапляють у нову папку; оригінали не змінюються. Інструменти, яким потрібна ваша присутність за Mac, як-от «Запис екрана» чи «Запис зустрічі», асистент запустити не може.
• quit_app: закрити програму звичайним способом, щоб вона могла запропонувати зберегти дані. Finder так закрити не можна.
• stop_process і stop_agent_session: зупинити один із ваших власних процесів або сеанс ШІ-агента разом з усім, що він запустив.
• stop_container: зупинити запущений контейнер Docker.
• start_recording і stop_recording: посекундно записати роботу Mac, а потім дізнатися, що досягало піку і які програми за цим стояли.
• read_document: передати асистенту текст одного документа.
• move_to_trash: перемістити файли з вашої домашньої папки в Смітник, але ніколи не видаляти їх.

Приклади запитів

• «Чому мій Mac зараз повільний?» (використовує mac_health і list_apps)
• «Що працює на порту 5173 і який проєкт це запустив? Зупини його». (читає за допомогою whats_on_port, потім просить stop_process)
• «У яких моїх проєктах є старі папки node_modules і скільки місця я поверну?»
• «Записуй роботу мого Mac, поки я запускаю це збирання, а потім скажи, що досягало піку».
• «Знайди PDF, які я завантажив із Gmail цього тижня, і об'єднай їх». (шукає за допомогою find_files, потім просить run_tool)
• «Скільки я витратив в Amazon минулого місяця?» (потрібні Файли)
• «Стисни ці три знімки екрана в JPEG». (run_tool зі «Стисненням зображень»)

Загальні відомості про порти й агентів — у посібнику Що використовує порт на моєму Mac? і в документації «Розробка й агенти».

Як вимкнути MCP-сервер

Вимкніть Дозволити ШІ-асистентам використовувати OneMacTools у Параметри › ШІ-асистенти. Асистенти, у яких ще є запис, можуть запустити сервер, але кожне читання й кожна дія отримають лише відповідь «OneMacTools не пускає ШІ-асистентів».

Щоб повністю вилучити OneMacTools з асистента, видаліть запис onemactools з його файлу налаштувань (шляхи наведено в таблиці вище) або відновіть резервну копію, яку створив OneMacTools. Закриття асистента також завершує процес сервера.

Запитання

Пов'язані статті