SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

Skills агентів, MCP-сервери чи rules-файли: що обрати

Порівняйте skills, MCP-сервери й rules-файли: коли кожен механізм завантажує контекст, скільки токенів і супроводу він потребує та що обрати.

Порівняння skills агентів, MCP-серверів і rules-файлів: коротка відповідь

Agent skills, MCP-сервери та rules-файли надають coding agent потрібні знання. Вибір залежить від призначення цих знань. MCP (model context protocol) призначений для даних, які можуть змінитися до наступного звернення. Skill призначений для процедури, яку можна описати сьогодні, і яка залишатиметься правильною через шість тижнів. Rules-файл призначений для кількох фактів, які мають виконуватися в кожному сеансі.

Такий вибір має свою ціну — контекст. Кожен токен, витрачений на інструкцію, яка не була потрібна агенту, недоступний для коду, який він читає. Крім того, ви платите за цей токен під час кожного наступного запиту, оскільки все контекстне вікно надсилається повторно. Тому корисно запитувати не про те, який механізм може виконати завдання. У більшості випадків це можуть усі три. Потрібно визначити, який механізм має найменшу вартість, коли він простоює.

Вартість кожного компонента перед використанням

Ці три елементи завантажуються в різні моменти часу, і саме цей час визначає різницю.

Файл безумовних правил завантажується під час запуску, у кожній сесії, незалежно від того, чи він доречний. Claude Code зчитує файли запуску CLAUDE.md на початку кожної розмови, видаляє HTML-коментарі блокового рівня поза блоками коду перед вставкою їхнього вмісту та пропускає файли розміром понад 4 MiB; claudeMdExcludes також може виключати файли, окрім керованого файлу політик. Рекомендований обсяг — до 200 рядків на файл, оскільки довший файл споживає більше контексту і гірше виконується. Ці два ефекти діють в одному напрямку, тому файл правил на 900 рядків є гіршим, ніж марним.

Навичка (skill) завантажується у два етапи. Під час запуску в контекст потрапляє лише рядок description з frontmatter кожного SKILL.md, щоб модель знала про існування навички та приблизно розуміла, коли її застосовувати. Тіло навички завантажується лише тоді, коли її викликають. Таким чином, довідковий документ на 400 рядків майже нічого не коштує до моменту, поки він не знадобиться.

Раніше MCP server був найдорожчим компонентом, і саме тут більшість порівнянь, які ви можете прочитати, вже застаріли. У поточній версії Claude Code пошук інструментів (tool search) увімкнено за замовчуванням. На початку сесії завантажуються лише назви інструментів та поле інструкцій сервера, а повні схеми JSON (JavaScript object notation) відкладаються до моменту, поки Claude не почне їх шукати. Додавання сервера більше не потребує тисяч токенів на старті. Це все ще має певну вартість, і вона все ще стягується повністю на старті в конфігураціях, де пошук інструментів вимкнено.

ГрафікStartup and post-use context cost, estimated tokens
Дані, на яких побудовано графік
[
  {
    "label": "Rules file, 200 lines",
    "at_startup": "2,500",
    "after_use": "2,500"
  },
  {
    "label": "Skill, 12 KB body",
    "at_startup": 40,
    "after_use": "3,000"
  },
  {
    "label": "MCP server, tool search on",
    "at_startup": 500,
    "after_use": "3,200"
  },
  {
    "label": "MCP server, tool search off",
    "at_startup": "4,500",
    "after_use": "4,500"
  }
]

Це оцінки, а не вимірювання з вашої машини. Вони базуються на розмірі тексту, який завантажує кожен механізм, приблизно з розрахунку чотири символи на токен: файл правил на 200 рядків — це близько 10 KB у форматі markdown, опис навички — близько 160 символів, а сервер, що надає дванадцять інструментів, містить близько 18 KB схеми плюс 2 KB блоку інструкцій. Claude Code обрізає поле інструкцій сервера та опис кожного інструменту, що завантажується на старті, до 4,096 символів за замовчуванням, а опис інструменту, завантажений через пошук, — до 16,384. До версії v2.1.296 коротший ліміт становив 2,048 символів, і CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH замінює обидва ліміти, якщо ви їх налаштуєте. Інструкції та описи з деяких MCP-серверів, розміщених на Anthropic, доходять до Claude повністю навіть із встановленим параметром, тому ці ліміти не є універсальною межею. У наступному розділі показано, як зчитати ваші власні реальні показники.

