Андрей · AI под работу

Все уроки

02

MCP с нуля: подключаю Claude к своим данным за 20 минут

14:28 · 11 шагов

1 Репозиторий материалов github.com
  1. 1 00:00 Тот же вопрос, тот же Claude: до и после
  2. 2 01:10 Зачем вообще нужен MCP: где кончается модель
  3. 3 02:10 Готовый сервер из документации: подключение и первый вызов
  4. 4 04:21 Данные: генератор и двести вымышленных заказов
  5. 5 05:25 Свой сервер: задача словами, а не синтаксисом

    1 Что делать

    Отдаю Claude Code задачу словами, он сам находит свежий SDK и пишет сервер на три инструмента.

    2 Промпт

    RU · Промпт
    # Задача: сервер MCP над заказами «Три зерна»
    
    Данные вымышленные, компания «Три зерна» не существует. Заказы кофейной лавки лежат в файле
    `orders.json` по абсолютному пути вне папки сервера (в ролике — `C:\data\tri-zerna\orders.json`),
    в виде списка из двухсот записей.
    У каждого заказа есть номер, дата, клиент (название кафе), город, товар, количество, цена за
    единицу, сумма, статус и менеджер.
    
    Напиши сервер MCP на Python, который отдаёт модели три инструмента для работы с этими заказами:
    
    1. **Список заказов** — с необязательными фильтрами по статусу и по городу и с ограничением на
       число возвращаемых записей (по умолчанию двадцать).
    2. **Поиск заказов** — по подстроке, которая ищется и в названии клиента, и в названии товара.
    3. **Карточка заказа** — все поля одного заказа по его номеру.
    
    Требования:
    - сервер работает через stdio, отдельного сетевого порта не поднимает;
    - у каждого инструмента есть краткое описание для модели — одно предложение на русском языке,
      без канцелярита, по существу того, что инструмент возвращает;
    - весь файл сервера — не длиннее шестидесяти строк;
    - используй актуальный на сегодня Python SDK для MCP — найди в его свежей документации нужный
      класс сервера и способ регистрации инструмента сам, не полагайся на то, что ты про него уже
      знаешь.
    
    Сервер не хранит и не принимает никаких секретов: он только читает файл с заказами.
    EN · Промпт с экрана
    # Задача: сервер MCP над заказами «Три зерна»
    
    Данные вымышленные, компания «Три зерна» не существует. Заказы кофейной лавки лежат в файле
    `orders.json` по абсолютному пути вне папки сервера (в ролике — `C:\data\tri-zerna\orders.json`),
    в виде списка из двухсот записей.
    У каждого заказа есть номер, дата, клиент (название кафе), город, товар, количество, цена за
    единицу, сумма, статус и менеджер.
    
    Напиши сервер MCP на Python, который отдаёт модели три инструмента для работы с этими заказами:
    
    1. **Список заказов** — с необязательными фильтрами по статусу и по городу и с ограничением на
       число возвращаемых записей (по умолчанию двадцать).
    2. **Поиск заказов** — по подстроке, которая ищется и в названии клиента, и в названии товара.
    3. **Карточка заказа** — все поля одного заказа по его номеру.
    
    Требования:
    - сервер работает через stdio, отдельного сетевого порта не поднимает;
    - у каждого инструмента есть краткое описание для модели — одно предложение на русском языке,
      без канцелярита, по существу того, что инструмент возвращает;
    - весь файл сервера — не длиннее шестидесяти строк;
    - используй актуальный на сегодня Python SDK для MCP — найди в его свежей документации нужный
      класс сервера и способ регистрации инструмента сам, не полагайся на то, что ты про него уже
      знаешь.
    
    Сервер не хранит и не принимает никаких секретов: он только читает файл с заказами.

    Спросить в Telegram

  6. 6 07:35 Регистрация в .mcp.json, перезапуск, три уровня
  7. 7 08:55 Что видно, когда модель зовёт инструмент
  8. 8 09:43 Прогон: пять вопросов, пятый — про объём
  9. 9 11:14 Где ломается: секреты, лимиты, когда проще скрипт
  10. 10 13:36 Домашка
  11. 11 14:14 Что дальше