ПаветтаПаветта

Как подключить MCP-сервер к OpenCode

Anomaly· Проверено 12.11.2026

OpenCode запускает локальные MCP-серверы через stdio и подключает удалённые по Streamable HTTP. Серверы лежат в разделе mcp файла opencode.json, команда opencode mcp add записывает их сама.

Где лежит конфиг

opencode.json или opencode.jsonc в папке проектаДля одного проекта
~/.config/opencode/opencode.jsonДля всех проектов

Как добавить сервер

1
Удалённый сервер

opencode mcp add context7 --url https://mcp.context7.com/mcp. С --global сервер появится во всех проектах.

2
Локальный сервер

opencode mcp add everything --env LOG_LEVEL=info -- npx -y @modelcontextprotocol/server-everything.

3
Заголовки

--header 'CONTEXT7_API_KEY={env:CONTEXT7_API_KEY}'. Кавычки нужны, чтобы оболочка записала {env:...} как есть.

4
Через файл, формат V2

mcp → servers → <имя>: "type": "local" и command списком из команды и аргументов, или "type": "remote" и url.

5
Через файл, формат V1

mcp → <имя> с полем enabled. OpenCode 2 по-прежнему читает этот формат.

Как проверить и удалить

Проверкаopencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
УдалениеУдалите запись сервера из проектного или глобального конфига. Чтобы сохранить настройки без подключения, поставьте "disabled": true, в формате V1 — "enabled": false.
ПеременныеПишите {env:NAME} в environment и headers. Выражения вида $NAME в JSON не раскрываются.
Вход через OAuthOAuth у удалённых серверов включён по умолчанию. Вход: /mcps → сервер, или opencode mcp auth <имя>. Выход: opencode mcp logout <имя>.
Сервер только с ключомЕсли сервер принимает один ключ в заголовке, поставьте "oauth": false и передайте ключ в headers.
Тайм-аутыВ V2 тайм-ауты в миллисекундах: startup и catalog по 30 секунд, execution 12 часов.
Имена инструментовИнструмент называется <сервер>_<инструмент>, символы кроме букв, цифр, _ и - заменяются на _.

Готовые конфиги для OpenCode

Нажмите на сервер, чтобы раскрыть конфиг в формате OpenCode.

Playwright MCPДаёт агенту настоящий браузер
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "playwright": {
        "type": "local",
        "command": ["npx", "@playwright/mcp@latest"]
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

GitHub MCPПодключает агента к GitHub
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "github": {
        "type": "remote",
        "url": "https://api.githubcopilot.com/mcp/",
        "headers": {
          "Authorization": "Bearer <GitHub PAT>"
        }
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

Context7 MCPПодтягивает в контекст агента свежую документацию и примеры кода…
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "context7": {
        "type": "remote",
        "url": "https://mcp.context7.com/mcp",
        "headers": {
          "Authorization": "Bearer <ключ Context7>"
        }
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

Figma MCPПодключает агента к макетам Figma
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "figma": {
        "type": "local",
        "command": ["npx", "-y", "figma-developer-mcp", "--stdio"],
        "environment": {
          "FIGMA_API_KEY": "<ваш токен Figma>"
        }
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

Chrome DevTools MCPДаёт агенту живой Chrome с инструментами DevTools
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "chrome-devtools": {
        "type": "local",
        "command": ["npx", "-y", "chrome-devtools-mcp@latest"]
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

Filesystem MCPОткрывает агенту доступ к файлам в папках, которые вы перечислили при…
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "filesystem": {
        "type": "local",
        "command": [
          "npx",
          "-y",
          "@modelcontextprotocol/server-filesystem",
          "/Users/username/Desktop",
          "/path/to/other/allowed/dir"
        ]
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

Fetch MCPДаёт агенту читать веб-страницы
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "fetch": {
        "type": "local",
        "command": ["uvx", "mcp-server-fetch"]
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

Memory MCPДаёт агенту долгую память между чатами
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "memory": {
        "type": "local",
        "command": ["npx", "-y", "@modelcontextprotocol/server-memory"],
        "environment": {
          "MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
        }
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

Supabase MCPПодключает агента к проектам Supabase
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "supabase": {
        "type": "remote",
        "url": "https://mcp.supabase.com/mcp"
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

Notion MCPЛокальный сервер Notion поверх Notion API
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "notion": {
        "type": "local",
        "command": ["npx", "-y", "@notionhq/notion-mcp-server"],
        "environment": {
          "NOTION_TOKEN": "ntn_<токен интеграции>"
        }
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

Blender MCPСвязывает агента с запущенным Blender
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "blender": {
        "type": "local",
        "command": ["uvx", "mcp-for-blender"]
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

1С MCPПоказывает агенту метаданные и содержимое базы 1С:Предприятие
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "1c": {
        "type": "remote",
        "url": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
        "headers": {
          "Authorization": "Basic <логин и пароль пользователя 1С>"
        }
      }
    }
  }
}

Страница сервера: инструменты, ключи, ограничения

Ограничения

!

SSE в списке нет: удалённый сервер подключается по Streamable HTTP и требует абсолютный URL.

!

Проектный конфиг с тем же именем сервера заменяет объект сервера целиком.

!

Инструменты MCP занимают контекст модели, поэтому подключайте только нужные серверы.

Если не работает

В списке сервер с пометкой needs authentication
Откройте OpenCode, введите /mcps, выберите сервер и войдите.
Вход через браузер не завершается по SSH или в контейнере
Скопируйте адрес страницы, которая не загрузилась, и вставьте его в OpenCode.

Частые вопросы

Где у OpenCode настройки MCP?
В opencode.json или opencode.jsonc проекта либо в ~/.config/opencode/opencode.json для всех проектов. Серверы лежат в разделе mcp.
Какой формат конфига выбрать, V1 или V2?
OpenCode 2 читает оба. В V2 серверы лежат в mcp.servers и выключаются полем disabled, в V1 — прямо в mcp с полем enabled.
Как передать ключ API?
Через переменную окружения: "{env:MCP_API_KEY}" в environment локального сервера или в headers удалённого.
Как отключить сервер, не удаляя его?
Поставьте "disabled": true в V2 или "enabled": false в V1. Отключение в /mcps конфиг не меняет.

Источники: opencode.ai, github.com, github.com, github.com, github.com, github.com