Порівняйте перші два рядки. Файл правил коштує 2,500 токенів у сесії, де він нікому не знадобився. Навичка коштує 40 токенів у тій самій сесії та 3,000 у тій одній сесії з десяти, де вона спрацьовує. Останні два рядки — це один і той самий сервер, з увімкненим і вимкненим пошуком інструментів: 500 токенів проти 4,500. Цей розрив є причиною того, чому старі поради про надмірне споживання контексту через MCP все ще поширюються.

Станом на жовтень 2026 року Claude Code використовує пошук інструментів у Claude Opus 4, Sonnet 4, Haiku 4.5 та новіших моделях, а також у Opus 4.5, Sonnet 4.5, Haiku 4.5 і новіших на платформі Google Cloud Agent Platform. У старіших моделях, а також у розгортаннях Microsoft Foundry на Azure, кожен інструмент MCP завантажується на старті, незалежно від ваших налаштувань. З ANTHROPIC_BASE_URL, спрямованим на LLM gateway, пошук інструментів увімкнено за замовчуванням, починаючи з версії v2.1.304; старіші версії вимикали його там, якщо ви не обрали інше. Починаючи з v2.1.305, Claude Code може повторити запит до шлюзу без пошуку інструментів після 400 або 422, завантажуючи інструменти на старті, якщо повторна спроба успішна. Використовуйте ENABLE_TOOL_SEARCH для керування цим процесом: false завантажує кожну схему на старті, true відкладає їх із тими самими резервними варіантами моделі та розгортання, що й за замовчуванням, а auto завантажує їх на старті, поки їхні визначення сумарно становлять менше 10% вікна контексту, а потім залишає пошук інструментів увімкненим, навіть якщо загальний обсяг згодом падає нижче цього порогу. Сервер, налаштований за допомогою "alwaysLoad": true, завантажує свої інструменти на старті незалежно від ENABLE_TOOL_SEARCH.

# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claude

Визначальне питання: чи змінюються дані між викликами?

Поставте це питання першим, оскільки воно одразу виключає один із варіантів. Якщо агенту потрібно читати або записувати щось, що може змінитися до наступної перевірки, потрібен сервер. Система відстеження завдань, база даних, панель моніторингу, ваш внутрішній API (application programming interface). Записати це у файл не допоможе, оскільки запис застаріває одразу після того, як хтось інший змінює запис. Ваш власний код також належить до цього списку, оскільки його структура змінюється з кожним комітом. Саме тому краще передавати агенту розібрану карту репозиторію через MCP, а не описувати структуру у файлі, який з часом застаріє.

Якщо відповідь залишатиметься правильною через шість тижнів без обслуговування, потрібна skill. Чекліст релізу. Процедура міграції. Структура відповідей із помилками. Правила написання тестів для цього репозиторію. Skill — це файл у git. У нього немає порту, процесу або іншого способу відмови, крім неправильного вмісту, що може виявити code review.

Якщо це один факт, який має застосовуватися до роботи, про яку ви ще не думали, додайте його до rules file. Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. По одному рядку на кожен факт. Щойно запис перетворюється на послідовність кроків, це вже не факт, а процедура, тому його слід перенести до skill.

Коли достатньо файлу правил

Файли правил завантажуються з кількох місць, від найбільш загальних до найбільш специфічних: керований файл політики, ваш особистий ~/.claude/CLAUDE.md, ./CLAUDE.md або ./.claude/CLAUDE.md проєкту, а також ./CLAUDE.local.md, що ігнорується git. Усі знайдені файли об’єднуються, а не заміщують один одного, причому файли, розташовані ближче до вашої робочої директорії, зчитуються останніми.

