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

Canonical source: https://maguyva.ai/uk/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 і поставте запитання, яке можна перевірити.