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

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

Начать бесплатно — банковская карта не нужна. Ваш API-ключ (начинается с mgv_) находится в app.maguyva.ai.

Подключите репозиторий GitHub через портал и дождитесь индексации. Выберите небольшой репозиторий, который можно быстро проверить вручную, а не пытайтесь сразу в первый день проиндексировать всю компанию — так сразу станет ясно, действительно ли Maguyva обосновывает ответы модели.

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

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

Плагин авторизуется с помощью ключа из переменной окружения MAGUYVA_API_KEY. Задайте её в своей оболочке (рекомендуется direnv на уровне проекта, поскольку ключи привязаны к репозиторию):

export MAGUYVA_API_KEY=mgv_xxxx

Работаете в команде? Выберите область project в панели, которую открывает /plugin install maguyva@maguyva. Плагин будет записан в .claude/settings.json репозитория, который вы коммитите; каждому коллеге всё равно нужно один раз выполнить установку. У команд /plugin внутри сеанса нет флага --scope, поэтому для автоматизации выполните shell-вариант из корня репозитория:

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:

{
  "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 задокументированных клиентов см. в разделе «Руководство по установке».

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

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

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