1~
2**Model Context Protocol (MCP)**  -  це відкритий стандарт, створений Anthropic, який визначає, як AI-моделі взаємодіють із зовнішніми інструментами, джерелами даних та сервісами. Уявіть собі це як "USB-C для AI"  -  універсальний конектор, який дозволяє будь-якому AI-агенту спілкуватися з будь-яким інструментом через стандартизований інтерфейс.
3~
4З моменту запуску MCP перевищив **97 мільйонів щомісячних завантажень SDK** і був прийнятий усіма основними постачальниками AI: Anthropic, OpenAI, Google, Microsoft та Amazon. У цьому посібнику ми розглянемо все, що вам потрібно знати для роботи з MCP.
5~
6## Чому MCP існує
7~
8До MCP кожен AI-додаток мав створювати власні інтеграції для кожного інструменту, який хотів використовувати. Хочете, щоб ваш AI читав файли? Пишіть власний код. Робити запити до бази даних? Ще більше власного коду. Публікувати в Slack? Ще одна інтеграція.
9~
10Це створювало **проблему N×M**: N AI-додатків, кожному з яких потрібно M власних інтеграцій, що призводило до дублювання зусиль та фрагментації екосистем.
11~
12```mermaid
13graph TD
14    subgraph "Before MCP (N×M)"
15        A1[AI App 1] --> T1[GitHub Integration]
16        A1 --> T2[Slack Integration]
17        A1 --> T3[DB Integration]
18        A2[AI App 2] --> T4[GitHub Integration]
19        A2 --> T5[Slack Integration]
20        A2 --> T6[DB Integration]
21    end
22```
23~
24MCP вирішує це за допомогою **єдиного протоколу**, який будь-який AI-клієнт може використовувати для зв'язку з будь-яким MCP-сервером:
25~
26```mermaid
27graph TD
28    subgraph "With MCP (N+M)"
29        A1[AI App 1] --> MCP[MCP Protocol]
30        A2[AI App 2] --> MCP
31        MCP --> S1[GitHub Server]
32        MCP --> S2[Slack Server]
33        MCP --> S3[DB Server]
34    end
35```
36~
37## Основні концепції
38~
39MCP має три фундаментальні примітиви:
40~
41### 1. Інструменти (Tools)
42Інструменти  -  це функції, які AI може викликати. Вони представляють дії на кшталт "створити файл", "запитати базу даних" або "надіслати повідомлення". Кожен інструмент має назву, опис та JSON Schema для своїх параметрів.
43~
44```typescript
45{
46  name: "create_issue",
47  description: "Create a new GitHub issue",
48  inputSchema: {
49    type: "object",
50    properties: {
51      title: { type: "string", description: "Issue title" },
52      body: { type: "string", description: "Issue body" },
53      repo: { type: "string", description: "Repository name" }
54    },
55    required: ["title", "repo"]
56  }
57}
58```
59~
60### 2. Ресурси (Resources)
61Ресурси  -  це дані, які AI може читати. Вони представляють файли, записи бази даних, відповіді API або будь-яке інше джерело даних. Ресурси ідентифікуються за URI.
62~
63```typescript
64{
65  uri: "file:///Users/dev/project/README.md",
66  name: "Project README",
67  mimeType: "text/markdown"
68}
69```
70~
71### 3. Промпти (Prompts)
72Промпти  -  це багаторазові шаблони, які допомагають структурувати взаємодії. Вони можуть включати динамічні параметри та корисні для стандартизації типових робочих процесів.
73~
74```typescript
75{
76  name: "code_review",
77  description: "Review code changes for quality and security",
78  arguments: [
79    { name: "diff", description: "The code diff to review", required: true }
80  ]
81}
82```
83~
84## Архітектура
85~
86MCP дотримується клієнт-серверної архітектури:
87~
88```mermaid
89graph LR
90    subgraph "Host Application"
91        Client[MCP Client]
92    end
93~
94    subgraph "MCP Server"
95        Server[Server Process]
96        Server --> Tools[Tools]
97        Server --> Resources[Resources]
98        Server --> Prompts[Prompts]
99    end
100~
101    Client -- "JSON-RPC 2.0\n(stdio or SSE)" --> Server
102```
103~
104- **Хост**: AI-додаток (Claude Desktop, Cursor, ваш власний додаток)
105- **Клієнт**: Підтримує з'єднання 1:1 з MCP-сервером
106- **Сервер**: Надає інструменти, ресурси та промпти клієнту
107- **Транспорт**: Зв'язок здійснюється через JSON-RPC 2.0 по stdio (локально) або Server-Sent Events (віддалено)
108~
109## Створення MCP-сервера
110~
111Давайте створимо практичний MCP-сервер, який взаємодіє зі списком завдань, збереженим у JSON-файлі.
112~
113### Налаштування
114~
115```bash
116mkdir mcp-todo-server && cd mcp-todo-server
117npm init -y
118npm install @modelcontextprotocol/sdk zod
119```
120~
121### Реалізація сервера
122~
123```typescript
124// src/index.ts
125import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
126import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
127import { z } from "zod";
128import fs from "fs";
129~
130const TODO_FILE = "./todos.json";
131~
132function readTodos(): { id: number; text: string; done: boolean }[] {
133  if (!fs.existsSync(TODO_FILE)) return [];
134  return JSON.parse(fs.readFileSync(TODO_FILE, "utf-8"));
135}
136~
137function writeTodos(todos: { id: number; text: string; done: boolean }[]) {
138  fs.writeFileSync(TODO_FILE, JSON.stringify(todos, null, 2));
139}
140~
141const server = new McpServer({
142  name: "todo-server",
143  version: "1.0.0",
144});
145~
146// Tool: Add a todo
147server.tool(
148  "add_todo",
149  "Add a new todo item",
150  { text: z.string().describe("The todo text") },
151  async ({ text }) => {
152    const todos = readTodos();
153    const newTodo = { id: Date.now(), text, done: false };
154    todos.push(newTodo);
155    writeTodos(todos);
156    return { content: [{ type: "text", text: `Added: "${text}"` }] };
157  }
158);
159~
160// Tool: List todos
161server.tool(
162  "list_todos",
163  "List all todo items",
164  {},
165  async () => {
166    const todos = readTodos();
167    const list = todos
168      .map((t) => `${t.done ? "✅" : "⬜"} [${t.id}] ${t.text}`)
169      .join("\n");
170    return { content: [{ type: "text", text: list || "No todos yet." }] };
171  }
172);
173~
174// Tool: Complete a todo
175server.tool(
176  "complete_todo",
177  "Mark a todo as completed",
178  { id: z.number().describe("The todo ID to complete") },
179  async ({ id }) => {
180    const todos = readTodos();
181    const todo = todos.find((t) => t.id === id);
182    if (!todo) return { content: [{ type: "text", text: "Todo not found." }] };
183    todo.done = true;
184    writeTodos(todos);
185    return { content: [{ type: "text", text: `Completed: "${todo.text}"` }] };
186  }
187);
188~
189// Resource: Current todos as a readable resource
190server.resource(
191  "todos://list",
192  "Current todo list",
193  async () => ({
194    contents: [{
195      uri: "todos://list",
196      mimeType: "application/json",
197      text: JSON.stringify(readTodos(), null, 2),
198    }],
199  })
200);
201~
202// Start the server
203const transport = new StdioServerTransport();
204await server.connect(transport);
205```
206~
207### Конфігурація
208~
209Щоб використовувати цей сервер з Claude Desktop, додайте його до вашої конфігурації:
210~
211```json
212{
213  "mcpServers": {
214    "todo": {
215      "command": "npx",
216      "args": ["tsx", "/path/to/mcp-todo-server/src/index.ts"]
217    }
218  }
219}
220```
221~
222## Створення MCP-клієнта
223~
224Ви також можете створити власний клієнт, який підключається до будь-якого MCP-сервера:
225~
226```typescript
227import { Client } from "@modelcontextprotocol/sdk/client/index.js";
228import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
229~
230const transport = new StdioClientTransport({
231  command: "npx",
232  args: ["tsx", "./src/index.ts"],
233});
234~
235const client = new Client({ name: "my-client", version: "1.0.0" });
236await client.connect(transport);
237~
238// List available tools
239const { tools } = await client.listTools();
240console.log("Available tools:", tools.map((t) => t.name));
241~
242// Call a tool
243const result = await client.callTool({
244  name: "add_todo",
245  arguments: { text: "Write MCP blog post" },
246});
247console.log(result);
248```
249~
250## Популярні MCP-сервери
251~
252Екосистема MCP швидко зросла. Ось деякі з найпопулярніших серверів:
253~
254| Сервер | Опис | Сценарій використання |
255|--------|------|----------------------|
256| **GitHub** | Створення issues, PR, управління репозиторіями | Робочі процеси розробки |
257| **Slack** | Надсилання повідомлень, управління каналами | Командна комунікація |
258| **PostgreSQL** | Запити та управління базами даних | Доступ до даних |
259| **Filesystem** | Читання, запис та пошук файлів | Локальна розробка |
260| **Puppeteer** | Автоматизація браузера та скрейпінг | Веб-тестування |
261| **Sentry** | Моніторинг помилок та налагодження | Підтримка продакшену |
262| **Supabase** | База даних, автентифікація, сховище | Бекенд-операції |
263~
264## MCP проти A2A (Agent-to-Agent)
265~
266MCP обробляє комунікацію **агент-інструмент**, тоді як протокол **A2A (Agent-to-Agent)** від Google обробляє комунікацію **агент-агент**. Вони доповнюють один одного:
267~
268```mermaid
269graph TD
270    Agent1[Agent 1] -- "A2A Protocol" --> Agent2[Agent 2]
271    Agent1 -- "MCP Protocol" --> Tool1[GitHub MCP Server]
272    Agent2 -- "MCP Protocol" --> Tool2[Database MCP Server]
273```
274~
275- **MCP**: Як AI-агент використовує інструменти (вертикальна інтеграція)
276- **A2A**: Як AI-агенти співпрацюють один з одним (горизонтальна інтеграція)
277~
278## Найкращі практики
279~
2801. **Тримайте сервери сфокусованими**: Один сервер на домен (сервер GitHub, сервер Slack тощо). Не створюйте монолітні сервери.
2812. **Валідуйте вхідні дані за допомогою Zod**: Завжди валідуйте вхідні дані інструментів правильними схемами.
2823. **Обробляйте помилки коректно**: Повертайте зрозумілі повідомлення про помилки, а не стек-трейси.
2834. **Використовуйте ресурси для даних лише для читання**: Якщо AI потрібно лише читати дані, надавайте їх як ресурс, а не як інструмент.
2845. **Додавайте хороші описи**: Хороші описи інструментів та параметрів допомагають AI зрозуміти, коли і як використовувати кожен інструмент.
2856. **Тестуйте за допомогою MCP Inspector**: Використовуйте `npx @modelcontextprotocol/inspector` для інтерактивного тестування вашого сервера.
286~
287## Початок роботи
288~
289```bash
290# Create a new MCP server from template
291npx @modelcontextprotocol/create-server my-server
292~
293# Test with the MCP Inspector
294npx @modelcontextprotocol/inspector npx tsx ./src/index.ts
295```
296~
297## Висновок
298~
299MCP став де-факто стандартом використання AI-інструментів у 2026 році. Незалежно від того, чи ви створюєте власних AI-агентів, розширюєте Claude Code або створюєте інтеграції для існуючих платформ, розуміння MCP є необхідним. Протокол достатньо простий, щоб вивчити його за півдня, але достатньо потужний для створення AI-робочих процесів виробничого рівня.
300~
301**Наступні кроки:**
302- Ознайомтесь зі [Специфікацією MCP](https://spec.modelcontextprotocol.io/)
303- Перегляньте [існуючі MCP-сервери](https://github.com/modelcontextprotocol/servers) для натхнення
304- Створіть свій перший сервер з TypeScript або Python SDK
305- Протестуйте його з Claude Desktop або MCP Inspector
306~