MCP (Model Context Protocol) — стандарт, через который OpenClaw общается с внешними инструментами: базами данных, браузерами, корпоративными системами, памятью между сессиями. В этой статье — пошаговая инструкция, как подключить любой MCP-сервер к OpenClaw, и готовые рецепты для самых востребованных: PostgreSQL, Playwright, Puppeteer, Scrapling, memory, 1С.
Что такое MCP и зачем он нужен — в глоссарии.
Где живёт конфигурация MCP в OpenClaw
OpenClaw читает MCP-серверы из двух мест (в порядке приоритета):
- Глобально:
~/.openclaw/mcp.json— серверы, доступные во всех проектах. - На проект:
.openclaw/mcp.jsonв корне проекта — серверы только для этого проекта.
Базовая структура одинаковая:
{
"mcpServers": {
"имя-сервера": {
"command": "запускающая-команда",
"args": ["аргумент1", "аргумент2"],
"env": {
"API_KEY": "..."
}
}
}
}После изменения файла перезапустите OpenClaw (или выполните /mcp reload в чате).
Как проверить, что MCP подключился
openclaw mcp listДолжны появиться все настроенные серверы со статусом connected и списком инструментов. Если статус error — смотрите логи: openclaw mcp logs имя-сервера.
Рецепт 1: PostgreSQL MCP
Позволяет агенту читать схему БД, делать SELECT-запросы, объяснять данные. По умолчанию — read-only.
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost:5432/mydb"]
}
}
}После подключения агент сможет:
> Покажи схему таблицы orders и top-10 заказов за последний месяцПодробный сценарий — OpenClaw + PostgreSQL.
Рецепт 2: Playwright MCP (браузерная автоматизация)
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"]
}
}
}Агент получает инструменты browser_navigate, browser_click, browser_fill, browser_screenshot — может ходить по сайтам, заполнять формы, делать скриншоты.
Пример задачи:
> Зайди на wildberries, найди iPhone 16 Pro 256GB, сделай скриншот первых 5 предложений и сохрани цены в prices.jsonПолный гид — Playwright и OpenClaw.
Рецепт 3: Puppeteer MCP
Альтернатива Playwright, легче и старше:
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-puppeteer"]
}
}
}Выбирайте Puppeteer, если уже используете его в проекте; Playwright — если стартуете с нуля (лучше работает с современными сайтами).
Рецепт 4: Scrapling MCP (скрейпинг с обходом защит)
Scrapling — Python-библиотека для веб-скрейпинга с anti-bot защитой. MCP-обёртка позволяет звать её из OpenClaw:
{
"mcpServers": {
"scrapling": {
"command": "uvx",
"args": ["scrapling-mcp"],
"env": {
"SCRAPLING_USER_AGENT": "Mozilla/5.0 ..."
}
}
}
}Используйте, если Playwright/Puppeteer блокируются Cloudflare, Akamai или другими WAF. Подходит для мониторинга цен на маркетплейсах.
Рецепт 5: Memory MCP — постоянная память между сессиями
Без этого MCP агент забывает всё после закрытия чата. С ним — помнит факты о вас, проекте, прошлых решениях.
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"],
"env": {
"MEMORY_FILE_PATH": "~/.openclaw/memory.json"
}
}
}
}Альтернатива — встроенная персистентная память OpenClaw, которая работает без отдельного MCP.
Рецепт 6: 1С MCP-сервер
Для интеграции с 1С есть community-обёртка над HTTP-сервисами 1С:
{
"mcpServers": {
"1c": {
"command": "node",
"args": ["/path/to/1c-mcp-server/index.js"],
"env": {
"ONEC_BASE_URL": "http://1c-server.local/base/hs/api",
"ONEC_USER": "openclaw",
"ONEC_PASSWORD": "***"
}
}
}
}Готовых публичных пакетов мало — обычно пишут под конкретную конфигурацию 1С через HTTP-сервисы или OData. Подробный кейс — OpenClaw для 1С и Консультант+.
Рецепт 7: подключение сразу нескольких MCP
Реальный .openclaw/mcp.json обычно объединяет 3–5 серверов:
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://..."]
},
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"]
},
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/Documents"]
}
}
}Агент сам выбирает нужный инструмент под задачу. Лимит — внимательно следите за токенами: каждый MCP добавляет схему инструментов в контекст.
Безопасность: что важно знать
- Никогда не храните пароли в
mcp.jsonв репозитории. Используйтеenvс переменными окружения или 1Password CLI. - Включайте allowlist путей для filesystem MCP — иначе агент может прочитать что угодно на диске.
- PostgreSQL MCP по умолчанию read-only, но проверьте права пользователя БД — лучше создайте отдельную read-only роль.
- MCP-серверы из community проверяйте. Скачивайте только с известных репозиториев, читайте код, см. как проверить навыки ClawHub.
Типичные ошибки и решения
MCP server "X" exited with code 1 — обычно битый command или args. Запустите команду вручную: npx -y @modelcontextprotocol/server-postgres postgresql://... — увидите реальную ошибку.
Инструменты не появляются в OpenClaw — проверьте openclaw mcp list. Если статус connected, но tools пусто — сервер сам не отдаёт схему (баг сервера или старая версия).
Высокое потребление токенов после добавления MCP — каждый сервер добавляет описание инструментов в системный промпт. Уберите неиспользуемые, особенно если у MCP десятки тулов.
npx качает пакет при каждом запуске — глобально установите серверы (npm i -g @modelcontextprotocol/server-postgres) и используйте прямую команду вместо npx.
Что дальше
- Написать собственный MCP-сервер — для внутренних инструментов
- MCP Coupler для корпоративных данных
- OpenClaw для 1С и Консультант+ — российский enterprise
- Permissions: ограничение прав MCP
Что такое MCP и какие бывают серверы — в отдельном разделе: объяснение простыми словами, обзор готовых серверов и безопасность.