MCP с нуля: как подключить Claude к своему сервису

Каждый раз, когда вы хотите дать модели доступ к своей системе, приходится вручную описывать инструменты: схемы аргументов, обработка вызова, возврат результата. У десяти приложений это десять одинаковых обвязок. MCP переносит эту работу на отдельный сервер, который пишется один раз и подключается к любому клиенту, понимающему протокол. Курс академии на десять уроков разбирает обе стороны: и сервер, и клиент.

Кому нужен

Инженерам, которые хотят подключить Claude к внутренним сервисам и не писать интеграционный код заново под каждый проект. Из требований: базовый Python, понимание асинхронного кода и общее представление об API. Примеры на официальном питоновском SDK, сквозной проект курса это управление документами.

Три примитива и кто их дёргает

Главная мысль всего курса помещается в один абзац. У MCP-сервера три вида того, что он отдаёт наружу, и различаются они тем, кто принимает решение. Инструменты выбирает сама модель, когда решает, что для ответа нужно действие. Ресурсы это данные только на чтение, и запрашивает их приложение: файл, запись, список. Промпты это заготовленные формулировки под типовой сценарий, и выбирает их пользователь, обычно из меню клиента.

Путаница в этом месте стоит дорого. Если оформить справочные данные инструментом, модель будет решать, стоит ли за ними идти, и иногда решит, что не стоит. Если оформить действие ресурсом, оно не выполнится вовремя.

Как это пишется

Сервер на SDK получается компактным: функция помечается декоратором, аргументы описываются типами, а пояснения к полям берутся из описаний прямо в коде. Схему руками писать не нужно, она собирается сама, и это ровно та экономия, ради которой всё затевалось. Ресурсы бывают с фиксированным адресом и с параметрами в адресе, когда нужно достать конкретную запись по идентификатору.

Отдельный урок про инспектор: браузерная утилита, в которой сервер можно потыкать руками до подключения к Claude. Это резко сокращает отладку, потому что ошибку видно сразу, а не через поведение модели.

Вторая половина курса про клиент: как подключиться к серверу, получить список возможностей, вызвать инструмент, прочитать ресурс с правильным типом содержимого и подставить промпт. Плюс практические штуки вроде автодополнения и подмешивания данных в разговор.

С чего начать

Возьмите одно действие, которое вы чаще всего делаете руками во внутренней системе, и оформите его одним инструментом. Проверьте инспектором, потом подключите к клиенту. Про подключение готовых серверов мы писали в статье Плагины и MCP. Курс целиком лежит в академии Anthropic на английском.

Где купить Claude

Для практики нужен платный тариф или ключ API, оплатить их российской картой напрямую не получится. У нас Claude Pro (2 090 ₽/мес), Max 5x (11 010 ₽/мес), Max 20x (22 010 ₽/мес) и пополнение API от $20, оплата картой РФ или СБП.