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

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

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

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

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

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

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

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

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

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

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

export MAGUYVA_API_KEY=mgv_xxxx

Працюєте в команді? Додайте --scope project до обох команд /plugin, щоб зафіксувати плагін у .claude/settings.json репозиторію — тоді команда отримає його автоматично.

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

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

Формат трохи відрізняється залежно від клієнта (VS Code вкладає це під servers із type: "http", Windsurf використовує serverUrl, Zed використовує context_servers). Замініть mgv_xxxx на свій API-ключ і перезапустіть клієнт. Точна конфігурація для всіх 24 задокументованих клієнтів — у Посібник зі встановлення.

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

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

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

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

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