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

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 — не к диску и не ко всему интернету.
Что я добавляю у клиентов:
- Отдельный аккаунт в CRM для агента с ролью «только чтение» на старте. В журнале CRM видно, что делал агент.
- Запись — только с подтверждением человека в первые недели.
- Персональные данные — осознанно. Ответ инструмента уходит в модель. Если данные клиентов нельзя передавать за рубеж, выбирайте модель в российском облаке или свою (про локальные модели).
- Журнал вызовов на стороне сервера: кто, когда, какой инструмент, с какими параметрами.
Кто пишет сервер
Я давно не пишу такие серверы руками. Агент получает документацию 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С: как подключить агента к учёту