Пусть агент ведёт ваш список дел

MCP или CLI?

Отдавайте предпочтение инструментам MCP, если у вашего агента уже есть MCP-соединение с TaskForge. Они типизированы, возвращают структурированные ошибки, по которым агент может сам себя исправить, и ничего не требуют в вашем PATH. Обращайтесь к CLI из оболочек без MCP-соединения: скрипты, cron, CI или кодирующий агент, работающий в локальной копии репозитория. Оба варианта используют один и тот же движок с одинаковой семантикой, так что выбирайте то, что уже настроено в вашей среде. Ручное редактирование файлов хранилища остаётся последним средством.

Установка

{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

Собрали taskforge из исходников вместо использования npx? Укажите в конфигурации бинарник напрямую:

"command": "taskforge",
"args": ["mcp", "--stdio"]

Только для десктопа, поскольку именно там живут MCP-клиенты. taskforge поставляется как единый нативный бинарник для macOS, Windows и Linux, а MCP-сервер является одной из его подкоманд.

Полный набор инструментов

Всего 22 инструмента, охватывающих весь жизненный цикл задачи: создание, чтение, обновление, завершение, архивирование и удаление, у каждого есть массовый вариант; перемещение, смена родителя и конвертация между строкой inline и файлом TaskNotes; проверка lint перед записью строки; вызов doctor для проверки состояния хранилища; а также ресурсы схемы и списков, чтобы агент изучил ваш формат перед тем, как действовать. Ниже перечислены шесть инструментов, которыми вы будете пользоваться чаще всего. Каждый вызов заново читает хранилище с диска, поэтому агент всегда работает с актуальными файлами.

У каждого инструмента есть аннотации, поэтому клиент сразу видит, какие вызовы только читают, какие пишут, а какой удаляет. В остальную часть набора входят bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_task_lists и get_schema.

Три ресурса

Помимо инструментов, сервер предоставляет контекст только для чтения, чтобы агент узнал правила вашего хранилища прежде, чем действовать:

Если не удаётся найти ваше хранилище

Сервер всегда запускается, даже до того, как он узнает, где находится ваше хранилище, поэтому Claude Desktop никогда не показывает невнятное "server failed to start". Когда вызов инструмента не может определить хранилище, он возвращает понятную ошибку, которую агент может передать вам: задайте переменную окружения TASKFORGE_VAULT как путь к хранилищу, либо переустановите пакет и укажите папку хранилища, когда будет предложено.

Только локально

taskforge mcp --stdio читает и записывает markdown-файлы только в том хранилище, которое вы настроили, и больше ничего. Без аккаунта, без облака. Ваша текущая синхронизация, iCloud, Dropbox или Obsidian Sync, переносит изменения между устройствами.

Предпочитаете терминал?

Если вы хотите писать скрипты для задач или запускать разовые команды, а не управлять ими через агента, taskforge CLI работает с тем же хранилищем по тем же правилам.

Частые вопросы