Меню документации

OpenCode

На этой странице

Используйте локальный MCP-сервер в OpenCode для рабочей области проекта. Установите Node.js версии 22 или новее и убедитесь, что OpenCode может запускать npx.

  1. Откройте каталог проекта.

  2. Добавьте owlmeans в opencode.json:

    Настройки MCP в OwlMeans: 1 — предпочтительный режим инференса; 2 — вкладки настройки клиентов.
    Настройки MCP в OwlMeans: 1 — предпочтительный режим инференса; 2 — вкладки настройки клиентов.
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "owlmeans": {
      "type": "local",
      "command": ["npx", "-y", "@owlmeans/viable-mcp@^0.1.18", "--harness", "opencode"],
      "enabled": true,
      "timeout": 90000
    }
  }
}
  1. Перезапустите OpenCode и проверьте состояние сервера командами MCP.
  2. Когда OwlMeans запросит доступ, авторизуйтесь через браузер.

Для работы только с облачными проектами в определении удалённого сервера используются type: "remote" и url: "https://api.owlmeans.com/mcp". Для поддерживаемой удалённой авторизации в OpenCode доступны команды mcp auth, mcp list и mcp logout. См. официальное руководство по MCP.

В одной сессии задавайте только одну конфигурацию сервера owlmeans. В массиве команда и аргументы записаны отдельно, что исключает проблемы с кавычками в оболочке.

Проверка подключения

  1. Когда появится запрос, войдите в OwlMeans через браузер.
  2. Попросите агента вызвать describe_platform и session_status.
  3. Убедитесь, что выбраны нужные проект, рабочая область и режим инференса.
  4. Попросите агента проверить или установить harness проекта.
  5. Запустите небольшой рабочий процесс генерации приложения или разработки пользовательской истории.

В примерах используется локальное расположение проекта. Для облачного проекта добавьте --target, cloud как отдельные аргументы. Добавляйте --llm, local для делегированного инференса, только если задачи будет обрабатывать подключённый агент программирования. Последствия и затраты описаны на странице о выборе режима.

Не сохраняйте токены доступа в конфигурации, попадающей в коммиты. После изменения настроек сервера перезапустите клиент. Если инструмент отсутствует, проверьте список инструментов подключённого сервера и обратитесь к руководству по устранению неполадок.

Названия и товарные знаки

OpenAI, ChatGPT и связанные с ними товарные знаки OpenAI принадлежат OpenAI; Codex — продукт OpenAI. Правила использования.

Claude и Claude Code — продукты Anthropic; их названия и товарные знаки остаются собственностью соответствующего владельца. Правила использования.

Названия Node.js, npx, OpenCode и все связанные с ними товарные знаки остаются собственностью соответствующих владельцев или сопровождающих проектов. Упоминания обозначают продукты, стандарты или примеры исходного кода. Документация OwlMeans не подразумевает спонсорской поддержки или одобрения со стороны этих владельцев.