# Руководство по установке

Canonical source: https://maguyva.ai/ru/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/ru/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
- Как это работает: Разберитесь в оптимизации контекста
- Устранение неполадок: Решите проблемы установки и подключения