Память для ваших программ

Программы на вашем компьютере могут пользоваться MindDuck как своей памятью. Вы подключаете программу, выбираете проекты, в которых она работает, и даёте ей ключ. После этого программа читает то, что есть в этих проектах, ищет по ним, сохраняет туда документы и добавляет рабочие заметки. Следующая сессия программы начинается с того, что узнала предыдущая, а вы читаете всё это в MindDuck на любом устройстве.

Программа не работает внутри MindDuck, и MindDuck её не запускает. Она обращается к MindDuck только на этом компьютере; по сети ничего не уходит.

Для записи нужен вход в Settings → Account и действующий доступ к MindDuck. См. Учётная запись.

Как включить

1. Откройте Settings → Agents и прокрутите до Memory for your programs.
2. Включите Accept connections on this computer. В карточке появится адрес, по которому подключаются программы, по умолчанию http://127.0.0.1:47821.
3. Нажмите Connect a program. Выберите программу, дайте ей имя, отметьте проекты, в которых она работает, и нажмите Create key.
4. Скопируйте ключ и передайте его программе. MindDuck показывает ключ один раз и хранит только его отпечаток. Потерянный ключ заменяется новым.

MindDuck отвечает программам, пока работает, с открытым окном или с закрытым. См. Background в Assistant. Пока рабочее пространство закрыто, программам сообщается об этом, и они ничего из него не получают.

Если появилось Not running с пояснением, что порт занят другой программой, введите другой номер в поле Port и нажмите Use this port. Уже подключённым программам нужен новый адрес.

Подключить Claude Code

После Create key MindDuck показывает, как подключить программу. Те же шаги позже открывает кнопка How to connect в карточке программы, с местом для ключа вместо самого ключа.

В терминале, в папке вашего проекта:

claude mcp add --transport http mindduck http://127.0.0.1:47821/mcp --header "Authorization: Bearer mdk_..."

Claude Code запоминает подключение только для этой папки. Без терминала, например в настольном приложении Claude, сохраните второй блок, который показывает MindDuck, как .mcp.json в папке проекта. В этом файле лежит ключ: не добавляйте его в систему контроля версий.

Начните новую сессию и попросите Claude Code прочитать контекст проекта. У него появятся инструменты памяти: memory_context, memory_search, memory_read, memory_documents, memory_note, memory_save, memory_update, memory_projects, memory_index_status. Перед первым использованием инструмента Claude Code спрашивает разрешение; разрешите те, которыми он может пользоваться без вопроса.

Если ключ открывает несколько проектов, выберите один в Project for this connection до копирования команды. Тогда программа работает в этом проекте, не называя его каждый раз.

Подключить Codex

Добавьте блок, который показывает MindDuck, в ~/.codex/config.toml и запустите Codex заново:

[mcp_servers.mindduck]
url = "http://127.0.0.1:47821/mcp"
http_headers = { "Authorization" = "Bearer mdk_..." }

Чтобы подключить только один проект, поместите блок в .codex/config.toml доверенного проекта.

Подключить Claude Desktop

Claude Desktop сам запускает свои MCP-серверы как команды. MindDuck показывает запись для его файла конфигурации; она запускает программу самого MindDuck как мост к памяти.

1. В Claude Desktop откройте Settings → Developer → Edit Config.
2. Добавьте запись mindduck, которую MindDuck показывает в Add to claude_desktop_config.json, в раздел mcpServers файла.
3. Запустите Claude Desktop заново.

Чтобы инструменты отвечали, MindDuck должен быть запущен. Если он не запущен, Claude получает об этом сообщение и может продолжать без памяти; следующий вызов работает, как только MindDuck снова запущен.

Контекст проекта в начале каждой сессии

Claude Code и Codex умеют выполнять команду при начале сессии и передавать её вывод модели. После двух необязательных шагов, которые показывает MindDuck, сессия в папке вашего проекта начинается с контекстом проекта перед агентом: ваш Agent brief, последние рабочие заметки, подтверждённые факты и список документов и недавних разговоров.

1. В папке проекта выполните команду Save the key for the folder. Ключ сохраняется в .mindduck в вашей домашней папке.
2. Добавьте hook, который показывает MindDuck, в .claude/settings.local.json в этой папке для Claude Code или в ~/.codex/hooks.json для Codex. В Codex проверьте и разрешите hook командой /hooks.

Hook никогда не задерживает сессию. Если MindDuck не запущен или рабочее пространство закрыто, сессия начинается без контекста.

Новая папка проекта

Если у программы отмечено May create new projects, папка, в которой вы начинаете работу, получает свой проект в MindDuck одной командой, выполненной в этой папке:

"C:\Program Files\MindDuck\mindduck-desktop.exe" memory connect

