MCP у Claude Code. Як додати сервер однією командою і кому дати до нього доступ
Що таке MCP, як підключити сервер командою claude mcp add, чим відрізняються області local, project і user, що робить файл .mcp.json і команда /mcp.
Частина посібникаClaude Code, повний посібник. Від встановлення до власних скілів і плагінів
У цьому тексті
Коротко
MCP це відкритий стандарт, через який Claude Code підключається до зовнішніх інструментів, баз даних і API. Сервер додають командою claude mcp add, а область local, project або user визначає, хто його бачить і в яких проєктах. Команда /mcp показує стан підключень і дає змогу увійти на сервер.
Програміст копіює задачу з трекера в Claude Code, потім вставляє помилку із системи моніторингу, потім відповідь з бази. Anthropic описує саме цей момент як сигнал підключити сервер MCP. Тоді Claude сам читає задачу і сам перевіряє базу, а не працює з тим, що хтось вставив.
Сторінка входить до путівника по Claude Code. Команди ми звірили з документацією MCP для Claude Code, станом на 10 листопада 2026.
Що таке MCP у Claude Code
MCP, тобто Model Context Protocol, це відкритий стандарт підключення інструментів AI до зовнішніх систем. Сервер MCP це невелика програма або сервіс, що дає Claude набір інструментів, наприклад читання задач, запити до бази або чернетки листів. Claude Code тут клієнт, який цими інструментами користується.
Сервер може працювати в хмарі постачальника, і тоді ви підключаєтеся до нього через інтернет. Може й працювати на вашому комп'ютері як локальний процес. Від цього залежить, яку команду ви використаєте. У чаті Claude схожу роль виконують конектори, про які ми пишемо в тексті про підключення AI до календаря.
Команда claude mcp add
Команди вводять у звичайному терміналі, а не у вікні Claude Code. Віддалений сервер додають через HTTP. Anthropic радить цей спосіб для хмарних сервісів.
claude mcp add --transport http notion https://mcp.notion.com/mcpЯкщо сервер вимагає ключ у заголовку, його додають прапорцем --header.
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header "Authorization: Bearer YOUR_GITHUB_PAT"Локальний сервер працює як процес на вашому комп'ютері і використовує транспорт stdio. Два дефіси відділяють опції Claude Code від команди, яка запускає сервер. Усе після них іде до сервера без змін.
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
--dsn "postgresql://readonly:pass@localhost:5432/shop"Старіший транспорт SSE поступово виводять з ужитку. Починаючи з версії 2.1.265, команда з --transport http сама переходить на SSE, коли сервер не приймає HTTP. Сервери WebSocket додають лише через claude mcp add-json або файл .mcp.json.
Області local, project і user
Кожен сервер має область. Її вибирають прапорцем --scope, а типова область local.
| Область | Де працює | Хто бачить | Де записана |
|---|---|---|---|
local | Лише в поточному проєкті | Лише ви | ~/.claude.json |
project | Лише в поточному проєкті | Команда через репозиторій | .mcp.json у проєкті |
user | В усіх ваших проєктах | Лише ви | ~/.claude.json |
Сервер з ключем до вашого акаунта краще тримати в local або user. Область project записує файл .mcp.json, який потрапляє в репозиторій, тож уся команда отримує ті самі інструменти.
{
"mcpServers": {
"api-server": {
"type": "http",
"url": "https://api.example.com/mcp",
"headers": {
"Authorization": "Bearer ${API_KEY}"
}
}
}
}Запис ${API_KEY} це змінна середовища. Ключ лишається на комп'ютері кожної людини, а в репозиторій іде лише назва змінної. Коли той самий сервер записаний у кількох областях, перемагає local, потім project, потім user.
Команда /mcp і керування серверами
У терміналі claude mcp list показує всі сервери зі станом підключення, claude mcp get назва деталі одного, а claude mcp remove назва видаляє сервер. Команда claude mcp add зберігає конфігурацію без перевірки ключа, тому неправильний токен виявиться лише під час підключення.
У самому Claude Code вводять /mcp. Панель показує, які сервери підключені, а які чекають на вхід. Багато хмарних серверів використовують вхід через OAuth, і саме тут ви його завершуєте, у браузері. У панелі можна також вимкнути сервер, не видаляючи його конфігурацію.
Якщо ви входите в Claude Code акаунтом claude.ai, конектори, додані в claude.ai, з'являться в /mcp самі. На планах Team і Enterprise конектори в claude.ai додають лише адміністратори.
На що зважати
Anthropic прямо пише, що перед підключенням треба переконатися, що ви довіряєте серверу. Сервер, який бере вміст з інтернету, може принести prompt injection, тобто команду, приховану в даних, яку Claude сприйме як інструкцію.
Базу даних підключайте через користувача лише для читання, як у прикладі з DBHub у документації. Тоді запит, який запустить Claude, не змінить даних.
Сервери з файлу .mcp.json у звичайній сесії потребують вашої згоди під час першого запуску. Вибір можна скинути командою claude mcp reset-project-choices. У режимі claude -p і в частині хмарних сесій такого питання нема, і сервери з проєкту завантажуються одразу, про це в тексті про Claude Code у скриптах і CI. Наступний крок це хуки, які можуть реагувати й на інструменти із серверів MCP.
Почніть з однієї системи, з якої ви сьогодні найчастіше копіюєте дані вручну, і підключіть її в області local. Якщо хочете знати, які системи у вашій фірмі варто поєднати з AI, замовте безкоштовний аудит AI.
Що хочете змінити у своїй фірмі?
Залиште номер. Поговоримо про ваш процес і перевіримо, чи можемо допомогти. Перша розмова безкоштовна.
Послуга, про яку цей текст
Автоматизація та AI / OCRАвтоматизація переписування документів, OCR і правила перевірки, а дані лишаються у вас.