Для користувачів OpenCode

AGENTS.md повідомляє OpenCode ваші правила.
Maguyva показує йому код.

OpenCode бере з AGENTS.md те, як працювати, а по все інше звертається до MCP-серверів. Maguyva — віддалений MCP-сервер, який дає OpenCode карту вашого репозиторію з можливістю запитів, зі шляхами до файлів і номерами рядків.

Почати безкоштовно Читати про налаштування OpenCode

Тариф Free: 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію, без кредитної картки.

Один віддалений запис у mcp. Локально нічого не запускається.

Що треба знати про OpenCode

Чотири факти саме про OpenCode.

// файл конфігурації

opencode.json

Додайте сервер у mcp в opencode.json проєкту або в ~/.config/opencode/opencode.json для всіх проєктів.

// транспорт

type: remote

OpenCode підключається до точки доступу Maguyva через HTTP. Локально нічого не запускається, Node.js не потрібен.

// ключ

Посилання на змінну середовища

OpenCode підставляє змінні середовища у свою конфігурацію, тож заголовок має вигляд Bearer {env:MAGUYVA_API_KEY}, а ключ не потрапляє у файл, який ви комітите.

// бюджет контексту

Обмежте за агентами

Кожен MCP-сервер додає в контекст описи інструментів. В OpenCode можна глобально вимкнути інструменти сервера glob-шаблоном на кшталт "maguyva*": false і ввімкнути їх знову лише для тих агентів, яким вони потрібні.

AGENTS.md — це робоча домовленість. Користуйтеся ним.

> /init
# сканує репозиторій і пише AGENTS.md

OpenCode читає AGENTS.md у корені проєкту і ~/.config/opencode/AGENTS.md з особистими правилами. Якщо AGENTS.md немає, він бере CLAUDE.md. Тримайте в ньому:

Команди збирання, тестів і lint.
Домовленості й межі, яких агент має дотримуватися.
Посилання на справді важливу документацію.

Скан у момент /init — це підсумок, а не індекс. Він не скаже OpenCode, хто викликає функцію, додану вчора.

Де AGENTS.md уже замало

Три прогалини, які OpenCode закриває за допомогою grep і терпіння.

// підсумок — це не індекс

AGENTS.md може назвати важливі пакети. Перелічити всі символи й місця виклику він не може, та й не повинен пробувати.

// grep знаходить рядки, а не викликачів

Текстовий збіг не відрізняє справжній виклик від коментаря, мока чи однойменного методу іншого класу.

// файл відстає

AGENTS.md правильний у день, коли його написали. Код і далі змінюється, а файл оновлюється, коли хтось про це згадає.

Maguyva як віддалений MCP-сервер в OpenCode

Один запис у mcp дає OpenCode:

11 інструментів для вашого проіндексованого репозиторію семантичний, структурний (AST), графовий і текстовий пошук, а також пошук символів, залежні та отримання файлів.
Відповіді зі шляхами до файлів і номерами рядків у понад 285 мовах.
Однакові відповіді для будь-якої моделі OpenCode працює з багатьма постачальниками моделей. Maguyva повертає ту саму карту, хоч яка модель питає.

AGENTS.md каже OpenCode, як працювати.
Maguyva дає OpenCode те, на що спертися.

Два робочі процеси

Питайте карту в тому самому терміналі.

// workflow 01

Перейменувати спільний тип у кількох пакетах

opencode> перейменуй OrderStatus на FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 посилання у 8 пакетах
structural_search(switch_statement, "OrderStatus")
  4 вичерпні switch

→ OpenCode править увесь список, разом зі switch.
[exit 0]

Вичерпні switch — саме ті місця, які текстовий пошук пропускає, а компілятор ловить пізно.

// workflow 02

Відрізнити код від документації

opencode> де читається FEATURE_BULK_EXPORT?

text_pattern_search("FEATURE_BULK_EXPORT")
  src/config/flags.ts:17
  src/export/bulk.ts:5
  docs/flags.md:40   ← лише документація

→ Два шляхи в коді, один застарілий документ.
[exit 0]

Точні збіги приходять зі шляхами, тож OpenCode відрізняє код від документації, перш ніж правити щось одне.

Налаштування в OpenCode

Три кроки. Тариф Free: 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію, без кредитної картки.

// step 01

Проіндексуйте репозиторій на maguyva.ai

Оберіть той, який ви вже знаєте, щоб оцінити відповіді.

// step 02

Додайте Maguyva в mcp в opencode.json

opencode.json

{
  "mcp": {
    "maguyva": {
      "type": "remote",
      "url": "https://maguyva.tools/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

Експортуйте ключ і перевірте підключення

Задайте MAGUYVA_API_KEY в оболонці, з якої запускається OpenCode. opencode mcp list показує всі налаштовані сервери; потім поставте запитання, відповідь на яке вже знаєте.

Самостійна реєстрація відкрита.

Проіндексуйте один репозиторій, який ви вже добре знаєте.

Підключіть OpenCode через MCP і поставте запитання, яке можна перевірити.

Проіндексуйте свій перший репозиторій Переглянути документацію про сумісність

тариф Free: 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію, без кредитної картки.