에이전트가 당신의 할 일 목록을 다루게 하세요

MCP냐 CLI냐?

에이전트가 이미 TaskForge에 MCP 연결을 갖고 있다면 MCP 도구를 우선하세요. 타입이 있고, 에이전트가 스스로 고칠 수 있는 구조화된 오류를 반환하며, PATH에 아무것도 필요하지 않습니다. MCP 연결이 없는 셸 환경, 즉 스크립트, cron, CI, 저장소 체크아웃에서 작업하는 코딩 에이전트라면 대신 CLI를 사용하세요. 둘 다 동일한 엔진을 동일한 시맨틱으로 구동하므로, 여러분의 런타임에 이미 연결된 쪽을 고르면 됩니다. 볼트 파일을 손으로 편집하는 것은 최후의 수단입니다.

설치

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

npx 대신 taskforge를 소스에서 직접 빌드하셨나요? 설정이 바이너리를 직접 가리키게 하세요:

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

데스크톱 전용입니다. MCP 클라이언트가 그곳에 있기 때문입니다. taskforge는 macOS, Windows, Linux용 단일 네이티브 바이너리로 제공되며, MCP 서버는 그 서브커맨드 중 하나입니다.

전체 도구 모음

총 22가지 도구가 있으며, 작업의 전체 수명 주기를 다룹니다: 생성, 읽기, 수정, 완료, 보관, 삭제에는 각각 일괄 처리 버전이 있습니다. 여기에 이동, 상위 항목 재지정, 인라인 줄과 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에 알 수 없는 "서버 시작 실패" 같은 메시지가 뜨는 일은 없습니다. 도구 호출이 볼트를 찾지 못하면 에이전트가 그대로 전달할 수 있는 평문 오류를 반환합니다: TASKFORGE_VAULT 환경 변수를 볼트 경로로 설정하거나, 번들을 다시 설치하고 안내에 따라 볼트 디렉터리를 입력하세요.

로컬에서만 동작

taskforge mcp --stdio는 설정한 볼트 안의 마크다운 파일만 읽고 씁니다. 계정도, 클라우드도 없습니다. 이미 쓰고 있는 동기화, iCloud, Dropbox, Obsidian Sync가 기기 간에 변경 사항을 전달합니다.

터미널을 선호하시나요?

에이전트 대신 작업을 스크립트로 처리하거나 일회성 명령을 실행하고 싶다면, taskforge CLI가 같은 볼트를 같은 규칙으로 다룹니다.

자주 묻는 질문