Починаючи з версії v2.1.277, Claude Code також зчитує AGENTS.md, але за замовчуванням лише тоді, коли у вашій робочій директорії або вище немає CLAUDE.md, .claude/CLAUDE.md або CLAUDE.local.md. Якщо у вашому репозиторії є обидва типи, Claude зчитує лише файли CLAUDE.md, тому не підтримуйте дві копії, які з часом стануть неузгодженими.

ln -s AGENTS.md CLAUDE.md

Символьне посилання не виводить нічого в разі успіху. Розпочніть сесію, виконайте /context all і переконайтеся, що CLAUDE.md з’явився в розділі Memory files. Якщо його там немає, агент ніколи його не бачив, і жодне перефразування не допоможе. Якщо ви також хочете додати рядки, специфічні для Claude, використовуйте форму імпорту та розміщуйте їх після імпорту.

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

Тут є одна пастка. Імпорти @path не зберігають контекст. Імпортований файл розгортається та завантажується під час запуску разом із файлом, який на нього посилається, з глибиною до чотирьох рівнів. Розбиття файлу правил на 600 рядків на шість імпортів структурує його для людей, але не змінює вартість у токенах абсолютно ніяк. Конвенції щодо AGENTS.md та його аналога для людей варто прочитати перед тим, як обирати структуру.

Що дійсно зменшує вартість, так це .claude/rules/ з полем paths. Файл правил, що містить frontmatter paths, завантажується лише тоді, коли агент звертається до файлу, що відповідає одному з шаблонів.

---
paths:
  - "src/api/**/*.ts"
---

# API rules

- Every endpoint validates its input.
- Use the standard error response shape.

Правило без поля paths завантажується під час запуску з таким самим пріоритетом, як і .claude/CLAUDE.md. Отже, робочий шаблон — це короткі безумовні правила плюс список paths для всього, що має значення лише в межах однієї директорії.

Коли потрібен skill

Skill — це директорія з файлом SKILL.md. Персональні skills зберігаються в ~/.claude/skills/<name>/SKILL.md і застосовуються до всіх проєктів на вашому комп’ютері. Проєктні skills зберігаються в .claude/skills/<name>/SKILL.md, входять до репозиторію та можуть проходити перевірку в pull request, як і будь-який інший файл.

mkdir -p ~/.claude/skills/summarize-changes
---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

Run `git status` and `git diff` against the merge base.
Group the changes by intent, not by file.
Call out anything touching auth, migrations or deletions.

description — єдина частина цього файлу, яка перебуває в контексті до запуску skill, тому вона виконує дві функції. Вона описує призначення skill і визначає, коли його потрібно застосовувати. Опис на кшталт "Helps with deploys" не дає моделі нічого, з чим можна порівняти запит. Тому skill непомітно не запускається, і ви робите висновок, що skills не працюють.

Назва директорії стає командою, тому наведений вище приклад дає вам /summarize-changes. У персональному або проєктному skill поле frontmatter name, значення якого відрізняється від назви директорії, визначає команду, яку показує меню /, якщо інша команда вже не використовує це ім’я. Назва директорії все одно запускає skill.

Після запуску skill його відрендерений вміст додається до розмови одним повідомленням і залишається там до кінця сесії. Claude Code не перечитує файл під час наступних запитів. Пишіть постійні інструкції, а не одноразові кроки, і тримайте основний текст стислим, оскільки після цього кожен його рядок повторно збільшує витрати на кожен запит. Після автоматичного стискання контексту Claude Code повторно додає останній виклик кожного skill, залишаючи перші 5,000 токенів кожного в межах спільного бюджету 25,000 токенів. Якщо в одній сесії викликати кілька великих skills, найстаріші буде повністю вилучено. Через це може здаватися, що skill перестав впливати на роботу після тривалої розмови. Викличте його ще раз — і він повернеться. Skill із великою кількістю процедур наочно показує цей компроміс: skill unlazy та його метод Depth Tree витрачає значний обсяг контексту на контрольні умови й файл плану, щоб агент не оголошував роботу завершеною передчасно. Якщо та сама процедура застосовується до кількох кодових баз, використовуйте один skill у кількох репозиторіях, а не копіюйте файл.

