Сім запитань, які варто поставити перед запуском локального сервера MCP
Чек-лист для ізоляції локальних серверів MCP у сандбоксі, розроблений на сервері GitHub: токени короткого терміну дії, ізольована мережа, список дозволених виходів та фіксовані списки інструментів.
Джерела: the seven questions i ask before running a local mcp server — part 2
Встановлення локального сервера MCP зазвичай означає вставку фрагмента коду у файл конфігурації:
{
"mcpServers": {
"some-tool": { "command": "npx", "args": ["-y", "some-mcp-server"] }
}
}
Це три рядки коду без жодного огляду, без діалогового вікна з запитом на дозволи та без кроку встановлення, про який хтось насправді думає. Варто зупинитися та зрозуміти, що роблять ці рядки. Локальний сервер MCP — це не сервіс. У нього немає порту, немає процедури входу та немає меж. Це програма, яку агент запускає, вона працює від імені поточного користувача та має доступ до його файлів та середовища. Вікно з запитом на дозволи, яке відображає агент, пояснює, що робить агент, тоді як програма, яка виконується під час виклику інструменту, вже має повний контроль над машиною.
Кращою практикою є поставити сім запитань перед встановленням та дозволити відповідям визначити конфігурацію.
Сім запитань
- Чи працює воно локально? Віддалені сервери MCP знаходяться на машині сторонньої організації та не можуть бути інтегровані повністю, через що решта пунктів списку втрачають значення. Іноді це є рішенням, а не обов’язковою умовою, і ретельний вибір між віддаленим та локальним варіантом може зробити інші шість запитань зайвими.
- Чи потрібні для цього облікові дані? Або їх зовсім не потрібно, або потрібні конкретні дані, які можна вказати.
- До чого воно підключається? Або до короткого, фіксованого списку хостів, або до будь-якого URL.
- Які файли йому потрібні? Один робочий простір, усе або нічого.
- Чи потрібно ще щось від хоста? Сеанс робочого столу, сокет, браузер.
- Чи виконує воно код, який завантажує? Якщо так, цей код потрібно зафіксувати.
На запитання від одного до шести можна відповісти за допомогою власної документації сервера приблизно за десять хвилин, без необхідності пошуку в джерелах. Лише до сьомого запитання є конкретні дані: після встановлення достатньо одного виклику tools/list, і кількість інструментів зазвичай перевищує очікування.
Приклад: сервер GitHub
| Запитання | Відповідь для сервера GitHub |
|---|---|
| Працює локально? | Так, і вже постачається у вигляді образу контейнера |
| Облікові дані | Необхідні, оскільки приватні репозиторії не можна читати анонімно |
| Підключається до | Одного хоста – api.github.com |
| Файли | Нічого окрім ключа. Робота відбувається через API, тому на диску немає жодних копій чи файлів типу checkout |
| Інші вимоги до хоста | Нічого |
| Завантаження коду під час виконання | Ні |
| Список інструментів | Можна скоротити за допомогою --toolsets та --exclude-tools |
Усі ці відповіді разом описують конфігурацію: один обліковий запис, жодної підключеної папки, єдиний пункт призначення та список інструментів, який потрібно скоротити.
Обліковий запис є складнішою частиною, оскільки його неможливо видалити з архітектури. Якщо агент створює запити на збір коду, він має мати права на запис. Натомість використовуються захисні механізми, які починаються з використання GitHub App замість особистого токена доступу:
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--network",
"mcp-egress-github",
"--read-only",
"--tmpfs",
"/tmp",
"--cap-drop",
"ALL",
"--security-opt",
"no-new-privileges",
"--user",
"10001:10001",
"--log-driver",
"journald",
"-e",
"HTTPS_PROXY=http://mcp-egress-proxy:3128",
"-e",
"HTTP_PROXY=http://mcp-egress-proxy:3128",
"-v",
"/home/<user>/.config/mcp-gh/<app>.private-key.pem:/key.pem:ro",
"ghcr.io/github/github-mcp-server@sha256:508a0857ec762b1ab1cece29193345b501fab1dd9d1228a7b617062954cecac6",
"stdio",
"--app-id",
"NNNNNNN",
"--app-installation-id",
"NNNNNNNNN",
"--app-private-key-path",
"/key.pem",
"--toolsets",
"context,issues,pull_requests,repos",
"--exclude-tools",
"create_repository,fork_repository,get_teams,get_team_members,list_repository_collaborators"
]
}
}
}
Шари навколо цього сертифіката
- Короткострокові токени. Додаток GitHub створює токени, які швидко закінчують свою дію.
- Читальний режим підключення. Ключ для підпису підключається у читальному режимі та належить UID, до якого мапується контейнер, а не користувачу. Він не знаходиться у
~/.ssh, де він би вже не був SSH-ключем та не міг би читатися користувачем. - Контейнери без привілеїв. Демон Docker працює у режимі без root, процес використовує користувача, який не є root, і жодні привілеї не надаються.
- Один репозиторій, чотири права доступу. Для
contents,issuesтаpull_requestsпередбачений запис, дляmetadata— лише читання, і кожен створений токен має саме ці права. - Закрита мережа. Не існує прямого шляху назовні, тому єдиним способом є використання проксі.
- Список дозволених виходів. Усе, що створюється всередині контейнера, може бути надіслане лише на
api.github.com. - Фіксовані набори інструментів та інструменти, які виключаються. Параметр
--toolsetsблокує цілі групи, а--exclude-toolsвидаляє все, що залишилося всередині збережених груп.
Останні два підходи отримують мало уваги. Обмеження списку інструментів є найменшим привілеєм, який все ще дозволяє доступ до запису. Список дозволів захищає не лише локальні файли, адже він обмежує місця, де можуть бути використані вкрадені облікові дані.
Це твердження потребує підтвердження. За допомогою --toolsets context,issues,pull_requests,repos сервер надає доступ до 42 інструментів. П’ять з них не можна використовувати з цими правами. Після використання параметра --exclude-tools залишається 37 інструментів, з яких 15 дозволяють виконувати операції запису. Оскільки параметр --toolsets обирає цілі групи, параметр repos також включає функції create_repository та fork_repository, незалежно від того, чи може токен їх використовувати. 37 – це не мало число, але воно є точним, і саме так виглядає принцип мінімальних привілеїв, коли агент дійсно мусить додати гілку.
Чому список дозволених інструментів не є надмірним
Спочатку здається, що список дозволених адрес занадто великий, поки хтось не запитає, що він запобігає. Ніхто не може змусити контейнер встановити зв’язок з attacker.com, тож токен, створений у ньому, не має куди переміститися в вороже середовище. Журнал проксі фіксує обидва результати кожної спроби:
10.123.2.3 TCP_TUNNEL/200 CONNECT api.github.com:443 HIER_DIRECT/140.82.121.6
10.123.2.3 TCP_DENIED/403 CONNECT example.com:443 HIER_NONE/-
Флаг -e HTTPS_PROXY не є тим елементом, який це забезпечує. У Linux немає вбудованого поняття проксі — ні параметра ядра, ні хука бібліотеки libc. Ця змінна є лише текстом у середовищі, і кожен HTTP-клієнт сам вирішує, чи буде її дотримуватися. Бібліотека net/http у Go її дотримується, тому цьому конкретному серверу не потрібні додаткові дії. Вбудована функція fetch у Node її не дотримується, що означає, що сервер Node повністю ігноруватиме це налаштування. Захист забезпечує сама структура мережі: за відсутності вихідного маршруту клієнт, який ігнорує цю змінну, не підключається безпосередньо, а просто видає помилку. У мережі з маршрутом така неуважність може призвести до витоку трафіку без жодних попереджень.
Перевірка відповідності OWASP MCP Top 10
Запис цієї конфігурації у списку OWASP MCP Top 10 позначає кожен ризик як вирішений, залишковий та під контролем, як невирішений, або як нестосовний до локального сервера stdio, з примітками щодо того, що залишається нерозв’язаним.
Що все ще не входить у сферу дії
Жоден сендбокс ніколи не є повним. Є три аспекти, які зовсім не враховуються в цій конфігурації: віддалені сервери MCP, сервери, які завантажують довільні URL, та сама модель.
Після цього моменту проблема вже не є просто забутим параметром. Усі ці заходи застосовуються до кожного контейнера, їх потрібно вводити вручну та дублювати для кожного доданого сервера. Три сервери вимагають трьох списків дозволів та трьох рядків інструментів, причому жоден компонент не спостерігає за сеансом в цілому.
Відсутнім є шлюз, розташований між агентом та його серверами. Шлюз може повністю видалити інструмент з list_tools та ще раз перевірити кожен запит перед передачею, тож список інструментів оновлюється за кожною сесією, а не за кожним файлом конфігурації. Він все одно не може спостерігати за поведінкою запущеного сервера: відкриті файли, звернення до хостів, читання облікових даних. Уразливий сервер не потребує використання інструментів для надсилання ключів кудись ще. Шлюз додає ще один рівень та не видаляє жодних існуючих.
Правила, які застосовуються до будь-якого локального сервера
Вищенаведені відповіді належать GitHub. Правила, які вони формулюють, застосовуються до будь-якого локального сервера, який збираються додати до файлу конфігурації:
- Використовуйте облікові дані, термін дії яких закінчується. Додаток GitHub є кращим варіантом, ніж особистий токен доступу. Контейнер зберігає ключ підпису та створює новий токен для кожного використання, і цей токен автоматично втрачає чинність, замість того щоб чекати, поки хтось його скасує.
- Визначайте обмеження дозволів, а не лише облікові дані. Один репозиторій та чотири дозволи — кожен токен містить саме їх.
- Забезпечте захист мережі. Оскільки немає готових маршрутів, проксі не є параметром, який сервер може відхилити, на відміну від
-e HTTPS_PROXY, який є лише запитом. - Створіть список дозволених адрес. Один хост —
api.github.com. Облікові дані, вкрадені з цього контейнера, не можна використовувати в інших місцях, а кожна спроба записується у журналі у будь-якому разі.
--user 10001, видаліть можливості за допомогою --cap-drop ALL, додайте --security-opt no-new-privileges та монтуйте файлову систему у режимі --read-only із використанням tmpfs для тимчасових файлів./key.pem:ro — без робочого простору. Підключення $HOME до контейнера не вважається механізмом ізоляції.--toolsets виключає певні групи інструментів, а --exclude-tools видаляє ті, що залишилися, що зменшує кількість інструментів на сервері з 42 до 37; з них 15 все ще можуть виконувати операції запису.latest, а також тегів версій, оскільки їх можна змінити. Обидва зображення в цій конфігурації, включаючи проксі, використовують формат @sha256:…, тому вони не можуть змінитися під час роботи.Жодне окреме правило не визначає, чи виникне пошкода. Отруєний документ все одно може переконати агента здійснити виклик інструменту. Кожне правило обмежує радіус поширення «вибуху», але жодне з них не фіксує механізм запуску. Сандбокс контролює те, де програма може взаємодіяти, але не те, що вона каже.
Список дозволених значень ілюструє цю межу. Він перевіряє, що трафік надходить на api.github.com, але нічого не розкриває про зміст. Параметр contents: write дозволяє агенту створювати гілки, а також дозволяє вставленій інструкції зберігати файли. Назви гілок, повідомлення про збереження та назви проблем здаються нормальними окремо, але разом вони можуть приховати будь-що у репозиторії, який інші можуть прочитати. Будь-який фільтр, достатньо перепустливий для роботи агента, дозволяє дані виходити, оскільки сама робота полягає у читанні та записі на GitHub.
Тож сприймайте все це як початковий етап, а не кінцеву мету, і спочатку впровадіть його. Це коштує семи запитань, близько десяти хвилин на читання та одного виклику tools/list. Натомість ви отримуєте конфігурацію, яку можна захистити, тоді як раніше там просто копіювали три рядки без роздумів.
Пов’язана література
- Забезпечення безпеки інструментів MCP із підтримкою запису: сім рівнів захисту окрім токена — Чому токен MCP не надає дозволу на запис данних, та сім рівнів контролю, розділення облікових даних, схвалення конкретних запитів та правила повторних спроб, які це забезпечують.
- Практичні нотатки: Microsoft створив сервер MCP для Playwright, а потім сказав вам це зробити — Детальний огляд практичних нотаток: Microsoft створив сервер MCP для Playwright, а потім сказав вам це зробити: контракти, перевірки та готові фрагменти коду для команд, які використовують цю модель.