MCP-серверы в OpenClaw: полный гайд
- Как превратить AI-агента в рабочий инструмент: MCP-серверы позволяют подключить внешние системы, API и базы данных для автоматизации реальных бизнес-процессов
- Почему стоит использовать стандартные MCP-серверы: OpenClaw поставляется с 6 предустановленными серверами (File Server, Web Search, Database, HTTP Client, Email, Slack/Telegram) для быстрого запуска
- Как работает архитектура MCP: система передает запросы клиента на нужный MCP-сервер, получает результат из внешних API или баз данных и обрабатывает ответ через единую AI-модель
- Что делать если нужна интеграция без разработчиков: для предпринимателей и маркетологов это возможность автоматизировать обработку заказов, управление CRM, анализ документов и мониторинг без найма штатных разработчиков
MCP (Model Context Protocol) — это протокол, который позволяет AI-агентам получать доступ к внешним инструментам, базам данных и сервисам. В OpenClaw эта технология открывает неограниченные возможности для автоматизации бизнес-процессов. Если вы хотите, чтобы ваш AI-помощник не просто отвечал на вопросы, а реально работал с вашими системами, этот гайд для вас.
Что такое MCP-серверы и зачем они нужны
MCP-серверы — это по сути расширения для вашего AI-агента. Представьте их как плагины, которые дают агенту способность взаимодействовать с реальным миром: читать файлы, запрашивать данные из API, отправлять сообщения, работать с CRM или аналитикой.
Без MCP-серверов ваш AI-агент ограничен текстовым диалогом. С ними он становится полноценным инструментом автоматизации. Например:
- Обработка заказов через интеграцию с базой данных
- Отправка сообщений в CRM при получении нового лида
- Автоматический анализ документов и отчётов
- Мониторинг социальных сетей с действиями в ответ
- Управление календарём и планирование встреч
Архитектура MCP в OpenClaw
MCP работает по принципу "клиент-сервер". OpenClaw выступает клиентом, а вы настраиваете серверы, которые расширяют его функциональность.
Базовая архитектура выглядит так:
User → Telegram/WhatsApp → OpenClaw Client → MCP Server → External API/Database
Когда пользователь пишет сообщение в мессенджер:
Это происходит в контексте единой AI-модели (Claude, GPT, DeepSeek и т.д.), поэтому агент понимает, какой инструмент использовать и как интерпретировать результат.
Стандартные MCP-серверы OpenClaw
OpenClaw поставляется с набором предустановленных MCP-серверов. Они уже готовы к работе, нужно только включить их и настроить параметры.
| Сервер | Назначение | Применение |
|---|---|---|
| File Server | Чтение/запись файлов | Обработка документов, логирование |
| Web Search | Поиск в интернете | Актуальная информация, исследования |
| Database | Подключение к БД | Работа с записями, запросы |
| HTTP Client | Запросы к API | Интеграция с внешними сервисами |
| Отправка писем | Уведомления, коммуникация | |
| Slack/Telegram | Сообщения в каналы | Оповещения команде |
Как подключить и настроить MCP-сервер
Процесс настройки зависит от того, используете ли вы нашу услугу установки на openclawinstall.ru или устанавливаете самостоятельно.
Базовая конфигурация
Конфигурация MCP хранится в файле mcp.json в директории проекта OpenClaw. Вот структура базового конфига:
{
"mcpServers": {
"file-server": {
"command": "node",
"args": ["servers/file-server.js"],
"enabled": true,
"env": {
"MAX_FILE_SIZE": "10mb"
}
},
"web-search": {
"command": "python",
"args": ["servers/web_search.py"],
"enabled": true,
"env": {
"SEARCH_API_KEY": "your_api_key"
}
}
}
}Включение стандартного сервера
Если вы хотите подключить встроенный файловый сервер:
# Перейти в директорию OpenClaw cd ~/openclawОтредактировать конфиг
nano config/mcp.jsonНайти строку "enabled": false для file-server и изменить на true
Сохранить: Ctrl+O, Enter, Ctrl+X
Перезагрузить сервис
systemctl restart openclaw
Подключение внешнего API через HTTP-сервер
Для интеграции с внешним API (например, вашей CRM):
# Добавить в mcp.json новый сервер
cat >> config/mcp.json << 'EOF'
{
"mcpServers": {
"crm-api": {
"command": "node",
"args": ["servers/http-client.js"],
"enabled": true,
"env": {
"CRM_API_URL": "https://api.yourcrm.com",
"CRM_API_KEY": "sk_xxx_yyy"
}
}
}
}
EOFЕсли вы не уверены в технических деталях, услуга Установка на openclawinstall.ru (4 000 ₽) включает полную настройку всех необходимых MCP-серверов под ваши задачи. Специалисты сервиса справятся с интеграцией за несколько часов.
Примеры практического использования
Пример 1: Автоматизация обработки заказов
Сценарий: Клиент пишет в Telegram, что хочет сделать заказ. OpenClaw должен добавить запись в вашу базу данных и отправить уведомление в CRM.
# MCP-конфиг для работы с БД
{
"database-server": {
"command": "node",
"args": ["servers/db.js"],
"env": {
"DB_HOST": "localhost",
"DB_PORT": "5432",
"DB_NAME": "orders",
"DB_USER": "openclaw",
"DB_PASSWORD": "secure_password"
}
}
}Когда клиент напишет "Хочу сделать заказ на 5 литров масла", агент:
Пример 2: Аналитика и отчёты
Вы можете попросить агента генерировать отчёты на основе реальных данных:
Пользователь: "Какой товар принёс наибольший доход в этом месяце?"OpenClaw:
Пример 3: Мониторинг и уведомления
MCP-сервер может постоянно проверять состояние систем и отправлять уведомления в Telegram:
{
"monitoring-server": {
"command": "python",
"args": ["servers/monitoring.py"],
"env": {
"CHECK_INTERVAL": "300",
"ALERT_THRESHOLD": "80",
"METRICS_URL": "https://api.monitoring.io/metrics"
}
}
}Если нагрузка на сервер превышает 80%, агент автоматически уведомит вас в Telegram.
Создание собственного MCP-сервера
Если стандартные и готовые решения не подходят, можно разработать собственный MCP-сервер. Это не сложнее, чем написать простой скрипт.
Минимальный пример на Node.js
# Создать файл servers/custom-service.js
cat > servers/custom-service.js << 'EOF'
const http = require('http');
const tools = { calculateDiscount: { description: "Рассчитать скидку для клиента", parameters: { amount: "Сумма заказа", loyaltyLevel: "Уровень лояльности (1-5)" } } };
function handleRequest(tool, params) { if (tool === 'calculateDiscount') { const baseDiscount = params.loyaltyLevel * 5; const finalDiscount = params.amount > 10000 ? baseDiscount + 10 : baseDiscount; return { discount: finalDiscount, finalAmount: params.amount * (1 - finalDiscount / 100) }; } }
console.log('Custom MCP Server started'); process.stdin.on('data', (data) => { const request = JSON.parse(data); const result = handleRequest(request.tool, request.params); console.log(JSON.stringify(result)); }); EOF
Добавить в конфиг
{
"custom-service": {
"command": "node",
"args": ["servers/custom-service.js"],
"enabled": true
}
}Теперь агент может рассчитывать скидки в диалоге с клиентом на основе их истории покупок.
Проблемы и решения при работе с MCP
| Проблема | Причина | Решение |
|---|---|---|
| MCP-сервер не отвечает | Сервис не запущен или неверный порт | Проверить логи: journalctl -u openclaw -n 50 |
| Таймаут при запросе к БД | Плохое соединение или перегруженный сервер | Увеличить timeout в конфиге, проверить DB-соединение |
| Агент не использует нужный инструмент | Плохое описание инструмента или неправильный контекст | Переписать описание на более понятный язык |
| Ошибки в логах при запуске | Синтаксическая ошибка в JSON или отсутствие зависимостей | Валидировать JSON, установить npm-пакеты |
| Интеграция работает на тесте, но не в продакшене | Разные переменные окружения или IP-адреса | Проверить .env файлы для dev и prod |
Безопасность при работе с MCP
Когда вы даёте AI-агенту доступ к вашим системам через MCP, нужно соблюдать несколько правил безопасности:
.env файлы и переменные окруженияПример безопасной конфигурации:
# Создать отдельного пользователя для БД createuser -P openclaw_readonlyВыдать минимальные права
GRANT SELECT ON ALL TABLES IN SCHEMA public TO openclaw_readonly;Сохранить пароль в .env
echo "DB_USER=openclaw_readonly" >> .env echo "DB_PASSWORD=strong_password_here" >> .envУбедиться, что .env в .gitignore
echo ".env" >> .gitignore
Итого
MCP-серверы превращают OpenClaw из простого чат-бота в полноценный инструмент автоматизации. Они позволяют вашему AI-агенту:
- Работать с реальными данными из баз и API
- Выполнять действия в ваших системах
- Интегрироваться с CRM, аналитикой и другими инструментами
- Предоставлять персонализированные ответы на основе контекста
Если вам нужна полная настройка под ваш бизнес, команда openclawinstall.ru поможет интегрировать все необходимые сервисы. От выбора архитектуры до полного развёртывания в боевой среде — всё под ключ.