К содержанию
Все статьи

MCP-сервер: что это и как сделать свой для CRM

Что такое MCP-сервер, из чего он состоит и как сделать свой для CRM или базы данных: какие инструменты открыть агенту, пример на официальном Python SDK, проверка в MCP Inspector и безопасность.

🧑‍💻Сергей Шульман 8 мин чтения

MCP-сервер — это небольшая программа, через которую ИИ-агент получает доступ к вашей системе: CRM, базе данных, учёту. Для крупных западных сервисов такие серверы уже есть, для российских CRM и самописных баз чаще всего нет. Хорошая новость: свой MCP-сервер — это не проект на месяц, а несколько десятков строк кода, которые агент вроде Claude Code напишет сам. Ниже объясню, из чего состоит MCP-сервер, какие инструменты открыть агенту в CRM, покажу пример на официальном SDK и расскажу, как не открыть лишнего.

Коротко:

  • MCP-сервер сообщает агенту, какие действия доступны (найти клиента, получить сделки, создать задачу), и выполняет их по запросу.
  • Сервер может давать три вещи: инструменты, ресурсы и шаблоны промптов. Для CRM почти всегда достаточно инструментов.
  • Официальные SDK есть для TypeScript, Python, C#, Go, Rust, Ruby и других языков.
  • Локальный сервер работает через stdio, удалённый — через Streamable HTTP с авторизацией.
  • Главное в безопасности — минимальные права: отдельный аккаунт CRM, сначала только чтение, никаких удалений без человека.

Что такое MCP-сервер

MCP (Model Context Protocol) — открытый стандарт подключения ИИ-агентов к внешним системам. Как подключить готовый сервер к Claude Code и другим агентам, я разбирал в статье MCP: как подключить к ИИ-агенту CRM, базы и сервисы. Здесь — про то, как сделать свой.

В архитектуре MCP три участника:

  • хост — приложение, где работает агент: Claude Code, OpenCode, Kimi Code, n8n;
  • клиент — часть хоста, которая держит соединение с одним сервером;
  • сервер — ваша программа, которая знает, как работать с CRM, и объясняет это агенту.

Когда вы задаёте вопрос, по официальной документации происходит так: клиент отправляет вопрос модели, модель смотрит доступные инструменты и выбирает нужный, клиент вызывает инструмент через MCP-сервер, результат возвращается модели, и она формулирует ответ.

Что может дать сервер: инструменты, ресурсы, промпты

ВозможностьКто управляетПример для CRM
Инструменты (tools)Модель сама решает, когда вызвать«Найти клиента по телефону», «Создать задачу менеджеру»
Ресурсы (resources)Приложение подставляет как данныеСправочник статусов сделок, прайс-лист
Промпты (prompts)Пользователь выбирает шаблон«Подготовь сводку по воронке за неделю»

Документация подчёркивает: инструменты вызывает модель, но MCP рассчитан на контроль человека. Приложение может показывать список инструментов, спрашивать подтверждение на каждый вызов, разрешать заранее только безопасные операции и вести журнал всех вызовов.

Как подключается сервер: stdio и HTTP

stdio — сервер запускается как программа на том же компьютере, что и агент, и общается через стандартный ввод-вывод. Такой сервер обычно обслуживает одного клиента. Подходит для старта и для работы одного человека.

Streamable HTTP — сервер работает удалённо, к нему подключаются по сети, и он обслуживает многих клиентов. Поддерживает обычную HTTP-авторизацию: токены, ключи, заголовки; MCP рекомендует получать токены через OAuth. Это вариант для команды и для подключения к n8n.

Мой порядок: сначала stdio-сервер у одного человека, на нём отлаживаем набор инструментов. Когда понятно, что нужно, переносим на HTTP с авторизацией для всей команды.

Какие инструменты открыть агенту в CRM

Самая частая ошибка — сделать «инструмент для всего»: один execute_query, который выполняет любой запрос к базе. Агенту так удобнее, но вам — нет: невозможно ограничить, что он делает.

Правильнее — узкие инструменты под конкретные действия. Условный набор для CRM:

ИнструментЧто делаетПрава
find_clientНайти клиента по телефону, почте или названиюЧтение
get_dealsСделки за период с фильтром по статусу и менеджеруЧтение
get_deal_historyИстория касаний по сделкеЧтение
create_taskПоставить задачу менеджеру по сделкеЗапись, с подтверждением
add_noteДобавить комментарий в карточкуЗапись, с подтверждением

Удаления и массовые изменения в этот список не входят вообще. Если они когда-то понадобятся — это отдельный разговор и отдельный инструмент с обязательным подтверждением человека.

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

Пример: MCP-сервер для CRM на Python

Пример условный: у вашей CRM будет свой адрес API, свои поля и своя авторизация. Код построен по официальному руководству Build an MCP server — там же полный пример и варианты на других языках. Для Python по этому руководству нужны Python 3.10+ и Python MCP SDK версии 2.0.0 или новее.

Подготовка проекта (команды из руководства, имя проекта своё):

uv init crm
cd crm
uv venv
source .venv/bin/activate
uv add "mcp[cli]"

Сам сервер, файл crm.py:

import logging
import os
from typing import Any

import httpx2
from mcp.server import MCPServer

logger = logging.getLogger(__name__)

mcp = MCPServer("crm")

CRM_API = "https://crm.example.ru/api"   # адрес API вашей CRM
CRM_TOKEN = os.environ["CRM_TOKEN"]      # токен отдельного аккаунта для агента


