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

OpenCode

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

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

Настройки MCP в OwlMeans: 1 — предпочтительный режим инференса; 2 — вкладки настройки клиентов.
Настройки MCP в OwlMeans: 1 — предпочтительный режим инференса; 2 — вкладки настройки клиентов.
  1. Откройте каталог проекта.
  2. Добавьте owlmeans в opencode.json:
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "owlmeans": {
      "type": "local",
      "command": ["npx", "-y", "@owlmeans/viable-mcp@^0.1.18-rc.50", "--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. Попросите агента проверить или установить комплект инструкций проекта для агента.
  5. Запустите небольшой процесс генерации приложения или разработки пользовательской истории.

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

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

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

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

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

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