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

Zed быстрый. Но код агенту всё равно нужно найти.

Агент Zed работает с файлами, которые вы открыли, и с инструкциями, которые вы дали. Maguyva индексирует весь репозиторий и возвращает его через MCP, поэтому агент спрашивает, где находится символ, а не гадает.

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

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

Одна запись в context_servers: URL и заголовок Authorization.

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

Четыре факта именно о Zed. Ни один не сложный.

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

settings.json

Удалённые серверы задаются в context_servers. Откройте файл командой zed: open settings file или добавьте сервер через Settings → AI → MCP Servers.

// транспорт

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

Zed подключается к удалённой точке доступа Maguyva напрямую по HTTP. Без локального процесса и без Node.js.

// ключ

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

В этом руководстве ключ записывается прямо в заголовок Authorization: подстановка переменных окружения в заголовках Zed здесь не проверена. Храните его в пользовательских настройках, а не в файле, который коммитите.

// подтверждения

Права на инструменты

По умолчанию Zed спрашивает перед каждым вызовом инструмента. Разрешайте инструменты Maguyva по одному в agent.tool_permissions.tools с ключами вида mcp:maguyva:find_symbol.

Инструкции проекта — это рабочее соглашение. Используйте их.

# .rules
- Запускай команду тестов репозитория, прежде чем считать изменение готовым.
- Редактируй только тот пакет, который просили изменить.

Zed загружает один файл инструкций проекта: первое совпадение из фиксированного списка, который начинается с .rules и включает AGENTS.md и CLAUDE.md. Личные инструкции кладите в ~/.config/zed/AGENTS.md. Используйте их для:

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

Файл инструкций говорит агенту, как работать. Он не может сказать, какие из четырёх тысяч файлов вызывают функцию, которую агент вот-вот изменит.

Где открытого буфера уже не хватает

Три вещи, которые агент Zed не узнает из файлов перед глазами.

// открытый файл — это не репозиторий

Агент видит то, что открыли вы, и то, что он нашёл через grep. Хелпер с тем же именем в другом пакете выглядит точно так же — пока в продакшен не уйдёт не тот.

// вызывающих не видно на экране

“Что сломается, если я изменю эту сигнатуру?” — вопрос для графа. Без индекса агент читает файлы по одному, пока не кончатся ходы или контекст.

// у контекста есть бюджет

Каждый файл, который агент открывает, чтобы сориентироваться, тратит токены, которых потом не хватит на само изменение. Один ранжированный ответ с file:line дешевле десяти пробных чтений.

Maguyva как контекстный сервер Zed

Одна запись в context_servers даёт агенту Zed:

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

Zed даёт агенту быстрый редактор.
Maguyva даёт агенту карту кода.

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

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

// workflow 01

Найти реализацию до того, как агент откроет вкладку

zed agent> где политика повторов для исходящих вебхуков?

find_symbol("retryPolicy")
  src/webhooks/dispatch.ts:41   retryPolicy()   ← реализация
  src/webhooks/__mocks__/dispatch.ts:9   ← мок

→ Агент открывает dispatch.ts:41, а не мок.
[exit 0]

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

// workflow 02

Проверить зависимых перед сменой сигнатуры

zed agent> добавь в fetchInvoice аргумент timeout

dependency_search("fetchInvoice", dependents)
  7 вызывающих в 4 пакетах

→ Агент обновляет все семь мест вызова за один проход.
[exit 0]

Радиус влияния виден до первой правки, а не после падения сборки.

Настройка в Zed

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

// step 01

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

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

// step 02

Добавьте Maguyva в context_servers в настройках Zed

~/.config/zed/settings.json

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

// step 03

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

Замените mgv_xxxx своим API-ключом и сохраните. Задайте агенту вопрос, ответ на который вы уже знаете, и откройте процитированный файл.

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

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

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

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

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