async def crm_get(path: str, params: dict) -> Any:
    headers = {"Authorization": f"Bearer {CRM_TOKEN}"}
    async with httpx2.AsyncClient() as client:
        response = await client.get(f"{CRM_API}{path}", params=params,
                                    headers=headers, timeout=30.0)
        response.raise_for_status()
        return response.json()


@mcp.tool()
async def find_client(phone: str) -> str:
    """Найти клиента в CRM по номеру телефона.

    Args:
        phone: Телефон в формате +7XXXXXXXXXX
    """
    logger.info("find_client called")
    data = await crm_get("/clients", {"phone": phone})
    if not data:
        return "Клиент не найден."
    c = data[0]
    return f"{c['name']}, менеджер: {c['manager']}, сделок: {c['deals_count']}"


if __name__ == "__main__":
    mcp.run(transport="stdio")

Что здесь важно и взято из документации:

  • класс MCPServer строит описание инструмента из подсказок типов и docstring — поэтому docstring пишется для модели, а не для галочки;
  • stdio-сервер не должен писать в stdout: print() ломает обмен сообщениями. Логи — через logging, он пишет в stderr;
  • httpx2 — HTTP-клиент, от которого зависит сам SDK, он ставится вместе с mcp.

Токен CRM передаётся через переменную окружения и не лежит в коде.

Как проверить и подключить

MCP Inspector — официальный инструмент отладки. Запускается через npx (нужен Node.js), без установки: вы передаёте ему команду запуска сервера и в браузере видите список инструментов, можете вызвать каждый вручную и посмотреть ответ. Общий вид из документации:

npx @modelcontextprotocol/inspector node path/to/server/index.js

Для нашего Python-сервера вместо node … подставляется своя команда запуска.

Подключение к Claude Code — по синтаксису из документации Claude Code:

claude mcp add --env CRM_TOKEN=ваш_токен --transport stdio crm \
  -- uv --directory /полный/путь/к/crm run crm.py

Тот же сервер подключается к OpenCode, Kimi Code и Codex — все они поддерживают MCP. В n8n удалённый MCP-сервер подключается узлом MCP Client Tool как инструмент агента (как собрать агента в n8n). В этом сила стандарта: интеграция пишется один раз и переживает смену агента и модели.

Безопасность MCP-сервера

У MCP есть отдельные официальные руководства: Security Best Practices и Local Server Security. Главное из них для бизнеса:

  • Минимальные права. Документация прямо называет ошибками широкие права вида «доступ ко всему» и выдачу всех разрешений заранее. Начинать нужно с минимального набора — чтение и поиск — и повышать права, только когда они понадобились.
  • Не пробрасывать чужие токены. Сервер не должен принимать токены, выпущенные не для него, и передавать их дальше в CRM. В спецификации это прямо запрещено.
  • Отдельные учётные данные на каждый сервер. Ничего не наследовать из окружения разработчика и не переиспользовать ключи.
  • Описания инструментов — недоверенные данные. Сторонний сервер может подсунуть в описание инструкции для агента. Ставьте серверы только от понятного издателя, фиксируйте версию, сторонние запускайте изолированно.
  • Ограничить сеть и файлы. Серверу CRM нужен доступ только к API CRM — не к диску и не ко всему интернету.

Что я добавляю у клиентов:

  1. Отдельный аккаунт в CRM для агента с ролью «только чтение» на старте. В журнале CRM видно, что делал агент.
  2. Запись — только с подтверждением человека в первые недели.
  3. Персональные данные — осознанно. Ответ инструмента уходит в модель. Если данные клиентов нельзя передавать за рубеж, выбирайте модель в российском облаке или свою (про локальные модели).
  4. Журнал вызовов на стороне сервера: кто, когда, какой инструмент, с какими параметрами.

Кто пишет сервер

Я давно не пишу такие серверы руками. Агент получает документацию API вашей CRM и описание нужных инструментов — и пишет сервер, тесты и инструкцию по подключению. У MCP даже есть официальный раздел о том, как направлять ИИ-ассистентов при проектировании серверов с помощью agent skills. Человек при этом решает главное: какие инструменты открыть, какие права дать и что проверить перед запуском. Это и есть то, чему я учу команду, — подробнее о подходе в статье Harness для ИИ-агента.

Частые вопросы

Что такое MCP-сервер простыми словами? Программа-посредник между ИИ-агентом и вашей системой. Она сообщает агенту, какие действия доступны, и выполняет их по запросу.

На каком языке писать MCP-сервер? На том, который знает ваша команда. Официальные SDK первого уровня есть для TypeScript, Python, C#, Go, Rust и Ruby.

Можно ли сделать MCP-сервер для amoCRM, Битрикс24 или 1С? Если у системы есть API — да, сервер оборачивает нужные методы в инструменты. Для учёта подход описан в статье об ИИ и 1С.

Безопасно ли давать агенту доступ к CRM через MCP? Безопасно при узких инструментах, отдельном аккаунте с минимальными правами, подтверждении записи человеком и журнале вызовов.

Чем MCP-сервер лучше прямой интеграции с API? Один сервер работает с любым агентом, который понимает MCP. При смене модели или агента интеграцию не нужно переписывать.


Нужен агент, который видит вашу CRM и базу, но не может сделать лишнего? Я настраиваю Claude Code или альтернативу в компании, пишу MCP-серверы под ваши системы с правильными правами и учу команду их развивать. Напишите в Telegram, какая у вас CRM, — обсудим на 30-минутном созвоне.

Похожие статьи: MCP: как подключить к ИИ-агенту CRM, базы и сервисы · ИИ и 1С: как подключить агента к учёту

Читайте также

Есть похожая задача?

Разберу её бесплатно за 30 минут и предложу решение. Пишите в Telegram или звоните.