--- title: Подключение MCP-серверов к OpenCode: настройка и примеры slug: opencode-mcp description: Как настроить MCP-серверы в OpenCode: конфигурация, популярные серверы, примеры подключения БД, браузера и API. Полное руководство по mcp opencode. keywords: [opencode mcp, mcp серверы opencode, настроить mcp, mcp конфигурация, mcp серверы] h1: Подключение MCP-серверов к OpenCode: настройка и примеры category: OpenCode tags: [opencode, mcp, интеграции, инструменты] date: 2026-08-20 image: /images/articles/opencode-mcp.webp image_alt: Подключение MCP-серверов к OpenCode — схема интеграций reading_time: ~8 мин author: Refertur canonical: https://ai-courses.refertur.net/articles/opencode-mcp/ faq: - q: Что такое MCP-серверы в OpenCode? a: MCP (Model Context Protocol) — это протокол, который позволяет ИИ-агенту подключаться к внешним инструментам и данным: базам данных, браузеру, файлам, API. MCP-серверы в OpenCode расширяют возможности агента, давая ему доступ к реальным системам, а не только к коду проекта. - q: Как настроить MCP-сервер в OpenCode? a: Настроить MCP-сервер в OpenCode можно через файл конфигурации opencode.json в секции mcp: указать имя сервера, команду запуска (npx, uvx, docker) и параметры. После перезапуска OpenCode сервер появится в списке доступных инструментов. - q: Какие MCP-серверы самые популярные для OpenCode? a: Популярные MCP-серверы для OpenCode: filesystem (работа с файлами), postgres (базы данных), browser (управление браузером), github (репозитории и PR), memory (память агента), fetch (загрузка веб-страниц). Многие доступны через npm или uvx одной командой. - q: Нужен ли MCP-сервер для работы с базой данных? a: MCP-сервер для базы данных не обязателен, но сильно упрощает работу: агент может выполнять запросы, смотреть схемы и анализировать данные без ручного копирования. Для PostgreSQL используется сервер mcp-server-postgres, для SQLite — mcp-server-sqlite. - q: Безопасно ли подключать MCP-серверы? a: Безопасность MCP-серверов зависит от их происхождения. Рекомендуется использовать проверенные серверы с открытым исходным кодом, ограничивать доступ к чувствительным системам и проверять разрешения в конфигурации. OpenCode запрашивает разрешения на опасные операции. jsonld: {} --- # Подключение MCP-серверов к OpenCode: настройка и примеры Подключение MCP-серверов к OpenCode превращает терминального ИИ-агента в полноценного ассистента, который умеет работать с базами данных, браузером, файлами и внешними API. В этом руководстве разберём, что такое MCP, как настроить mcp серверы в OpenCode и приведём готовые примеры конфигураций. ## Что такое MCP и зачем он нужен MCP (Model Context Protocol) — открытый протокол, созданный для связи ИИ-моделей с внешними инструментами. Вместо того чтобы описывать агенту, как работать с каждой системой, вы подключаете готовый MCP-сервер, и агент сам обнаруживает его возможности. Преимущества MCP: - Агент получает доступ к реальным данным и системам - Один протокол вместо десятков интеграций - Готовая экосистема серверов (npm, PyPI, Docker) - Безопасность через явные разрешения ## Как OpenCode работает с MCP OpenCode автоматически обнаруживает MCP-серверы из конфигурации, запускает их и предоставляет их инструменты агенту. Агент вызывает инструменты MCP так же, как встроенные команды. ### Типы MCP-серверов | Тип | Запуск | Пример | |---|---|---| | stdio | Локальный процесс (npx, uvx) | filesystem, postgres | | HTTP/SSE | Удалённый сервер по URL | браузерные сервисы, API | | Docker | Контейнер | браузер, среда выполнения | ## Настройка MCP-сервера в OpenCode ### Шаг 1: создание конфигурации Откройте файл конфигурации проекта — `opencode.json` в корне проекта (или глобальный `~/.config/opencode/opencode.json`): ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "filesystem": { "type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/user/Projects"] }, "postgres": { "type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost:5432/db"] } } } ``` ### Шаг 2: перезапуск OpenCode После сохранения конфигурации перезапустите OpenCode. Серверы появятся в списке инструментов — проверьте командой `opencode --help` или просто задайте агенту задачу, использующую MCP. ### Шаг 3: проверка подключения ```bash opencode run "покажи список таблиц в базе данных" ``` Если MCP-сервер подключён, агент выполнит запрос к БД и вернёт результат. ## Популярные MCP-серверы и примеры ### Файловая система (filesystem) ```json { "filesystem": { "type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/user/Projects"] } } ``` Позволяет агенту читать, создавать и редактировать файлы за пределами рабочей папки. ### PostgreSQL (база данных) ```json { "postgres": { "type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost:5432/mydb"] } } ``` Агент выполняет SQL-запросы, анализирует схемы и данные. ### Браузер (автоматизация веба) ```json { "browser": { "type": "stdio", "command": "npx", "args": ["-y", "@playwright/mcp@latest"] } } ``` Агент открывает страницы, кликает, заполняет формы и делает скриншоты. ### GitHub ```json { "github": { "type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github", "YOUR_GITHUB_TOKEN"] } } ``` Управление репозиториями, issues и пул-реквестами через агента. ## Таблица: MCP-серверы одной строкой | Сервер | Команда запуска | Назначение | |---|---|---| | Filesystem | `npx @modelcontextprotocol/server-filesystem` | Файлы и папки | | Postgres | `npx @modelcontextprotocol/server-postgres` | База данных PostgreSQL | | SQLite | `npx mcp-server-sqlite` | Локальная база SQLite | | Fetch | `npx mcp-server-fetch` | Загрузка веб-страниц | | Browser (Playwright) | `npx @playwright/mcp` | Управление браузером | | GitHub | `npx @modelcontextprotocol/server-github` | GitHub API | | Memory | `npx @modelcontextprotocol/server-memory` | Постоянная память агента | ## Управление MCP-серверами ### Просмотр подключённых серверов ```bash opencode run "покажи список подключённых MCP-серверов и их инструменты" ``` ### Отключение сервера Удалите блок из конфигурации `opencode.json` и перезапустите OpenCode. ### Локальный MCP-сервер (свой) MCP-сервер можно написать самостоятельно на Python (fastmcp) или TypeScript (SDK). Это позволяет подключить к агенту любую вашу систему: CRM, базу, внутренний API. ## Безопасность MCP Правила безопасности при подключении MCP-серверов: 1. Используйте только проверенные серверы с открытым исходным кодом 2. Не передавайте токены и пароли в открытом виде в конфигурации 3. Ограничивайте доступ файловых серверов только нужными папками 4. Для production-систем используйте HTTP-серверы с аутентификацией 5. Периодически проверяйте логи и разрешения ## Частые ошибки при настройке MCP | Ошибка | Причина | Решение | |---|---|---| | Server not found | npx не установлен | Установите Node.js 20+ или используйте uvx | | Connection refused | Сервер не запустился | Проверьте команду и параметры в конфигурации | | Permission denied | Нет доступа к ресурсу | Настройте права и пути в конфигурации | | Server crashed | Ошибка в сервере | Проверьте версию сервера и обновите | ## Что дальше После настройки MCP-серверов ваш агент получит доступ к внешним системам. Продолжайте изучение: - [Создание агентов в OpenCode](/articles/opencode-agenty/) - [Управление контекстом в OpenCode](/articles/opencode-kontekst/) - [Автономный режим OpenCode](/articles/opencode-avtonomnyj-rezhim/) - [Документация OpenCode (рус.)](/docs/overview/) #### Следующие шаги ## Часто задаваемые вопросы - Что такое MCP-серверы в OpenCode? — Протокол подключения внешних инструментов и данных к агенту. - Как настроить MCP-сервер? — Через секцию mcp в opencode.json: имя, команда, аргументы. - Какие MCP-серверы популярны? — Filesystem, Postgres, Browser, GitHub, Fetch, Memory. - Нужен ли MCP для БД? — Не обязателен, но упрощает работу с данными. - Безопасно ли подключать MCP? — Да, при использовании проверенных серверов и явных разрешений. ## Заключение Подключение MCP-серверов к OpenCode расширяет возможности агента до работы с реальными системами: базами, браузером, файлами и API. Начните с простых серверов (filesystem, fetch) и постепенно подключайте более сложные. Готовы автоматизировать свой бизнес с помощью ИИ-агентов? Свяжитесь с нами. --- *Отчёт создан: refertur@yandex.ru · [refertur.net](https://refertur.net) · [t.me/realhikaz](https://t.me/realhikaz) · [WhatsApp](https://wa.me/+77054384888)* *SEO, продвижение, разработка, сайты, веб-приложения, сервисы, калькуляторы, контент-маркетинг, каталоги, отчёты, аудиты — на заказ. Напишите нам в [WhatsApp](https://wa.me/+77054384888?text=%D0%97%D0%B4%D1%80%D0%B0%D0%B2%D1%81%D1%82%D0%B2%D1%83%D0%B9%D1%82%D0%B5%2C%20%D1%85%D0%BE%D1%87%D1%83%20%D0%B7%D0%B0%D0%BA%D0%B0%D0%B7%D0%B0%D1%82%D1%8C%20%D1%81%D0%B5%D0%BE) — ответим в течение часа.*