Команда берёт ключ, сохранённый раньше, создаёт проект с именем папки и привязывает папку к нему. Чтобы выбрать имя, добавьте --project "Имя". Если ключ уже открывает проект с таким именем, папка привязывается к нему и ничего нового не создаётся. Повторный запуск в той же папке ничего не меняет.

Чтобы инструменты памяти и контекст были в каждой папке без настройки каждой, подключитесь один раз для всех папок: в Claude Code добавьте --scope user к команде claude mcp add и поместите hook в ~/.claude/settings.json. Сессия в папке, где connect не выполнялся, начинается без контекста.

Без этой отметки connect только сохраняет ключ, а имя проекта, который ключ не открывает, отклоняется.

Подключить другую программу

Программе, которая подключается к MCP-серверам по адресу, нужны адрес http://127.0.0.1:47821/mcp и заголовок Authorization: Bearer с ключом. MindDuck показывает это в виде JSON для программ, принимающих такую форму, и мост в виде команды для программ, которые сами запускают свои MCP-серверы. Программа без MCP может пользоваться HTTP API, описанным ниже.

Расширение браузера

Расширение MindDuck для Chrome и Firefox сохраняет в проект то, что вы читаете в интернете, и передаёт фрагмент в MindDuck, когда о нём хочется спросить ассистента.

1. Установите расширение MindDuck в браузер.
2. В MindDuck нажмите Connect a program, выберите Browser extension, отметьте проекты, в которые оно может сохранять, и нажмите Create key.
3. Откройте настройки расширения, вставьте адрес и ключ и нажмите Connect.

Ключ принадлежит расширению, которое использовало его первым. Другое расширение или веб-страница воспользоваться им не могут. Чтобы перейти в другой браузер, нажмите New key в карточке и вставьте новый ключ там.

Нажмите кнопку MindDuck на панели браузера, выберите проект и одно из действий:

• Save selection сохраняет выделенный текст документом, цитатой с адресом страницы и датой.
• Save page сохраняет документом текст страницы.
• Discuss in MindDuck выводит MindDuck на передний план: открыт новый чат проекта, в поле сообщения лежит выделенное или вся страница, если ничего не выделено. Допишите вопрос и отправьте. До отправки ничего не сохраняется.
• Discuss a picture of the page делает то же со снимком того, что показывает браузер.

Первые три есть и в меню, которое открывается правой кнопкой на странице.

Расширение читает страницу, только когда вы нажали одно из этих действий, поэтому страница за входом сохраняется как любая другая. Картинки, файлы PDF и видео со страницы не сохраняются. Сохранённое расширением перечислено в его чате активности в проекте, с кнопкой Undo; см. Что сделала программа ниже.

Из терминала

Программа самого MindDuck выполняет команды памяти, если запустить её со словом memory. Путь ниже - для Windows; на Mac программа лежит в /Applications/MindDuck.app/Contents/MacOS/mindduck-desktop.

"C:\Program Files\MindDuck\mindduck-desktop.exe" memory connect --key mdk_...
"C:\Program Files\MindDuck\mindduck-desktop.exe" memory context
"C:\Program Files\MindDuck\mindduck-desktop.exe" memory search release plan
"C:\Program Files\MindDuck\mindduck-desktop.exe" memory note Decided to ship on Monday.
"C:\Program Files\MindDuck\mindduck-desktop.exe" memory save --title "Release plan" --file plan.md

connect сохраняет ключ для папки, в которой выполнен; --default - для всех папок. memory help перечисляет команды. На Windows команда печатает в терминал, из которого запущена, и приглашение может вернуться раньше, чем закончится вывод; чтобы дождаться, направьте вывод в конвейер, например | more.

Что может подключённая программа

В проектах, которые вы для неё выбрали, и больше нигде:

• читать документы и разговоры проекта;
• искать по ним;
• сохранять текст новым документом и изменять документ;
• добавлять рабочие заметки;
• вести разговор строка за строкой.

Она никогда не видит:

• другие проекты и чаты без проекта;
• личные чаты и документы, исключённые из памяти;
• то, что лежит в корзине.

Создавать и изменять факты она не может. Факты подтверждаете вы; то, что программа узнала, она записывает в рабочие заметки.

С отметкой May create new projects программа может завести собственный проект. Он добавляется в её список. Остальные ваши проекты остаются закрыты.

Рабочие заметки

Заметка программы добавляется в конец документа Working notes с месяцем в названии, например Working notes 2026-10, под строкой со временем и именем программы. Ничего не переписывается: несколько программ и вы можете дополнять одни и те же заметки, не затирая друг друга. Это обычный документ: читайте его, исправляйте, удаляйте неверное.

Месяц, в котором заметок много, продолжается в Working notes 2026-10 (2).