Коли потрібен MCP server

Додати його можна однією командою, а транспорт визначає його форму.

# Remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Remote HTTP server behind a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# Local stdio server: everything after -- is passed through untouched
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Має значення --. Для stdio server він відокремлює власні параметри Claude Code від командного рядка, який запускає ваш server. Якщо його пропустити, --port 8080, призначений для server, буде розібрано як параметр claude mcp add, після чого claude mcp add відхилить його.

claude mcp list
claude mcp get notion

claude mcp add підтверджує операцію рядком Added .... Це лише означає, що конфігурацію записано на диск. claude mcp list — команда, яка показує фактичний стан, оскільки виводить статус працездатності поруч із кожним server: ✔ Connected, ! Needs authentication або ✘ Failed to connect. Статус помилки означає, що Claude Code не зміг підключитися до цього server, а не те, що команда перегляду списку не виконалася. У межах сеансу /mcp показує той самий стан для кожного server і кількість інструментів.

Кожен виклик MCP server є окремим і містить усе необхідне. Саме тому MCP server не пам’ятає ваш попередній запит. Це конструктивне рішення має наслідок, за який відповідаєте ви: будь-який стан, який потрібно зберігати, має міститися за межами server — у базі даних або файлі. Тепер цим сховищем потрібно керувати.

MCP server — це процес, який потрібно запускати

Ось витрати, які не враховують порівняння постачальників. Skill — це файл. MCP server — це програмне забезпечення, яке десь працює. Якщо воно працює на вашому VPS (virtual private server), ви відповідаєте за його доступність.

Стандартний випадок для stdio server — найдешевший. Claude Code запускає його як дочірній процес під час початку сесії, а після завершення сесії процес припиняється. Нічого моніторити й нічого оновлювати за окремим графіком не потрібно. Remote HTTP server — це довготривалий сервіс. Йому потрібне все необхідне для таких сервісів, починаючи з окремого користувача. Створіть користувача mcp, від імені якого працюватиме наведений нижче unit, і надайте йому каталог server:

sudo useradd --system --home-dir /srv/notes-mcp --shell /usr/sbin/nologin mcp
sudo chown -R mcp:mcp /srv/notes-mcp
[Unit]
Description=Notes MCP server
After=network-online.target
Wants=network-online.target

[Service]
User=mcp
WorkingDirectory=/srv/notes-mcp
ExecStart=/usr/bin/node /srv/notes-mcp/dist/server.js
Environment=PORT=8931
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now notes-mcp
systemctl is-active notes-mcp
journalctl -u notes-mcp -n 50 --no-pager

Команда systemctl is-active має вивести active. Якщо вона виводить failed, причина міститься в журналі. Під час першого запуску це майже завжди відсутня змінна середовища або порт, який уже зайнятий іншим процесом. Restart=on-failure тут обов’язковий, оскільки MCP server після аварійного завершення не повідомляє про це самостійно. Ви дізнаєтеся про проблему лише тоді, коли агент повідомить, що не може прочитати вашу систему відстеження завдань.

Прив’яжіть процес до 127.0.0.1 і розмістіть перед ним reverse proxy із TLS (transport layer security). MCP server, який має доступ до вашої бази даних і відповідає на публічному порту без автентифікації, фактично є опублікованою базою даних. У матеріалі Запуск MCP server на VPS належно описано налаштування проксі, сертифіката та firewall.

Потім чесно оцініть регулярну роботу з обслуговування. Сервіс установлює security updates за власним графіком, незалежно від агента, який із ним взаємодіє. Його OAuth token спливає, і claude mcp list у невдалий момент починає виводити ! Needs authentication. Його облікові дані зберігаються у config file або заголовку Authorization, тому їх потрібно захищати так само, як будь-який інший секрет. Це окрема велика тема: Як не допустити доступу AI agent до секретів. Для skill жодна з цих операцій не потрібна.

