Агент-программист (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-сервер, чтобы индекс построился заново.
Что такое MCP простыми словами?
Это протокол, по которому ИИ-клиент подключается к внешним инструментам — как кабель между агентом и программой-помощником. Условие доступа к Graphicle — именно клиент с поддержкой MCP.
С какими агентами работает Graphicle?
По описанию проекта — с Claude Code, Codex, Cursor и любым MCP-клиентом.
Graphicle — это плагин для редактора?
Нет, это единая программа на Rust, которая совмещает граф кода и память. Она подключается как MCP-сервер, а не как расширение под конкретный редактор.
Где взять требования к системе и лицензию?
В описании проекта они не раскрыты — уточняйте в репозитории `Graphicle-AI/graphicle`. Подключиться сможет любой клиент с поддержкой MCP, а вот нужен ли отдельно установленный Rust — проверьте там же.