Указания для программы

Создайте в проекте документ с названием Agent brief и запишите в нём то, чему должна следовать каждая программа, работающая в этом проекте: как он устроен, что проверить перед завершением, чего не трогать. В начале работы программа запрашивает контекст проекта и получает сначала этот документ, затем последние заметки, подтверждённые вами факты и список документов и недавних разговоров.

Указания можно править с телефона. Программа прочитает новый текст в начале следующей сессии.

Что сделала программа

У каждой программы в каждом проекте, куда она пишет, есть собственный чат с её именем, например Claude Code activity. В нём перечислено, что программа сделала: по строке на каждый созданный или изменённый документ и каждую добавленную заметку, со ссылкой на документ. Это обычный чат: он синхронизируется, и его можно читать с телефона.

Под строкой есть Undo, пока действие ещё можно отменить:

• созданный документ уходит в корзину, откуда его можно восстановить;
• изменение или заметка отменяются тем, что текущим снова становится прежний текст. Это новая ревизия, так что из истории документа ничего не пропадает.

Изменение можно отменить, только пока оно последнее. Если документ после этого редактировали, откройте его и воспользуйтесь историей. Отменённое отмечается в том же чате.

Документы, написанные программой, помечены как написанные агентом, когда их позже находит другая программа или ассистент.

Перед сохранением MindDuck убирает из текста всё, что похоже на учётные данные: ключи API, токены, приватные ключи, пароли в адресах. На их месте остаётся [secret removed].

Что запрашивали программы

В Recent requests перечислено, о чём подключённые программы просили MindDuck с момента его запуска: время, программа, что запрошено и чем закончилось. Текст запросов и ответов там не хранится. Запрос с ключом, которого MindDuck не знает, записан как Unknown key; обычно это значит, что у программы остался старый ключ.

Программа, которая просит слишком много за короткое время, притормаживается: 300 запросов в минуту и 32 МБ записанного текста в сутки на каждый ключ. Такие запросы отмечены как slowed down.

Изменить или отозвать доступ

В карточке программы:

• Change access - другие проекты, другое имя, право создавать проекты. Ключ остаётся прежним.
• New key - заменяет ключ. Прежний перестаёт действовать сразу.
• Remove - ключ перестаёт действовать сразу. Документы и заметки, написанные программой, остаются в памяти.

Выключение Accept connections on this computer останавливает все программы сразу. Ключи сохраняются до следующего включения.

Список программ и их ключи хранятся на этом компьютере и не синхронизируются. Ключ, созданный здесь, на другом компьютере ничего не значит.

Для разработчиков

Памятью может пользоваться любая программа, умеющая отправить HTTP-запрос. Ключ передаётся как bearer-токен:

curl -H "Authorization: Bearer mdk_..." http://127.0.0.1:47821/v1/projects

Источник называется doc:<id>, chat:<id> или msg:<id чата>:<id сообщения>, так его возвращают поиск и чтение. Длинные источники читаются частями: nextOffset из ответа передаётся как offset следующего запроса.

Изменение документа называет ревизию, от которой написан новый текст. Если документ за это время отредактировали, ответ - revision_conflict с текущей ревизией: прочитайте документ заново и примените изменение к нему.

Запись, которую программа может повторить, отправляйте с заголовком Idempotency-Key. Тот же ключ с тем же запросом получает прежний результат и ничего не записывает заново.

У ошибки стабильный code: unauthorized, forbidden, not_found, invalid_request, revision_conflict, idempotency_conflict, limit_exceeded, rate_limited, unsupported, read_only, workspace_locked, busy. Источник, который ключу не разрешён, отвечает not_found, как несуществующий.

Если что-то не так

• Программа не может подключиться. Проверьте, что MindDuck запущен, что включено Accept connections on this computer и что программа использует адрес из карточки.
• Программе отвечают, что пространство закрыто. Откройте MindDuck и рабочее пространство.
• Claude Code показывает сервер как неработающий. Когда сессия начиналась, MindDuck не был запущен или подключения были выключены. Запустите MindDuck и начните новую сессию.
• Программе отвечают, что запись недоступна. Войдите в Settings → Account; см. Учётная запись.
• Программа сообщает, что ключ не принят. Посмотрите Recent requests: строка Unknown key значит, что у программы старый ключ. Создайте новый ключ и передайте его программе.
• Сохранённый программой документ ещё не находится поиском. Новый текст индексируется в фоне, обычно в пределах минуты.
• Расширение браузера сообщает, что ключ нельзя использовать из этого браузера. Это ключ другой программы, или его первым использовало другое расширение. Подключите программу вида Browser extension или нажмите New key в её карточке и вставьте ключ в настройки расширения.