# Быстрый старт

Canonical source: https://maguyva.ai/ru/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 и им подобные) подключаются к удалённому серверу напрямую — укажите им эндпоинт с заголовком `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/ru/docs/installation)».

## 4. Задайте один вопрос, ответ на который вы уже знаете

Начните с **"Какие репозитории у меня подключены?"**, чтобы убедиться, что соединение работает, затем задайте один реальный вопрос о своём репозитории, ответ на который вам уже известен — например, **"Как в этой кодовой базе реализована аутентификация?"**

В ответ вы должны получить пути к файлам и номера строк. Откройте указанные файлы и проверьте, выдерживает ли ответ столкновение с реальным репозиторием. Этот один проверенный ответ скажет вам больше, чем любой список функций — пусть инструмент заслужит доверие, прежде чем войдёт в ваш обычный рабочий процесс.

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

## Дальнейшие шаги

- Руководство по установке: конфигурация для каждого из 23 задокументированных клиентов
- Как это работает: что происходит между вашим вопросом и ответом
- Справочник MCP API: каждый инструмент, параметр за параметром