Що таке MCP: підключаємо Claude Code до зовнішнього світу

Claude Code за замовчуванням має чіткі межі: читати й писати локальні файли, виконувати команди у терміналі, використовувати вбудовані інструменти. Але реальні проєкти вимагають більшого — запити до бази даних, читання документів Notion, пошук по Slack, виклик внутрішніх API.

MCP якраз вирішує цю проблему.

Що таке MCP

MCP (Model Context Protocol) — відкритий протокол від Anthropic, що визначає, як AI-моделі спілкуються із зовнішніми інструментами та джерелами даних. Найпростіше уявити це як встановлення плагінів для Claude Code: кожен MCP Server — незалежний сервіс, що надає набір інструментів, які Claude може викликати напряму під час сесії.

На відміну від Hooks (які запускають скрипти, коли Claude виконує певну дію), MCP активно розширює межі можливостей Claude: що підключиш — тим Claude і зможе керувати.

Як це працює

Архітектура проста:

Claude Code (Client)  ←→  MCP Server  ←→  Зовнішня система

Ви оголошуєте MCP Server у конфігурації (локальний процес або віддалений сервіс)
При запуску Claude Code підключається до цього Server і отримує список доступних інструментів
Під час сесії Claude може викликати ці інструменти так само, як вбудовані Read/Write/Bash
MCP Server обробляє запит і повертає результат Claude

Весь процес прозорий для користувача. Ви бачите, як Claude каже «зараз перевірю в базі» та повертає відповідь — MCP перенаправляє запити у фоні.

Три типи можливостей MCP

MCP Server може надавати три речі:

Tools (інструменти)
Функції, які Claude може викликати активно — «запит до таблиці users», «пошук по документах», «надіслати повідомлення у Slack». Найпоширеніший тип, покриває 90% реальних сценаріїв.

Resources (ресурси)
Структуровані дані, які Claude читає як контекст — схема бази даних, документація API, конфігураційні файли.

Prompts (шаблони промптів)
Наперед визначені фрагменти промптів, які користувачі можуть викликати напряму.

На практиці ви майже завжди будете працювати з Tools.

Швидкий старт: додаємо готовий MCP Server

На прикладі офіційного Filesystem MCP — цей Server надає Claude доступ до файлової системи поза межами робочого каталогу.

Встановлення

npm install -g @modelcontextprotocol/server-filesystem

Налаштування

Відредагуйте ~/.claude/settings.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents"
      ]
    }
  }
}

Перевірка

Перезапустіть Claude Code і спробуйте:

Перелічи всі PDF-файли в /Users/yourname/Documents

Якщо Claude поверне список замість «я не можу отримати доступ до файлової системи» — MCP працює.

Структура конфігурації

{
  "mcpServers": {
    "назва-сервісу": {
      "command": "команда запуску",
      "args": ["список аргументів"],
      "env": {
        "API_KEY": "xxx"
      }
    }
  }
}

command + args: команда, якою Claude Code запускає процес MCP Server
Назва сервісу — просто локальна мітка, називайте як зручно
env використовуйте для API-ключів і чутливих налаштувань; не хардкодьте їх у коді

Де зберігати конфігурацію

Конфігурація MCP може зберігатися у трьох місцях, у порядку зростання пріоритету:

Місце	Файл	Коли використовувати
Глобальна	`~/.claude/settings.json`	Інструменти для всіх проєктів
Рівень проєкту	`.claude/settings.json`	Інструменти лише для цього проєкту
Локальне перевизначення	`.claude/settings.local.json`	Особисті налаштування, не комітяться в git

Для підключень до баз даних і внутрішніх API використовуйте конфігурацію проєкту та комітьте її разом з кодом. Члени команди, що клонують репозиторій, автоматично отримають те саме середовище MCP.

Де знайти готові MCP Server

Anthropic підтримує набір офіційних серверів:

@modelcontextprotocol/server-filesystem — доступ до файлової системи
@modelcontextprotocol/server-github — операції GitHub (PR, issue, пошук по коду)
@modelcontextprotocol/server-postgres — запити до PostgreSQL
@modelcontextprotocol/server-slack — читання й надсилання повідомлень у Slack
@modelcontextprotocol/server-google-maps — карти та геодані

Спільнота створила безліч сторонніх реалізацій: Notion, Linear, Jira, різноманітні бази даних.

MCP vs Hooks: що обрати

	Hooks	MCP
Спрацьовує	Коли Claude виконує конкретну дію	Коли Claude активно викликає інструмент
Призначення	Перехоплення або поліпшення наявної поведінки	Додавання нових можливостей
Типові сценарії	Форматування при збереженні, перевірка перед комітом	Запит до БД, виклик зовнішнього API
Складність налаштування	Низька	Середня

Вони доповнюють одне одного. Hooks керують тим, як Claude працює; MCP керує тим, що Claude може робити.

Що далі

Ця стаття — концептуальний вступ до MCP. Наступні матеріали покриватимуть:

Підключення Claude Code до реальної бази PostgreSQL із реальною схемою
Підключення внутрішніх інструментів та API
Написання власного MCP Server з нуля

Якщо у вас вже є система, яку треба підключити, спершу перевірте список MCP Server — швидше за все, хтось вже написав те, що потрібно.