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

> AI Release · @ai_release1 · https://ai-release.org/guides/kak-dat-ii-agentu-postoyannuyu-pamyat-o-proekte-devmemo.html

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

## Требования и подготовка
![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/kak-dat-ii-agentu-postoyannuyu-pamyat-o-proekte-devmemo-ru-1.jpg)


- Клиент ИИ с поддержкой MCP — один из: Claude Code, Codex, Cursor или любой другой MCP-клиент. Без поддержки MCP подключение невозможно.
- Доступ к репозиторию `Graphicle-AI/graphicle` на GitHub — оттуда берётся программа и инструкция по запуску.
- Локальная копия проекта, к которому вы хотите дать агенту память (папка с вашим кодом и файлом-манифестом вроде `package.json`, `Cargo.toml` или `.git`).
- Текстовый редактор для правки конфигурационного файла MCP-клиента.
- Понимание, что программа написана на Rust — но нужен ли вам отдельно установленный Rust, в описании проекта не сказано; проверьте README.
- Заведите привычку фиксировать в памяти ключевые факты о проекте — например: «основной сервис — `api/`, сборка через `npm run build`».

## Пошаговая инструкция
![Иллюстрация к разделу «Пошаговая инструкция»](https://ai-release.org/guides/img/kak-dat-ii-agentu-postoyannuyu-pamyat-o-proekte-devmemo-ru-2.jpg)


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

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

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

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

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

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

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

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

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

- [ ] Клиент поддерживает MCP (Claude Code, Codex, Cursor или другой MCP-клиент)
- [ ] Взял команду запуска из README репозитория `Graphicle-AI/graphicle`
- [ ] Сервер добавлен в конфиг MCP и виден в списке подключённых
- [ ] Указан корень именно вашего проекта
- [ ] Агент отвечает связями из графа кода
- [ ] Факт из прошлой сессии вспоминается после перезапуска

## Возможные проблемы и решения
![Иллюстрация к разделу «Возможные проблемы и решения»](https://ai-release.org/guides/img/kak-dat-ii-agentu-postoyannuyu-pamyat-o-proekte-devmemo-ru-3.jpg)


**Симптом: сервер `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 — проверьте там же.