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

Canonical source: https://maguyva.ai/ru/for-warp

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).

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

> Одна запись 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.

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

```text
# 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 даёт агенту *карту кода*.

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

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

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

```text
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 по всему репозиторию вместе с его выводом.

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

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

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

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

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

## Настройка в Warp

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

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

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

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

`~/.warp/.mcp.json`

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

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

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

В [документации MCP](https://docs.warp.dev/agents/capabilities/mcp/) для Warp описаны серверы из файлов, общий доступ и аутентификация.

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

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