Перейти до вмісту
Меню документації

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.2.0", "--harness", "opencode"],
      "enabled": true,
      "timeout": 90000
    }
  }
}
  1. Перезапустіть OpenCode і перевірте стан сервера за допомогою команд 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 проєкту за інструкцією «Установіть і використовуйте harness свого проєкту».
  5. Запустіть невеликий робочий процес генерації або розробки історії.

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

Не додавайте токени доступу до конфігурації, яку зберігаєте в комітах. Після зміни налаштувань сервера перезапустіть клієнт. Якщо інструмента немає, перегляньте список інструментів підключеного сервера та усуньте неполадки.

Назви й торговельні марки

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

Claude і Claude Code — продукти Anthropic; їхні назви й торговельні марки належать відповідному власнику. Правила використання.

Назви Node.js, npx, OpenCode і всі повʼязані торговельні марки належать відповідним власникам або супровідникам проєктів. Ці назви наведено, щоб указати на відповідні продукти, стандарти або приклади вихідного коду. Згадки в документації OwlMeans не означають, що ці власники спонсорують чи схвалюють OwlMeans.