memexдокументация

Справочник

Как работают подключения

Инструкции по подключению, вход из ассистента, первый промпт, проверка нового подключения, разрешения, токены и управление подключениями.

Все подключения работают по MCP — стандарту, по которому ассистенты обращаются к инструментам, — и по одному адресу:

https://memex.tools/mcp

Инструкции по подключению

Кнопка Подключить ассистента (в разделе Настройки › Ассистенты, в меню аккаунта и над твоим именем в боковом меню, пока не подключён ни один ассистент) открывает инструкции. В них четыре вкладки: ChatGPT, Claude, Gemini Spark и Другой. Для первых трёх все шаги собраны в один нумерованный список: куда зайти в ассистенте, какой адрес вставить, подтвердить вход через memex и, последним шагом, какой промпт вставить.

Инструкция для Claude начинается с кнопки Добавить в Claude: она открывает в Claude форму добавления пользовательского коннектора, где уже заполнены название Memex и адрес. Ручные шаги свёрнуты под кнопкой на случай, если она не сработает, а отдельный шаг разрешает все инструменты memex. На каждую инструкцию уходит несколько минут. Режим разработчика и пользовательские плагины в ChatGPT, как и пользовательские коннекторы в Claude, доступны и в бесплатных аккаунтах, только в бесплатном Claude можно добавить один пользовательский коннектор. Для пользовательских приложений Gemini Spark нужен платный тариф Google AI Pro или Ultra.

Вход из ассистента

Когда ты добавляешь коннектор, ассистент отправляет тебя в memex, чтобы подтвердить подключение. На странице подтверждения указаны ассистент и сайт, с которого он подключается, аккаунт, который сейчас открыт, и что подключение сможет делать: всё, что оно запишет, попадёт во «Входящие» на проверку, и без твоего одобрения ничего не станет проверенным. Connect it создаёт подключение. Оно сразу появляется в таблице подключений с отметкой OAuth.

Промпт

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

Проверка нового подключения

Попроси ассистента загрузить навык memex-docs и пройти проверку ниже. Она по очереди проверяет чтение, поиск, загрузку инструкций и запись, занимает меньше минуты и ловит сбой, которого не видно из браузера: подключение читает, но не может писать, или пишет туда, куда ты никогда не заглядываешь. Если ты ассистент и тебя только что подключили, пройди проверку и простыми словами расскажи, чем закончился каждый шаг.

  1. Вызови health. Назови базу знаний и роль, которая у тебя указана. Если вызов не прошёл, дальше ничего не сработает: проблема в самом подключении.
  2. Вызови search без запроса. В новой базе знаний лежат приветственные заметки от memex; подойдёт любая. Открой одну через get и убедись, что видишь её текст: значит, до тебя доходят заметки целиком, а не только заголовки.
  3. Вызови list_skills. В списке должен быть memex-docs и навыки владельца. Загрузи один из них через get_skill.
  4. Вызови propose с короткой заметкой под заголовком Проверка подключения: какой ты ассистент, когда была проверка и что вернули три предыдущих шага.
  5. Прочитай ответ propose. Если там сказано, что заметка на проверке, скажи владельцу, что она ждёт во «Входящих» и так и задумано: без проверки владельца записи ассистента не применяются. Если заметка применилась сразу, скажи, что у этого подключения роль куратора и оно пишет без ожидания.

В конце прямо скажи, какие из пяти шагов сработали.

Разрешения на каждый вызов

По умолчанию ChatGPT и Claude спрашивают разрешения перед каждым вызовом, пока ты это не отключишь: в ChatGPT — Настройки › Plugins › Memex, затем Allow all actions; в Claude — Настройки › Коннекторы › Memex, затем Всегда разрешить и для Read-only tools, и для Write/delete tools (в инструкции для Claude это отдельный шаг со ссылкой на настройки коннекторов). Gemini спрашивает перед действиями, которые что-то записывают, и отключить это нельзя.

Так ведёт себя ассистент, а не memex, и отключать это безопасно. С ролью «Агент» новые заметки приходят во «Входящие», а правки, удаления и объединения ждут твоего одобрения. У подключения с ролью «Куратор» новые заметки и правки применяются сразу, а удаления и объединения всё равно ждут. Подробнее: Чтобы ассистент не спрашивал каждый раз.

«Другой»: токены

Другой — вкладка для всего, что не может войти через браузер: агента для программирования, агента на своём сервере, скрипта. Дай подключению имя, нажми Создать токен и скопируй токен из окна; потом его можно скопировать снова кнопкой Скопировать токен. Агент передаёт токен в каждом запросе, в заголовке Authorization: Bearer <token>. Под адресом есть готовые настройки для Claude Code, Codex, Cursor и Gemini CLI: команда для запуска или строки для файла настроек ассистента, где на месте токена стоит YOUR_TOKEN. В таблице у таких подключений написано Вручную.

Управление подключениями

В таблице Подключённые ассистенты и агенты у каждого подключения есть название, способ авторизации, дата создания и время последнего вызова. Сеансы — сколько раз за последние 14 дней ассистент открывал memex (Claude, например, делает это в начале каждого чата), а Вызовы — сколько раз он вызывал инструменты, включая вызовы, которые memex отклонил или которые закончились ошибкой. В меню ⋯ есть Изменить подключение, Скопировать токен для подключений с вкладки Другой и Отозвать доступ.

Изменить подключение открывает карточку ассистента: отображаемое имя, описание (необязательно) и значок — логотип провайдера, символ или своя картинка. Эти имя и значок memex показывает везде, где подписано, что сделал этот ассистент. Для подключения с вкладки Другой там же виден скрытый токен с кнопкой копирования. Memex хранит такие токены в зашифрованном виде. Токен, созданный до того, как memex начал их хранить, скопировать нельзя, а Выпустить новый токен сразу его заменяет — ассистенту со старым токеном понадобится новый.

Отозвать доступ помечает подключение, Сохранить изменения подтверждает — и подключение сразу перестаёт работать. При следующем вызове ассистент без доступа получит «Invalid or revoked token» и больше ничего. Подписи под тем, что он сделал раньше, остаются.

Любое новое подключение, как бы его ни создали, сначала получает роль Агент. Подробнее: Как работают роли.