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