Для користувачів 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 тис. проіндексованих рядків репозиторію, без кредитної картки.