https://aizametki.ru/api/mcp
Зачем это нужно
Обычный чат с ИИ помнит только то, что вы написали в текущем диалоге. AI Заметки дают ему постоянную память: идеи из голосовых заметок, конспекты, планы, стенограммы встреч, черновики статей, списки задач и личные наблюдения. Не нужно вручную копировать текст из приложения в чат. Вы просите: "Найди мои заметки про запуск курса и собери план на неделю", и ИИ сам берет нужный контекст из AI Заметок.
Это особенно удобно, если вы часто записываете мысли голосом. Сначала AI Заметки превращают речь в текст, а потом подключенный ИИ может работать с этим текстом как с нормальной базой: искать, сравнивать, резюмировать, дополнять и оформлять.
Что сможет делать ИИ после подключения
Доступ вы подтверждаете через OAuth. Это значит, что вы не вставляете пароль от AI Заметок в сторонний чат. Клиент получает ограниченное разрешение, которое можно отозвать в профиле AI Заметок в блоке "AI-клиенты".
Что подготовить перед подключением
- Войдите в AI Заметки под тем email, где хранятся ваши записи.
- Скопируйте MCP endpoint:
https://aizametki.ru/api/mcp. - В выбранном AI-клиенте найдите раздел MCP, Apps, Connectors или Custom connector. В разных продуктах названия меню могут немного отличаться.
- Если клиент спрашивает тип транспорта, выбирайте HTTP, Streamable HTTP или Remote MCP. Если спрашивает авторизацию, выбирайте OAuth.
- После вставки endpoint откроется вход в AI Заметки. Войдите, проверьте запрошенные права и подтвердите доступ.
Как подключить ChatGPT
В ChatGPT подключение обычно делается через Apps или Connectors. Если у вас есть доступ к пользовательским приложениям, путь такой:
- Откройте ChatGPT в браузере.
- Перейдите в Settings, затем в Apps & Connectors. Включите Developer mode в Advanced settings, если ChatGPT просит это сделать.
- В разделе Apps или Connectors нажмите Create или Create app.
- Укажите название, например "AI Заметки". В поле URL вставьте
https://aizametki.ru/api/mcp. - Сохраните подключение. ChatGPT проверит сервер и покажет доступные инструменты для работы с заметками.
- Нажмите Connect, войдите в AI Заметки и подтвердите права доступа.
- В новом чате нажмите кнопку добавления инструментов рядом с полем ввода и выберите "AI Заметки".
Если кнопки Create нет, возможно, ваш тариф, рабочее пространство или администратор пока не разрешают пользовательские MCP-приложения. Сам endpoint AI Заметок уже готов, но включить его должен сам ChatGPT.
Как подключить Claude
В Claude подключение называется custom connector. Оно подходит для claude.ai, Claude Desktop и других клиентов Claude, где включены удаленные MCP-коннекторы.
- Откройте Claude и перейдите в Customize, затем в Connectors.
- Нажмите плюс или Add custom connector.
- Выберите Web или Remote MCP, если Claude предлагает тип коннектора.
- Вставьте endpoint
https://aizametki.ru/api/mcp. - Если Claude показывает Advanced settings для OAuth Client ID и Client Secret, сначала оставьте эти поля пустыми: AI Заметки публикуют OAuth-настройки автоматически.
- Нажмите Add, затем Connect. Войдите в AI Заметки и подтвердите доступ.
- В чате включите коннектор "AI Заметки" и явно попросите Claude использовать его.
В командных тарифах Claude добавлять новый коннектор иногда может только владелец или администратор организации. После добавления каждый пользователь подключает его к своему аккаунту отдельно.
Как подключить Codex
Codex полезен, если вы хотите работать с заметками из терминала или IDE: например, превращать заметки о продукте в issue, документацию, план релиза или черновик README. Подключение делается через MCP-настройки Codex.
- Установите или обновите Codex CLI.
- Добавьте AI Заметки как удаленный MCP-сервер:
codex mcp add aizametki --url https://aizametki.ru/api/mcp
- Запустите OAuth-вход для этого сервера:
codex mcp login aizametki
- В браузере войдите в AI Заметки и подтвердите доступ.
- Проверьте подключение:
codex mcp list
После этого в Codex можно просить: "Используй MCP-сервер aizametki, найди мои заметки про лендинг и составь список правок для сайта". Если вы пользуетесь IDE-расширением Codex, оно берет те же MCP-настройки, что и CLI.
Как подключить Claude Code
Claude Code тоже умеет подключаться к удаленным HTTP MCP-серверам. Это удобно, когда заметки нужны прямо во время разработки: требования, решения по архитектуре, список багов, идеи для интерфейса, заметки после созвонов.
- Откройте терминал в проекте, где используете Claude Code.
- Добавьте AI Заметки как HTTP MCP-сервер:
claude mcp add --transport http aizametki https://aizametki.ru/api/mcp
- Запустите Claude Code и выполните команду
/mcp. - Выберите подключение AI Заметок и пройдите OAuth-вход в браузере.
- Если хотите подключить AI Заметки сразу для всех проектов, добавьте флаг
--scope userпри добавлении сервера.
Пример для всех проектов:
claude mcp add --transport http --scope user aizametki https://aizametki.ru/api/mcp
Как подключить другой AI-клиент
Если ваш клиент поддерживает MCP, логика почти всегда одна и та же. Создайте новый remote MCP server, вставьте endpoint https://aizametki.ru/api/mcp, выберите HTTP или Streamable HTTP, включите OAuth и пройдите вход в AI Заметки. Если клиент показывает список прав, для начала достаточно чтения и записи. Право удаления подключайте только если действительно хотите удалять заметки из чата.
Примеры запросов
Используй AI Заметки. Найди мои последние заметки про запуск проекта и собери короткий план на завтра.
Найди все заметки, где я говорил про лендинг, и выпиши повторяющиеся идеи, возражения пользователей и задачи для дизайна.
Создай в AI Заметках новую заметку с итогами этого разговора: решения, открытые вопросы и следующие шаги.
Открой заметку про встречу с клиентом и преврати ее в письмо с понятным списком договоренностей.
Найди мои голосовые заметки за эту неделю и сделай из них один аккуратный недельный отчет.
Используй только AI Заметки как источник. Не выдумывай факты, если в заметках нет ответа.
В чем крутость такого подключения
Главная польза в том, что ваши заметки перестают быть архивом. Они становятся рабочей памятью для ИИ. Вы можете вести заметки как обычно: голосом после встречи, коротким текстом на телефоне, черновиком идеи вечером. А потом в чате попросить ИИ найти нужное, собрать структуру, сравнить старые мысли с новыми и записать результат обратно.
Еще один плюс: контекст остается вашим. Вы подключаете конкретный аккаунт, видите список подключенных клиентов в профиле и можете отозвать доступ. Для удаления есть отдельное право, поэтому клиент не должен получать его без явного запроса.
Если что-то не подключается
- Проверьте, что вставили именно
https://aizametki.ru/api/mcp, без лишних пробелов и символов. - Убедитесь, что AI-клиент поддерживает удаленные MCP-серверы по HTTP, а не только локальные stdio-серверы.
- Если вход не открылся, попробуйте выйти из AI Заметок и войти заново через /app/, затем повторить подключение.
- Если клиент просит выбрать права, начните с
notes:readиnotes:write. Правоnotes:deleteдобавляйте отдельно. - Если подключение есть, но ИИ не пользуется заметками, попросите явно: "Используй AI Заметки" или "Используй MCP-сервер aizametki".