Руководство по MCP
MCP подключает Codex или Claude Code к вашим задачам в Rememo. Читайте контекст, добавляйте комментарии и меняйте задачи с вашего разрешения.
Публикация в npm ещё не состоялась. Команды ниже предназначены для использования после публикации.
Перед началом
- Используйте Node.js 24.18.1–24.x. Установите CLI нужного клиента Codex или Claude Code и добавьте его в PATH.
- В Rememo откройте Настройки → Личные → Agent access. Создайте личный токен доступа, выберите нужные права и скопируйте его один раз.
- tasks:read позволяет читать задачи, tasks:write — брать и завершать их, comments:write — добавлять комментарии, context:read — читать контекст задачи. Отзовите токен в разделе Agent access, когда он больше не нужен.
Подключите клиент
npx @rememo/cli mcp setup- Выберите codex, claude или both. Для регистрации Rememo CLI выбранных клиентов должны быть установлены заранее.
- Используйте https://app.rememo.io или URL собственной установки Rememo, включая префикс пути. Можно также указать URL с /api/.
- Вставьте токен в скрытое поле терминала. Настройка сохранит его в приватном локальном файле и зарегистрирует в клиентах только путь к файлу. После настройки перезапустите клиент.
Приватный файл по умолчанию — ~/.rememo/mcp/config.json (каталог 0700, файл 0600 там, где эти права поддерживаются). Храните его приватно. Не передавайте токены в аргументах команд или общих настройках клиентов.
Доступные инструменты
rememo_list_tasks- Список задач, доступных вашему токену.
rememo_get_task- Прочитать задачу, её процесс и разрешённый контекст.
rememo_claim_task- Взять задачу в явно указанную колонку по вашему запросу.
rememo_add_task_update- Добавить комментарий к задаче.
rememo_complete_task- Завершить задачу по вашему явному запросу.
Клиент берёт или завершает задачи только по вашему явному запросу. Для взятия нужна конкретная колонка. Сервер не берёт задачи самостоятельно.
Расширенная настройка и решение проблем
Настройка без диалога
Задайте REMEMO_PERSONAL_ACCESS_TOKEN в окружении и передайте --client и --url. Аргумента --token нет. Не сохраняйте значение переменной в истории оболочки и общих журналах.
npx @rememo/cli mcp setup --client both --url https://app.rememo.ioОтдельные установки
Для другой установки Rememo используйте --config с отдельным абсолютным путём к приватному файлу. Повторная настройка обновит только регистрацию Rememo и сохранит остальные настройки клиента.
npx @rememo/cli mcp setup --client codex --url https://tasks.example.com/team --config /ABSOLUTE/PRIVATE/team.jsonОтдельный сервер
При ручной настройке клиента запустите stdio-сервер с приватным файлом конфигурации. Регистрируйте команду и путь к файлу, но не токен.
npx -y @rememo/mcp@0.1.0 --config /ABSOLUTE/PRIVATE/config.jsonПорядок конфигурации: явно заданный файл --config, затем полная пара переменных REMEMO_API_URL и REMEMO_PERSONAL_ACCESS_TOKEN, затем приватный файл по умолчанию. Неполная пара переменных отклоняется. REMEMO_API_URL — базовый адрес API с /api/.
Если подключение не работает
Проверьте версию Node.js, команду выбранного клиента в PATH, URL Rememo и права токена. Перезапустите клиент после регистрации. Если зарегистрированы не все клиенты, исправьте проблему и повторите настройку. Отзовите и замените раскрытый или просроченный токен.