Ключ, вписаний в env
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_…" } тримає ключ відкритим текстом у файлі в твоїй теці. Звично, і варто перенести.
AI-агенти для коду · Claude Desktop
Які MCP-сервери запускає Claude Desktop і до чого вони дістаються
Кожен сервер у claude_desktop_config.json стартує разом з апкою і працює з правами твого облікового запису. Claude питає, перш ніж скористатися інструментом; сам сервер уже працює.
claude_desktop_config.json −ключ у файлі+ключ зі сховища−"command": "npx", "args": ["-y", "example-mcp-server"],−"env": { "EXAMPLE_API_KEY": "sk-••••••" }+"command": "/Users/you/bin/example-mcp"
Де Claude Desktop тримає MCP-сервери
Claude › Settings › Developer › Edit Config відкриває файл. Після змін повністю закрий апку.
| Рівень | Файл | Що там |
|---|---|---|
| Локальні сервери | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)%APPDATA%\Claude\claude_desktop_config.json (Windows)~/.config/Claude/claude_desktop_config.json (Linux) | mcpServers: кожен з command, args і env. |
| Розширення | Settings › Extensions | Сервери .mcpb в один клік; чутливі поля йдуть у сховище ключів ОС. |
| Віддалені конектори | Customize › Connectors | Їх викликає хмара Anthropic, а не твій комп'ютер. |
| Політика адміна | com.anthropic.claudefordesktop (macOS)HKLM:\SOFTWARE\Policies\Claude (Windows) | Може вимкнути локальні MCP-сервери й розширення. |
Шість речей для перевірки
Ключ в args чи адресі
"--token", "…" в args, ?api_key= в URL або user:pass@host.
Запускач без точної версії
npx -y some-mcp-server запускає те, що реєстр віддасть того дня. Зафіксуй @1.2.3.
Гола назва команди
"command": "npx" запускає те, що першим знайдеться в PATH. Документація MCP радить повний шлях.
Команда, що завантажує й запускає код
bash -c "curl … | sh", node -e "…" або скрипт у /tmp.
Широкі теки для файлового сервера
@modelcontextprotocol/server-filesystem з /Users/you чи /: Claude може читати й змінювати все там.
Тримай ключ у сховищі
Документація Claude Desktop не описує ${VAR} у цьому файлі, тож запускай сервер через маленький скрипт (macOS; збережи ключ один раз: security add-generic-password -a "$USER" -s EXAMPLE_API_KEY -w).
{
"mcpServers": {
"example": { "command": "/Users/you/bin/example-mcp" }
}
}
# /Users/you/bin/example-mcp (chmod +x)
#!/bin/sh
EXAMPLE_API_KEY="$(/usr/bin/security find-generic-password -s EXAMPLE_API_KEY -w)" || exit 1
export EXAMPLE_API_KEY
exec npx -y example-mcp-server@1.2.3 Ключ іде з відкритого конфігу в login Keychain, конфіг запускає одну програму за повним шляхом, а версія пакета зафіксована. Якщо сервер є як розширення, встановлення розширення тримає чутливі поля у сховищі без скрипта.
Або перевір усе одразу
Для Claude Desktop NeuroShield читає claude_desktop_config.json: ключі в env, args і URL, пакети без версії, голі команди, завантаження й відомі ризикові сервери. Кожен сервер - картка, яку можна вимкнути, з Undo.
Лише читає
Читає файли налаштувань і ніколи не запускає агентів, їхні MCP-сервери чи скрипти.
Нічого не покидає комп'ютер
Перевірка йде локально. Без акаунта, без завантаження, без AI всередині: фіксовані опубліковані правила.
Нічого не змінюється без твого «ок»
Де є безпечне виправлення, Fix It for Me робить його після підтвердження, з копією і Undo.
Питання
Де claude_desktop_config.json?
macOS ~/Library/Application Support/Claude/, Windows %APPDATA%\Claude\, Linux ~/.config/Claude/. Або Settings › Developer › Edit Config.
Безпечно класти API-ключ в env?
Працює, і офіційні приклади так роблять, але ключ лежить у файлі відкритим текстом.
MCP-серверу потрібен мій дозвіл, щоб торкатися файлів?
Claude питає, перш ніж скористатися інструментами сервера. Сам сервер стартує з апкою і може робити з файлами все, що можеш ти.
Подивись на своїх агентів
Перевірка безкоштовна: скільки в тебе агентів і що вони можуть. Деталі й виправлення - у Shields.