Порівняйте цей варіант з альтернативою, перш ніж створювати server. Якщо дані, до яких має доступ запропонований server, змінюються приблизно раз на квартал, skill, який повідомляє агенту, де шукати дані та що означають поля, буде дешевшим за сервіс, який потрібно постійно підтримувати в роботі.

Як виміряти вартість власного контексту

Припиніть оцінювати приблизно та запустіть /context all під час сесії. Команда виводить поточну деталізацію: системний промпт, файли пам’яті, інструменти та MCP-сервери з вагою токенів для кожного з них.

Перевірте два моменти. У розділі Memory files переконайтеся, що відображаються всі файли правил, які ви очікували побачити. Якщо файл відсутній, агент його не бачить — це перше, що варто перевірити, коли інструкції ігноруються. Якщо файл у списку, а правило все одно пропускається, причина криється в іншому, і варто опрацювати причини, через які агент ігнорує видиму інструкцію, перш ніж переписувати рядок знову. Потім подивіться на вартість ваших серверів. Якщо сервер, яким ви користуєтеся двічі на місяць, є одним із найдорожчих у списку, вимкніть його в /mcp і вмикайте лише для тих сесій, де він потрібен. Конфігурація при цьому зберігається.

Якщо для вашого облікового запису ввімкнено кеш виявлення (discovery cache), віддалений сервер, який ви вже використовували, може відображати статус на кшталт cached 2h ago · connects on first use · 5 tools. Це означає, що Claude Code зчитав список інструментів із попередньої сесії замість підключення під час запуску; він підключиться під час першого виклику інструменту. Інструменти доступні з першого повідомлення, тому нічого виправляти не потрібно. Кеш вимкнено за замовчуванням, якщо тільки він не був активований для вас у межах поступового розгортання: встановіть MCP_DISCOVERY_CACHE=0, щоб усі сервери підключалися під час запуску, або 1, щоб увімкнути кешування. Більш загальну інформацію можна знайти в розділах керування вікном контексту Claude Code (що залишається після стиснення) та у що насправді обходяться ці токени (перетворення чисел на грошовий еквівалент).

Чому моя skill ніколи не активується?

Зазвичай причина — description. Це єдиний текст у контексті до запуску skill, тому, якщо він не описує ситуацію, відповідності не буде. Додайте trigger безпосередньо в речення: «Use when the user asks what changed, wants a commit message, or asks to review their diff.» Нечіткі описи не спричиняють помилок, тому проблему важко помітити.

Друга причина — помилка у frontmatter. У Claude Code ця проблема також не супроводжується повідомленням. Ім’я поля має точно збігатися, включно з дефісами. Claude Code ігнорує невідоме поле без повідомлення про помилку. Явна помилка з’являється лише під час пакування skill або завантаження його до claude.ai чи Skills API. Ці системи приймають менше полів і відхиляють решту:

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

Третя причина — розташування. Project skills завантажуються з .claude/skills/ у робочому каталозі та в кожному батьківському каталозі аж до кореня репозиторію. Skills у дочірніх каталогах, розташованих нижче каталогу, з якого ви почали роботу, не завантажуються під час запуску. Вони з’являються, коли агент уперше читає або редагує файл у цьому підкаталозі. До цього моменту вони не відображаються в автодоповненні та не можуть бути викликані за іменем.

Еквівалентна проблема для MCP — запис .mcp.json із url без type. Claude Code обробляє кожен запис без type як stdio server, тому пропускає його та виводить:

MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry

Використання всіх трьох механізмів разом

Ці механізми не конкурують за одне й те саме місце. У робочій конфігурації кожен із них використовують там, де це потребує найменше ресурсів. Файл правил містить кілька рядків, які всюди залишаються чинними. Skills містять процедури та завантажуються лише тоді, коли вони потрібні. Один MCP server, інколи два, підключає системи, вміст яких неможливо передбачити заздалегідь. Якщо ви ще формуєте уявлення про перший із цих механізмів, у матеріалі докладно описано, що насправді таке навичка агента її формат.

