Для пользователей Warp

Агент Warp живёт в терминале. Дайте ему карту репозитория.

Агент Warp выполняет команды и читает их вывод. Maguyva индексирует весь репозиторий и отдаёт его через MCP, поэтому агент спрашивает, где лежит код, а не гоняет grep и cat, пока что-нибудь не совпадёт.

Начать бесплатно Читать про настройку Warp

Тариф Free: 3 репозитория, До 50 тыс. проиндексированных строк, без банковской карты.

Одна запись mcpServers в ~/.warp/.mcp.json: URL и заголовок Authorization.

Что нужно знать о Warp

Четыре факта, специфичных для Warp.

// файл конфигурации

~/.warp/.mcp.json

Warp сам запускает серверы из этого глобального файла. Тот же JSON можно вставить в Settings → Agents → MCP servers → + Add.

// транспорт

Удалённо, по URL

Запись с url подключается по Streamable HTTP или SSE. Локально ничего не запускается, Node.js не нужен.

// ключ

Заголовок как есть

Ключ пишется прямо в заголовок Authorization. Держите его в глобальном файле, а не в коммитимом .warp/.mcp.json проекта.

// файлы проекта

Не запускаются сами

Warp находит .warp/.mcp.json в склонированном репозитории, но ждёт, пока вы сами запустите каждый сервер. Если включить опцию, он прочитает и серверы из конфигураций Claude Code и Codex.

Правила проекта — это рабочий договор. Пользуйтесь ими.

# AGENTS.md
- Запускай make test, прежде чем считать изменение готовым.
- Используй скрипты из bin/, а не самодельные команды.

Warp читает правила проекта из AGENTS.md (или из WARP.md, который побеждает, если есть оба) и применяет глобальные правила везде. Используйте их для:

Команд сборки, тестов и деплоя.
Соглашений, в которых агент раз за разом ошибается.
Команд, которые агенту запускать нельзя.

Правила говорят агенту, как работать. Они не скажут, какой сервис всё ещё читает переменную окружения, которую вы сейчас удалите.

Где заканчивается grep в терминале

Три вещи, которые сессия shell не узнает дёшево.

// вывод пролетает мимо

Каждый grep и cat агента попадает в разговор. Поиск, выдающий двести строк, тратит контекст ещё до начала настоящей работы.

// совпадение — не вызывающий

grep не отличит настоящий вызов от комментария, фикстуры или одноимённого метода другого класса.

// shell стартует с нуля

Новая сессия ничего не знает о репозитории. Индекс Maguyva уже построен, поэтому первый же вопрос получает ранжированный ответ.

Maguyva как MCP-сервер в Warp

Одна запись mcpServers даёт агенту Warp:

11 инструментов для вашего проиндексированного репозитория семантический, структурный (AST), графовый и текстовый поиск, а также поиск символов, зависимые и получение файлов.
Ответы с путями к файлам и номерами строк на 285+ языках, достаточно короткие, чтобы прочитать их в панели терминала.
Инструменты только для чтения Инструменты Maguyva только запрашивают индекс. Ни один не меняет файлы и не выполняет команды.

Warp даёт агенту терминал.
Maguyva даёт агенту карту кода.

Два рабочих процесса

Сначала спросите карту, потом запускайте команды.

// workflow 01

Проследить упавший скрипт до причины

warp agent> deploy.sh падает: BUILD_ID не задан. где он задаётся?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← текст

→ Агент подключает ci/env.sh и перезапускает деплой.
[exit 0]

Один индексированный поиск заменяет рекурсивный grep по всему репозиторию вместе с его выводом.

// workflow 02

Проверить вызывающих до изменения шага запуска

warp agent> можно перестать запускать миграции при старте?

dependency_search("runMigrations", dependents)
  3 вызывающих: server.ts, worker.ts, scripts/seed.ts

→ Агент переносит все три в шаг релиза.
[exit 0]

Вызывающие известны до изменения, поэтому воркер не стартует со старой схемой.

Настройка в Warp

Три шага. Тариф Free: 3 репозитория, До 50 тыс. проиндексированных строк, без банковской карты.

// step 01

Проиндексируйте репозиторий на maguyva.ai

Выберите тот, который вы уже знаете, чтобы оценить ответы.

// step 02

Добавьте Maguyva в ~/.warp/.mcp.json

~/.warp/.mcp.json

{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 03

Замените заглушку и задайте вопрос

Замените mgv_xxxx своим API-ключом и сохраните. Убедитесь в Settings → Agents → MCP servers, что сервер запущен, и задайте вопрос, ответ на который вы уже знаете.

Самостоятельная регистрация открыта.

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

Подключите Warp через MCP и задайте вопрос, который можно проверить.

Проиндексируйте первый репозиторий Смотреть документацию по совместимости

план Free: 3 репозитория, До 50 тыс. проиндексированных строк, без банковской карты.