Перейти до вмісту

Швидкий старт

Найшвидший шлях від нуля до перевіреної відповіді: отримайте ключ, проіндексуйте один репозиторій, який ви вже знаєте, підключіть свій клієнт і поставте одне запитання, відповідь на яке ви вже можете оцінити.

1. Отримайте API-ключ

#

Почати безкоштовно — кредитна картка не потрібна. Ваш API-ключ (починається з mgv_) зберігається в app.maguyva.ai.

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

#

Підключіть репозиторій GitHub із порталу й дайте йому проіндексуватися. Оберіть невеликий репозиторій, який можна швидко перевірити — так одразу стане зрозуміло, чи справді Maguyva обґрунтовує відповіді моделі, замість того щоб одразу індексувати весь код компанії.

3. Підключіть свій клієнт

#

Для Claude Code встановіть плагін Maguyva з маркетплейсу — виконайте кожну команду всередині Claude Code: 

/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

Плагін автентифікується за допомогою вашого ключа зі змінної середовища MAGUYVA_API_KEY. Встановіть її у своїй оболонці (для кожного проєкту рекомендується direnv, оскільки ключі прив'язані до репозиторію):

export MAGUYVA_API_KEY=mgv_xxxx

Працюєте в команді? Оберіть область project у панелі, яку відкриває /plugin install maguyva@maguyva. Плагін буде записано в .claude/settings.json репозиторію, який ви комітите; кожному колезі все одно потрібно один раз виконати встановлення. Команди /plugin всередині сеансу не мають прапорця --scope, тож для автоматизації виконайте shell-варіант із кореня репозиторію:

claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project

Більшість інших клієнтів (Cursor, VS Code, Devin Desktop, Zed та подібні) підключаються до віддаленого сервера напряму — просто вкажіть їм endpoint із заголовком Bearer, без жодних мостів. Наприклад, .cursor/mcp.json для Cursor:

.cursor/mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Формат трохи відрізняється залежно від клієнта (VS Code вкладає це під servers із type: "http", Antigravity використовує serverUrl, Zed використовує context_servers). Цей приклад для Cursor бере ключ зі змінної середовища MAGUYVA_API_KEY, показаної вище; якщо в конфігурації клієнта натомість є заглушка mgv_xxxx, замініть її своїм API-ключем. Потім перезапустіть клієнт. Точна конфігурація для всіх 23 задокументованих клієнтів — у розділі «Посібник зі встановлення».

4. Поставте одне запитання, відповідь на яке ви вже можете оцінити

#

Почніть із "Які репозиторії в мене підключені?", щоб підтвердити з'єднання, а потім поставте одне реальне запитання про свій репозиторій, відповідь на яке ви вже знаєте — щось на кшталт "Як у цій кодовій базі реалізована автентифікація?"

У відповідь ви маєте отримати шляхи до файлів і номери рядків. Відкрийте зазначені файли й перевірте, чи витримує відповідь зіткнення з реальним репозиторієм. Ця одна перевірена відповідь скаже про інструмент більше, ніж будь-який список можливостей — нехай інструмент заслужить довіру, перш ніж стане частиною вашого щоденного циклу роботи.

Немає результатів або виникають помилки з’єднання? Перевірте ключ API, налаштування клієнта й стан індексації репозиторію за інструкціями з розділу «Усунення несправностей». Якщо використовується міст, перевірте також доступність npx.

Наступні кроки

#

Пов'язане

Читати далі