Перейти к содержимому

Руководство по 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
  1. Выберите codex, claude или both. Для регистрации Rememo CLI выбранных клиентов должны быть установлены заранее.
  2. Используйте https://app.rememo.io или URL собственной установки Rememo, включая префикс пути. Можно также указать URL с /api/.
  3. Вставьте токен в скрытое поле терминала. Настройка сохранит его в приватном локальном файле и зарегистрирует в клиентах только путь к файлу. После настройки перезапустите клиент.

Приватный файл по умолчанию — ~/.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 и права токена. Перезапустите клиент после регистрации. Если зарегистрированы не все клиенты, исправьте проблему и повторите настройку. Отзовите и замените раскрытый или просроченный токен.

Начало работы

Создавайте задачу из сообщения, с которого она началась

Мы объединили чат и канбан, чтобы вы могли создавать задачи прямо из сообщений.