Більшість суперечок про те, де щось має розміщуватися, вирішує один тест. Видаліть це, почніть нову сесію та доручіть агенту виконати завдання. Якщо агент лише працює повільніше, це мало бути в skill. Якщо агент упевнено дає неправильну відповідь, це мало бути у файлі правил. Якщо агент взагалі не може отримати потрібну інформацію, вам потрібен server, а разом із ним — план його підтримки в робочому стані.

FAQ

Що обрати: написати skill чи запустити MCP server?

Вибір залежить від того, чи змінюється інформація між викликами. Якщо агент має зчитувати актуальний стан, який може редагувати хтось інший (наприклад, трекер завдань, база даних або дашборд), вам потрібен MCP server, оскільки будь-який записаний вами статичний файл застаріє одразу після зміни даних. Якщо ви можете записати відповідь один раз і вона залишатиметься правильною через шість тижнів — пишіть skill. Skill — це файл у git, який не потребує окремого процесу, відкритого порту чи графіка оновлень, тому це дешевше рішення, якщо воно технічно можливе.

Чи MCP servers все ще заповнюють моє вікно контексту?

Значно менше, ніж раніше. Пошук інструментів (tool search) увімкнено за замовчуванням у поточній версії Claude Code, тому під час запуску сесії завантажуються лише назви інструментів та поле інструкцій сервера, а повні схеми підтягуються, коли Claude їх шукає. Це стосується і сесій через LLM gateway, налаштований через ANTHROPIC_BASE_URL, починаючи з версії v2.1.304. Попереднє завантаження (upfront loading) все ще відбувається при використанні ENABLE_TOOL_SEARCH=false, для сервера, налаштованого на "alwaysLoad": true, на моделях старіших за Claude Opus 4 та Sonnet 4 (старіших за покоління 4.5 на платформі Google Cloud Agent Platform), а також у розгортаннях Microsoft Foundry на Azure. Виконайте /context all, щоб перевірити поточний стан, оскільки цифри в застарілих порівняльних статтях базуються на припущенні про попереднє завантаження.

Чи читає Claude Code файл AGENTS.md?

Так, починаючи з версії v2.1.277, але за замовчуванням лише за відсутності CLAUDE.md, .claude/CLAUDE.md або CLAUDE.local.md у вашій робочій директорії чи вище. Якщо у вашому репозиторії є обидва типи файлів, Claude читає лише CLAUDE.md, тому краще посилайтеся на один файл з іншого, замість того щоб підтримувати дві копії. Виконайте ln -s AGENTS.md CLAUDE.md для створення звичайного символьного посилання або додайте @AGENTS.md у перший рядок файлу CLAUDE.md, а нижче впишіть інструкції для Claude. Після цього запустіть сесію та виконайте /context all, щоб переконатися, що CLAUDE.md відображається в розділі Memory files.

Чому мій skill перестав діяти посеред сесії?

Зазвичай це стається через автостиснення (auto-compaction). Коли історія розмови узагальнюється, Claude Code повторно приєднує останній виклик кожного skill, зберігаючи перші 5,000 токенів кожного з них у межах спільного ліміту 25,000 токенів для всіх. Цей ліміт заповнюється, починаючи з найбільш нещодавно викликаного skill, тому якщо ви викликали кілька великих skill, старіші з них повністю видаляються. Викличте skill знову, щоб відновити його повний вміст.

Як заборонити завантаження великого файлу правил у кожній сесії?

Перенесіть частини, які потрібні лише іноді, у файли .claude/rules/ з полем paths у frontmatter, щоб кожен з них завантажувався лише тоді, коли агент звертається до відповідного файлу. Розбиття файлу на імпорти @path не допоможе, оскільки імпортовані файли розгортаються та завантажуються під час запуску разом із файлом, який на них посилається. Будь-яка багатоетапна процедура, а не постійний факт, має бути оформлена як skill, оскільки тіло skill не споживає ресурси, доки його не викликано.

Чи була ця стаття корисною?