Apple Files — MCP-сервер для Claude Code: установка
MCP-сервер даёт агенту доступ к локальным файлам и папкам macOS внутри разрешённых корней. Подходит для просмотра и управления файлами из чата.
claude mcp add --env APPLE_FILES_MCP_SAFETY_MODE=<APPLE_FILES_MCP_SAFETY_MODE> --env APPLE_FILES_MCP_ALLOWED_ROOTS=<APPLE_FILES_MCP_ALLOWED_ROOTS> --transport stdio applefiles-mcp -- uvx apple-files-mcpЧто делает Apple Files
Apple Files подключает к MCP-клиенту операции с локальными файлами и папками. Доступ ограничен значениями APPLE_FILES_MCP_ALLOWED_ROOTS, а режим безопасности задаётся через APPLE_FILES_MCP_SAFETY_MODE. Сервер работает через uvx apple-files-mcp и использует транспорт stdio.
Для запуска нужны macOS, Python 3.11+ и установленный uv. Без macOS и Python 3.11+ сервер не запустится. Даже разрешённые каталоги могут дополнительно ограничиваться macOS, поэтому корни доступа стоит выбирать осознанно.
Какие задачи решает
- просматривать файлы в разрешённых каталогах
- управлять локальными папками через MCP-клиент
- ограничивать доступ сервера списком корней
- задавать режим безопасности для файловых операций
Примеры запросов агенту
- Покажи содержимое разрешённых папок и найди в них файл с конфигурацией.
- Проверь доступность файлового сервера через
files_health. - Создай папку для отчётов внутри разрешённого корня и перечисли её файлы.
Как установить Apple Files
Командой платформы
claude mcp add --env APPLE_FILES_MCP_SAFETY_MODE=<APPLE_FILES_MCP_SAFETY_MODE> --env APPLE_FILES_MCP_ALLOWED_ROOTS=<APPLE_FILES_MCP_ALLOWED_ROOTS> --transport stdio applefiles-mcp -- uvx apple-files-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-files-mcp <команда>
Командой платформы
codex mcp add applefiles-mcp --env APPLE_FILES_MCP_SAFETY_MODE=<APPLE_FILES_MCP_SAFETY_MODE> --env APPLE_FILES_MCP_ALLOWED_ROOTS=<APPLE_FILES_MCP_ALLOWED_ROOTS> -- uvx apple-files-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-files-mcp <команда>
Файл настроек
{
"mcpServers": {
"applefiles-mcp": {
"command": "uvx",
"args": [
"apple-files-mcp"
],
"env": {
"APPLE_FILES_MCP_SAFETY_MODE": "<APPLE_FILES_MCP_SAFETY_MODE>",
"APPLE_FILES_MCP_ALLOWED_ROOTS": "<APPLE_FILES_MCP_ALLOWED_ROOTS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-files-mcp <команда>
Файл настроек
{
"servers": {
"applefiles-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-files-mcp"
],
"env": {
"APPLE_FILES_MCP_SAFETY_MODE": "<APPLE_FILES_MCP_SAFETY_MODE>",
"APPLE_FILES_MCP_ALLOWED_ROOTS": "<APPLE_FILES_MCP_ALLOWED_ROOTS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-files-mcp <команда>
Командой платформы
gemini mcp add -e APPLE_FILES_MCP_SAFETY_MODE=<APPLE_FILES_MCP_SAFETY_MODE> -e APPLE_FILES_MCP_ALLOWED_ROOTS=<APPLE_FILES_MCP_ALLOWED_ROOTS> applefiles-mcp uvx apple-files-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-files-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Files
Как установить Apple Files в Claude Code?
Установите uv, затем выполните claude mcp add apple-files-mcp -- uvx apple-files-mcp. После установки перезапустите Claude Code.
Что делает Apple Files?
Сервер позволяет MCP-клиенту просматривать и изменять локальные файлы и папки macOS в пределах разрешённых корней.
Какие настройки нужны для доступа к файлам?
Задайте APPLE_FILES_MCP_ALLOWED_ROOTS для разрешённых каталогов и APPLE_FILES_MCP_SAFETY_MODE для режима безопасности. macOS может запросить дополнительные разрешения.
