DeepSeek и MCP: как подключить инструменты к модели

DeepSeek и MCP — про то, как дать модели доступ к инструментам: файлам, базам, CRM, календарю. MCP (Model Context Protocol) стандартизирует это подключение: вместо самодельных функций вы описываете сервер с tools, а клиент сам передаёт их модели. DeepSeek поддерживает вызов инструментов через OpenAI-совместимый API, поэтому связать его с MCP-сервером можно уже сегодня.
Зачем это нужно
Без инструментов модель отвечает по памяти: не видит ваши файлы, не знает остатков на складе и не может создать задачу в трекере. Традиционно для каждого сервиса пишут отдельные функции и описывают их в запросе. MCP заменяет это общим протоколом: сервер объявляет инструменты, клиент передаёт их модели, модель просит вызвать нужный.
Как устроена связка
- Сервер MCP — процесс, который знает, как читать файлы, ходить в API или базу, и публикует список tools.
- Клиент — приложение, которое подключается к серверу, получает описание инструментов и передаёт вызовы.
- Модель — DeepSeek: получает схемы tools в запросе и возвращает вызов функции вместо текста.
Что уже готово
| Компонент | Роль | Что нужно |
|---|---|---|
| Готовые серверы | Файлы, git, базы, поиск | Список серверов и права |
| Свой сервер на Python | Внутренние API компании | SDK и описание инструментов |
| Клиент | Связка модель ↔ сервер | Обработка вызовов и ошибок |
Минимальный пример
Сервер объявляет инструмент «остатки товара» с параметром артикула. Модель получает схему, понимает, что для ответа нужен вызов, и возвращает JSON с именем функции и аргументами. Клиент выполняет вызов и отправляет результат обратно — модель формулирует ответ.
tools = [{
"type": "function",
"function": {
"name": "get_stock",
"description": "Остаток товара по артикулу",
"parameters": {
"type": "object",
"properties": {"sku": {"type": "string"}},
"required": ["sku"]
}
}
}]
Дальше — цикл: если в ответе есть tool_calls, выполняем функцию, добавляем результат как сообщение с ролью tool и повторяем запрос. Простая схема, которую легко отладить.
Где чаще ломается
- Слишком много инструментов. 40 функций в одном запросе — модель путается и вызывает не то. Держите 5–10 на сценарий.
- Размытые описания. «Получить данные» без указания формата приводит к неверным аргументам.
- Нет валидации. Артикул может прийти с пробелом или в другом регистре — проверяйте вход.
- Ошибки не возвращаются. Если инструмент упал, модели нужно сказать об этом текстом, иначе она придумает результат.
Безопасность
Инструменты — это доступ. Сервер должен работать с правами, которых достаточно для задачи, и не иметь возможности удалять данные без подтверждения. Всё, что меняет состояние (отправка письма, создание документа), требует подтверждения человеком: модель ошибается, а отменить действие бывает нельзя.
С чего начать
- Выберите один сценарий: например, «ответить клиенту по остаткам».
- Опишите 2–3 инструмента с точными параметрами.
- Соберите цикл вызова и логируйте каждый шаг.
- Прогоните 20 реальных вопросов и посмотрите, где модель ошибается.
- Расширяйте список инструментов только после того, как базовый сценарий стабилен.
Зачем нужен MCP, если есть вызов функций
Вызов функций (function calling) требует, чтобы описание инструментов лежало в вашем коде: схемы, валидация, обработка ошибок. MCP выносит это в отдельный сервер, который умеет подключаться к разным клиентам. Один раз написали сервер с доступом к CRM — и его используют и чат, и редактор, и внутренний бот.
Второй плюс — границы доступа. Сервер объявляет, что он умеет, а клиент показывает это пользователю. Права и логирование остаются на стороне сервера, а не размазываются по приложениям.
Как выглядит схема
| Слой | Роль | Пример |
|---|---|---|
| Клиент | Отправляет запрос модели | Чат, IDE, бот |
| Модель | Решает, какой инструмент вызвать | DeepSeek через API |
| MCP-сервер | Выполняет действие | Поиск в базе, создание задачи |
Что писать в описании инструмента
Модель выбирает инструмент по описанию, а не по названию. «Поиск клиента по телефону или email, возвращает id и статус» работает; «client_search» — нет. Указывайте формат входа, что вернётся и что считается ошибкой. Если описание расплывчатое, модель будет вызывать инструмент наугад и тратить токены.
Безопасность
Инструменты с побочными эффектами — отправка письма, списание, удаление — требуют подтверждения человеком. Ставьте лимиты: сколько вызовов в минуту, какие записи доступны, что делать при отказе. MCP упрощает подключение, но не отменяет правило: модель не должна иметь неограниченный доступ к данным.
DeepSeek MCP не поддерживает на уровне API — связка строится на стороне клиента, который получает список инструментов и передаёт их модели как обычные функции.
Первые шаги: сервер за вечер
Начните с одного инструмента и одного действия: поиск клиента по телефону. Опишите вход, выход и ошибки. Подключите сервер к клиенту, проверьте, что модель вызывает его по правильному запросу, и только потом добавляйте второй инструмент. Так ошибки видны сразу, а не тонут в десятке непонятных вызовов.
DeepSeek MCP не реализует нативно, поэтому инструменты передаются как обычные функции в запросе к API: список, схемы и правила выбора.
DeepSeek MCP связывается через клиент: инструменты передаются как функции, а сервер выполняет вызов.
DeepSeek MCP связывается через клиент: инструменты передаются как функции, а сервер выполняет вызов.
Умеет ли DeepSeek вызывать функции?
Да, через OpenAI-совместимый интерфейс: вы передаёте схемы tools, модель возвращает вызов с аргументами, клиент выполняет и возвращает результат.
Нужен ли свой сервер MCP?
Для стандартных задач хватает готовых. Свой сервер нужен, когда инструменты обращаются к внутренним системам компании.
Сколько инструментов давать модели?
Практика: 5–10 на один сценарий. Больше — растёт путаница и число неверных вызовов, а контекст тратится на описания.
Что делать, если модель придумала аргумент?
Валидировать на стороне сервера и возвращать понятную ошибку текстом. Модель исправится, если увидит, что именно не так.
Можно ли дать модели доступ к базе напрямую?
Технически да, но только через инструмент с ограниченными запросами. Прямой доступ к SQL-консоли — риск: один неверный запрос может изменить данные.