← Все гайды AI Release
EN Подписаться на @ai_release1

Как дать ИИ-агенту постоянную память о проекте: devmemory, Graphicle и MCP

Обновлено: 15.10.2026 · AI Release · @ai_release1
Как дать ИИ-агенту постоянную память о проекте: devmemory, Graphicle и MCP

Агент-программист (Claude Code, Codex, Cursor) по умолчанию ничего не помнит о вашем проекте между сессиями: каждый раз приходится заново объяснять структуру кода, где лежат модули и что уже сделано. Гайд решает именно эту проблему — как подключить постоянную память о проекте. Разбираем инструмент **Graphicle** — единую программу на Rust, которая совмещает граф кода (карту зависимостей и связей между файлами) и память для кодинг-агентов. Подходит для Claude Code, Codex, Cursor и любого **MCP-клиента** — клиента, который умеет подключаться к внешним серверам по протоколу MCP (Model Context Protocol — способ, которым ИИ-клиент общается с внешними инструментами). Важное условие: детали установки, лицензии и требований к системе в описании проекта не раскрыты, поэтому шаги ниже даны в общем виде — точные команды берите из README репозитория.

Требования и подготовка

Иллюстрация к разделу «Требования и подготовка»
Иллюстрация к разделу «Требования и подготовка»

Пошаговая инструкция

Иллюстрация к разделу «Пошаговая инструкция»
Иллюстрация к разделу «Пошаговая инструкция»

1. **Проверьте, что ваш клиент умеет MCP.** Откройте настройки вашего редактора/агента и найдите раздел MCP. Ожидаемый результат: вы видите пункт, куда можно добавить MCP-сервер. Если такого раздела нет — клиент не поддерживает MCP, и Graphicle подключить не выйдет; смените клиент или обновите версию.

Почему это работает: Graphicle отдаёт данные именно как MCP-сервер, а не как плагин под конкретный редактор — поэтому поддержка протокола обязательна.

2. **Откройте репозиторий `Graphicle-AI/graphicle`.** Найдите файл README и раздел с запуском. Ожидаемый результат: у вас на руках точная команда установки и запуска (её в описании проекта не публикуют — она только в репозитории).

Почему это работает: программа поставляется как единый исполняемый компонент, поэтому достаточно одной команды запуска, а не набора скриптов.

3. **Подключите Graphicle к клиенту как MCP-сервер.** В конфигурации MCP-клиента добавьте запись о сервере. Ниже — общая структура такой записи (точные значения `command` и `args` берите из README, здесь показан только формат):

{
  "mcpServers": {
    "graphicle": {
      "command": "<команда запуска из README>",
      "args": ["<путь к вашему проекту>"]
    }
  }
}

Ожидаемый результат: после сохранения файла в списке MCP-серверов клиента появится `graphicle` со статусом «подключён».

Почему это работает: MCP-клиент при старте читает этот файл и запускает каждый сервер как отдельный процесс, а дальше общается с ним по протоколу.

4. **Укажите корень проекта.** В аргументах или в настройках сервера задайте путь к папке вашего проекта. Ожидаемый результат: Graphicle проиндексирует именно ваш код, а не всю файловую систему.

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

5. **Проверьте, что граф кода построился.** Задайте агенту вопрос про структуру проекта, например: «Какие файлы импортируют `utils/logger`?». Ожидаемый результат: агент отвечает связями между файлами, а не общими словами.

Почему это работает: граф кода хранит связи «кто кого вызывает/импортирует», и агент отвечает по этой карте, а не по догадкам.

6. **Проверьте, что память сохраняется.** Сохраните факт о проекте в одной сессии («сборка через `npm run build`»), закройте и откройте агента заново, спросите про этот факт. Ожидаемый результат: агент вспоминает договорённость без повторного объяснения.

Почему это работает: память и граф кода — единая программа, поэтому факты и структура живут рядом и не теряются между запусками.

Чек-лист проверки:

Возможные проблемы и решения

Иллюстрация к разделу «Возможные проблемы и решения»
Иллюстрация к разделу «Возможные проблемы и решения»

Симптом: сервер `graphicle` не появляется в списке MCP.

Скорее всего, клиент не поддерживает MCP. Решение: 1) проверьте версию клиента и обновите её; 2) если поддержки нет совсем — перейдите на Claude Code, Codex или Cursor, они указаны как совместимые.

Симптом: клиент показывает ошибку вида «server not found» или «команда не найдена».

Значит, `command` в конфиге указан неверно. Решение: 1) откройте README репозитория; 2) скопируйте команду запуска дословно; 3) убедитесь, что путь к проекту в `args` — абсолютный, а не относительный.

Симптом: агент отвечает общими словами и «не знает» ваш код.

Обычно не указан корень проекта. Решение: 1) проверьте аргументы сервера; 2) укажите папку с вашим кодом; 3) перезапустите MCP-сервер, чтобы индекс построился заново.

FAQ

Что такое MCP простыми словами?

Это протокол, по которому ИИ-клиент подключается к внешним инструментам — как кабель между агентом и программой-помощником. Условие доступа к Graphicle — именно клиент с поддержкой MCP.

С какими агентами работает Graphicle?

По описанию проекта — с Claude Code, Codex, Cursor и любым MCP-клиентом.

Graphicle — это плагин для редактора?

Нет, это единая программа на Rust, которая совмещает граф кода и память. Она подключается как MCP-сервер, а не как расширение под конкретный редактор.

Где взять требования к системе и лицензию?

В описании проекта они не раскрыты — уточняйте в репозитории `Graphicle-AI/graphicle`. Подключиться сможет любой клиент с поддержкой MCP, а вот нужен ли отдельно установленный Rust — проверьте там же.

🤖 Кратко для ИИ