Перейти к содержимому

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

Самый быстрый путь от нуля до проверенного ответа: получите ключ, проиндексируйте один знакомый вам репозиторий, подключите клиент и задайте один вопрос, ответ на который вы уже знаете.

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 и им подобные) подключаются к удалённому серверу напрямую — укажите им эндпоинт с заголовком 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 или репозитории, индексация которого ещё не завершена.

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