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

Canonical source: https://maguyva.ai/uk/docs/quickstart

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

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

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

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

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

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

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

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

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

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

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

```bash
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:

```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 задокументованих клієнтів — у розділі «[Посібник зі встановлення](https://maguyva.ai/uk/docs/installation)».

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

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

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

Немає результатів або виникають помилки з’єднання? Перевірте ключ API, налаштування клієнта й стан індексації репозиторію за інструкціями з розділу «[Усунення несправностей](https://maguyva.ai/uk/docs/troubleshooting)». Якщо використовується міст, перевірте також доступність `npx`.

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

- Посібник зі встановлення: конфігурація для кожного з усіх 23 задокументованих клієнтів
- Як це працює: що відбувається між вашим запитанням і відповіддю
- Довідник MCP API: кожен інструмент, параметр за параметром