MCP в OpenClaw: когда встроенных инструментов недостаточно

Model Context Protocol (MCP) — способ подключить к OpenClaw специализированные внешние сервисы. Но прежде чем использовать MCP, стоит понять: OpenClaw уже умеет многое из коробки, и для базовых задач MCP не нужен.

В этой статье разберём:

1. Что уже умеет OpenClaw — и зачем тогда MCP
2. Когда MCP реально полезен — примеры, где встроенных инструментов недостаточно
3. Как подключить — через агента или вручную

Что уже умеет OpenClaw (MCP не нужен)

Прежде чем подключать MCP, проверьте — возможно, OpenClaw уже умеет это:

Задача	Что есть в OpenClaw	Нужен ли MCP
Работа с файлами	Агент читает, пишет, ищет файлы через встроенные инструменты	❌ Нет
Память между разговорами	QMD, workspace, memory system	❌ Нет
Поиск в интернете	web_fetch, web_search, Parallel, Brave, DuckDuckGo	❌ Нет
Управление браузером	Browser tool (Chrome CDP) — скриншоты, навигация, клики	❌ Нет
Запуск команд	Exec — выполнение bash, python, node и др.	❌ Нет
Работа с Git	Exec + git команды, скиллы для репозиториев	❌ Нет
Работа с API	Curl, fetch через exec или скиллы	⚠️ Иногда удобнее через MCP

Вывод: если задача из таблицы выше — скорее всего, MCP не нужен. Встроенные инструменты проще и надёжнее.

Когда MCP реально полезен

MCP нужен, когда вам нужно подключить специализированный сервис, для которого нет удобного встроенного инструмента в OpenClaw. Ниже — только подтверждённые MCP-серверы из официального репозитория Anthropic.

1. Базы данных (PostgreSQL, SQLite)

OpenClaw умеет запускать sqlite3 через exec. Но MCP даёт структурированный доступ:

• Агент видит схему базы (таблицы, колонки, типы)
• Выполняет типизированные запросы с автоматической валидацией
• Работает с транзакциями и пулами соединений
• Не нужно писать SQL-скрипты вручную — агент формирует запросы сам

Запрос агенту:

Подключи мне PostgreSQL на localhost:5432, база myproject.
Нужен доступ только для чтения.

Пакет: @modelcontextprotocol/server-postgres

2. Slack как инструмент (не канал)

OpenClaw умеет получать сообщения из Slack как канал. Но MCP позволяет отправлять сообщения и управлять сервером:

• Отправлять сообщения в определённые каналы по запросу
• Создавать треды
• Управлять реакциями
• Получать список участников

Запрос агенту:

Подключи мне Slack API, чтобы агент мог отправлять 
уведомления в канал #alerts.

Пакет: @modelcontextprotocol/server-slack (официальный репозиторий Anthropic, сейчас поддерживается Zencoder)

3. Внутренние API компании

Если у вашей компании есть внутренний API (CRM, ERP, логистика, биллинг):

• Напишите простой MCP-сервер на Node.js или Python
• Агент получит структурированный доступ к вашему API
• Не нужно писать сложный скилл с парсингом ответов

Запрос агенту:

Подключи мне наш внутренний API по адресу https://api.company.com.
Нужны методы: get_orders, create_ticket, search_customers.

Что ещё существует, но мы не подтвердили

Помимо официальных серверов Anthropic, сообщество создаёт десятки MCP-серверов для Google Workspace, Notion, Jira, Stripe и других сервисов. Перед использованием проверяйте: есть ли готовый MCP-сервер, и есть ли для этой задачи скилл в ClawHub. Сравнение — в статье MCP или скилл.

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

Простой способ: попросите агента

OpenClaw умеет сам настраивать MCP. Просто опишите задачу — и агент найдёт подходящий сервер, установит и настроит.

Примеры запросов:

Подключи мне PostgreSQL на localhost:5432, база myproject, 
только чтение. Проверь подключение.

Настрой доступ к моему Google Calendar через MCP.

Подключи Notion, у меня есть интеграция с API-ключом.

Агент сделает:

1. Найдёт подходящий MCP-сервер
2. Установит через npx
3. Пропишет в ~/.openclaw/openclaw.json
4. Проверит подключение (openclaw mcp doctor)
5. Сообщит, какие инструменты доступны

⚠️ Агенту понадобится разрешение на выполнение команд. В зависимости от настроек, OpenClaw может попросить подтвердить действие.

Ручная настройка (если нужен контроль)

Если агент не может выполнять команды или вы хотите сами управлять конфигурацией:

В файле ~/.openclaw/openclaw.json, секция mcp.servers:

{
  mcp: {
    servers: {
      postgres: {
        command: "npx",
        args: ["-y", "@modelcontextprotocol/server-postgres"],
        env: {
          DATABASE_URL: "postgresql://user:pass@localhost:5432/myproject",
        },
        toolFilter: {
          include: ["query", "describe_table"],
          exclude: ["write_*", "delete_*"],
        },
      },
    },
  },
}

Основные поля:

Поле	Описание	Пример
command	Программа для запуска	"npx"
args	Аргументы	["-y", "@modelcontextprotocol/server-postgres"]
env	Переменные окружения	{ "DATABASE_URL": "..." }
url	Адрес удалённого сервера	"https://api.example.com/mcp"
transport	"streamable-http" или "sse"	"streamable-http"
toolFilter.include	Разрешённые инструменты	["query", "describe_table"]
toolFilter.exclude	Запрещённые инструменты	["write_*", "delete_*"]
enabled	Включён ли сервер	true

Проверка и диагностика

Через агента

Какие MCP-серверы у меня сейчас подключены?

Проверь подключение к PostgreSQL через doctor.

Через командную строку

# Список серверов
openclaw mcp list

# Проверка конфигурации
openclaw mcp doctor postgres

# Проверка с реальным подключением
openclaw mcp doctor postgres --probe

# Сбросить кеш после изменений
openclaw mcp reload

Безопасность

1. Фильтруйте инструменты

Не давайте серверу больше прав, чем нужно. Если агенту достаточно читать из базы — запретите запись:

Подключи PostgreSQL, но только для чтения. 
Запрети создание, изменение и удаление таблиц.

Или вручную в toolFilter:

toolFilter: {
  include: ["query", "describe_table"],
  exclude: ["write_*", "delete_*", "drop_*"],
}

2. Проверяйте перед запуском

После настройки:

openclaw mcp doctor <имя> --probe

3. Не храните секреты в открытом виде

API-ключи и пароли лучше в переменных окружения (~/.openclaw/.env), не прямо в openclaw.json.

Сравнение: встроенные инструменты vs MCP

Задача	Встроенные инструменты	MCP
Прочитать файл	✅ read_file в скилле	Не нужен
Запомнить контекст	✅ QMD, memory	Не нужен
Найти в интернете	✅ web_fetch, web_search	Не нужен
Скриншот сайта	✅ Browser tool (CDP)	Не нужен
Запрос к PostgreSQL	❌ Только через exec	✅ Структурированный доступ
Google Calendar	❌ Нет встроенного	✅ Через MCP
Notion	❌ Нет встроенного	✅ Через MCP
Внутренний API компании	❌ Нужен скилл	✅ MCP-сервер проще скилла

Полезные ссылки

• Официальная документация MCP в OpenClaw — исходный файл из репозитория
• Репозиторий MCP-серверов — официальные и community-серверы
• Спецификация MCP — описание протокола от Anthropic
• OpenClaw 2026.6.8 — в этом релизе добавлен Streamable HTTP для MCP
• CLI-справочник — все команды OpenClaw