# Посібник із встановлення

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

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).

Почніть роботу менш ніж за 5 хвилин. Цей посібник містить налаштування для 23 MCP-клієнтів, зокрема Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT, і Warp та інших.

**Передумови**: вам знадобиться API-ключ із [app.maguyva.ai](https://app.maguyva.ai) та підключений репозиторій GitHub.

## Налаштування середовища

Спочатку збережіть свій API‑ключ у змінній середовища. Пропускайте `repository`, коли ваш клієнт MCP надає значення за замовчуванням у межах запиту або ключ має доступ лише до одного репозиторію; інакше передавайте його явно.

### macOS/Linux (Bash/Zsh)

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

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

Замініть `mgv_xxxx` на свій реальний API-ключ із [app.maguyva.ai](https://app.maguyva.ai).

## Конфігурація клієнта

Оберіть свій MCP-клієнт нижче, щоб отримати конкретні інструкції з налаштування.

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

Maguyva використовує стандартний MCP. Підключитися може будь-який клієнт, що підтримує цей протокол, — навіть якщо офіційного посібника вище немає. Задокументовано 23 клієнтів, і список регулярно поповнюється.

## Перевірте своє налаштування

Після підключення спробуйте поставити своєму агенту кілька запитань:

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

Ви маєте побачити результати зі шляхами до файлів і номерами рядків із вашого підключеного репозиторію. Якщо ні, перегляньте розділ [troubleshooting](https://maguyva.ai/uk/docs/troubleshooting) нижче.

## Формат репозиторію

Коли вказуєте репозиторії:

- З гілкою: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Гілка за замовчуванням: `"owner/repo"`

**Порада**: перевірте визначення репозиторію за допомогою `repository_context(action="info", repository="...")`. Перевизначення репозиторію діє лише для поточного виклику.

## Усунення несправностей

### Проблеми з API-ключем

- Перевірте, що ваш ключ починається з префікса mgv_
- Перевірте, що ключ правильно встановлено у вашому середовищі
- Переконайтеся, що термін дії ключа не закінчився

### Репозиторій не знайдено

- Перевірте, що репозиторій підключено в app.maguyva.ai
- Перевірте правильність формату owner/repo
- Переконайтеся, що у вас є доступ до репозиторію

### Проблеми з підключенням MCP

- Якщо клієнт використовує міст @maguyva/mcp, перевірте доступність npx у PATH
- Перевірте, що ваш API-токен дійсний і термін його дії не закінчився
- Перевірте з'єднання з https://maguyva.tools/mcp
- Перевірте синтаксис конфігурації MCP вашого клієнта

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

- Довідник MCP API: Повна документація API
- Як це працює: Розберіться в оптимізації контексту
- Усунення несправностей: Вирішення проблем із налаштуванням і підключенням