Oleksandr Kuzmenko, РедакторОпубліковано 7 хв читанняЗа участі AI · перевірено редактором
TL;DR
- Уникайте прямого копіювання REST у MCP: 10 цільових інструментів можуть перекрити функціонал 31 наївного ендпойнта.
- Використовуйте списки дельта-операцій замість повної перезапису JSON, щоб уникнути втрати даних.
- Зберігайте складні запити на сервері та передавайте моделі лише непрозорі ідентифікатори (handles).
Ключові факти
- Ліміт опису в Claude Code
- 2048 символів (типове обмеження з березня по жовтень 2026)
- Консолідація інструментів
- 10 інструментів покривають сценарії, які в наївному дизайні вимагали б 31
- Розмір типового дашборду
- ~15 000 символів, які більше не треба пересилати повністю
Проєктування цільових інструментів замість наївних обгорток
Пряме перенесення REST API в інструменти Model Context Protocol (MCP) створює надмірне навантаження. У першій версії Metabase 60 майже кожен ендпойнт став інструментом, і зрештою виконання запитів роздрібнилося між чотирма функціями. Очевидний дизайн для 11 типів читання та 10 запису вимагав би 31 окремого інструмента. У Metabase 64 розробники закрили ці потреби 10 інструментами (з 24 загалом): універсальний get_content зчитує сутності пакетами, а дев'ять інструментів запису приймають method зі значеннями create або update. Небезпечний інструмент видалення прибрали, замінивши прапорцем archived. Обов'язкові схеми приймають null, а очищення полів вимагає явного списку на кшталт "clear": ["description"].
Запобігання прихованим помилкам через список дельта-операцій
Моделі генерують текст токен за токеном, а не копіюють його. У Metabase макет типового дашборду займає близько 15 000 символів. Вимога повертати весь JSON заради однієї зміни змушувала модель губити прив'язки фільтрів та плутати ID карток. Новий інструмент dashboard_write приймає масив декларативних операцій (add_heading, add_card, wire_parameter). Тимчасові від'ємні ID (-1, -2) дозволяють посилатися на незбережені елементи, а прапорець autowire: true автоматично пов'язує фільтри. Усі операції застосовуються в межах однієї транзакції з можливістю перевірки через validate_only: true.
Серверні дескриптори та оновлення через пошук і заміну
Для документів повний перезапис тексту зривав прив'язку коментарів до блоків. Metabase замінила його точковими правками пошуку й заміни з полями old_str та new_str. Для SQL-запитів функція execute_query повертає дані разом із дескриптором query_handle. Моделі більше не потрібно вручну передруковувати числові ID таблиць і стовпчиків у наступні виклики на кшталт visualize_query — вона передає короткий ідентифікатор збереженого на сервері запиту.
Спробуй за 2 хвилини
{
"method": "update",
"id": 7,
"edits": [
{
"old_str": "up 12%",
"new_str": "up 14%"
}
]
}Коли використовувати
- Під час розробки інструментів для агентів у складних SaaS-додатках із реляційними структурами даних.
Коли НЕ варто
- Коли створюється простий MCP-сервер лише з кількома функціями пошуку без стану.
Що зробити сьогодні
- Провести аудит MCP-інструментів і замінити повний перезапис JSON-об'єктів на дельта-операції.
- Впровадити серверні дескриптори запитів для усунення помилок під час передачі числових ID.
Назви кроків узяті з блоку «Що зробити сьогодні».
Назви кроків узяті з блоку «Що зробити сьогодні». Провести аудит MCP-інструментів і замінити повний перезапис JSON-об'єктів на дельта-операції.. Впровадити серверні дескриптори запитів для усунення помилок під час передачі числових ID.
- Провести аудит MCP-інструментів і замінити повний перезапис JSON-об'єктів на дельта-операції.
- Впровадити серверні дескриптори запитів для усунення помилок під час передачі числових ID.
