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

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 и повторяем запрос. Простая схема, которую легко отладить.

Где чаще ломается

  1. Слишком много инструментов. 40 функций в одном запросе — модель путается и вызывает не то. Держите 5–10 на сценарий.
  2. Размытые описания. «Получить данные» без указания формата приводит к неверным аргументам.
  3. Нет валидации. Артикул может прийти с пробелом или в другом регистре — проверяйте вход.
  4. Ошибки не возвращаются. Если инструмент упал, модели нужно сказать об этом текстом, иначе она придумает результат.

Безопасность

Инструменты — это доступ. Сервер должен работать с правами, которых достаточно для задачи, и не иметь возможности удалять данные без подтверждения. Всё, что меняет состояние (отправка письма, создание документа), требует подтверждения человеком: модель ошибается, а отменить действие бывает нельзя.

С чего начать

  1. Выберите один сценарий: например, «ответить клиенту по остаткам».
  2. Опишите 2–3 инструмента с точными параметрами.
  3. Соберите цикл вызова и логируйте каждый шаг.
  4. Прогоните 20 реальных вопросов и посмотрите, где модель ошибается.
  5. Расширяйте список инструментов только после того, как базовый сценарий стабилен.

Зачем нужен 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-консоли — риск: один неверный запрос может изменить данные.

Смотрите также