주요 콘텐츠로 건너뛰기
TaskForge 3.0: 작업 읽는 AI

Claude에게 내 할 일을 맡길 수 있습니다

TaskForge 작업은 Obsidian 보관함 안의 일반 마크다운 줄이므로, Claude는 폴더에 직접 접근하는 것만으로 지금 바로 작업을 추가하고 편집하고 일정을 옮길 수 있습니다. TaskForge는 전용 MCP 서버를 더해, Claude Desktop이 자유 형식 편집 대신 타입이 있는 도구를 통해 작업을 추가하고 기한이 지난 항목을 찾고 일정을 바꾸거나 완료 표시를 할 수 있게 합니다. 어느 쪽이든 내 기기에서 앱이 읽는 것과 같은 파일을 다루며, 계정도 클라우드도 없습니다.

Claude를 내 보관함에 연결하기

가장 빠른 방법은 MCP 서버로, Claude Desktop이 소수의 도구를 통해 이를 다룹니다. 이미 Claude에 폴더 직접 접근 권한을 주었다면 그곳의 작업 파일을 대신 편집할 수 있습니다. 둘 다 같은 보관함을 읽습니다.

  1. 보관함 안내 파일을 한 번 만들기

    TaskForge 3.0 이상에서 보관함을 열고 설정 > AI 및 에이전트로 가서 "에이전트 파일 생성"을 켜 두세요. TaskForge가 정확한 작업 형식을 설명하는 TaskForge/Settings/ 폴더를 기록하므로, Claude는 추측하는 대신 내 표기 방식을 정확히 맞춥니다.

  2. Claude Desktop에 MCP 서버 추가하기

    Claude Desktop의 설정 파일을 열고 taskforge 서버를 추가하세요. npx가 처음 실행될 때 내려받으므로 미리 설치할 것이 없습니다. TASKFORGE_VAULT를 노트가 있는 폴더로 설정하세요.

    {
      "mcpServers": {
        "taskforge": {
          "command": "npx",
          "args": ["-y", "taskforge-md", "mcp", "--stdio"],
          "env": {
            "TASKFORGE_VAULT": "/path/to/your/vault"
          }
        }
      }
    }
    JSON을 편집하고 싶지 않으신가요? taskforge .mcpb 번들을 다운로드해 열기만 하면 됩니다. Claude Desktop의 설치 프로그램이 보관함 폴더를 물어보고 나머지를 연결해 줍니다.
  3. Claude를 재시작하고 도구를 확인하기

    재시작 후 Claude Desktop의 도구 목록에 taskforge 도구인 add_task, query_tasks, get_task, update_task, complete_task, delete_task가 나타납니다. 보관함을 찾지 못하더라도 서버는 그대로 시작되며, TASKFORGE_VAULT를 설정하라는 평문 메시지를 Claude에 반환합니다.

  4. 평범한 말로 요청하기

    이제 사람에게 말하듯 Claude에게 요청하면 됩니다. "뭐가 기한이 지났어?" "금요일에 치과 예약 전화하는 작업 추가해줘." "청구서 완료 표시해줘." Claude가 알맞은 도구를 고르고, 실행되는 순간 그 변경이 마크다운에 반영됩니다.

Claude가 여러분의 형식을 익히는 방법

TaskForge는 보관함 안의 눈에 보이는 TaskForge/Settings/ 폴더에 세 개의 파일을 기록합니다. MCP 서버가 이를 읽고 리소스로 노출하므로, Dataview [key:: value] 필드든, 이름이 바뀐 마감일이든, TaskNotes 파일이든 Claude는 보관함이 실제로 작업을 쓰는 방식을 그대로 따릅니다. 이를 생성하기 위해 기기 밖으로 나가는 데이터는 없습니다.

TaskForge/Settings/agents.md 보관함의 작업 문법을 평문으로 설명합니다: 체크박스 표기, 상태 기호, 이름이 바뀐 필드, 날짜 형식, 폴더 규칙.
TaskForge/Settings/dialect.json 같은 정보를 기계가 읽을 수 있는 형태로 담아, taskforge://dialect 리소스로 Claude에 노출됩니다.
TaskForge/Settings/spaces.json 저장된 스페이스와 새 작업이 들어가야 할 위치를 담아, "이걸 Work에 추가해줘"가 올바른 곳에 기록되게 합니다.

실제로 통하는 프롬프트

모든 호출이 디스크에서 보관함을 다시 읽으므로, Claude는 항상 현재 파일을 기준으로 동작합니다. 대화 도중 Obsidian에서 작업을 편집해도 다음 도구 호출이 이를 반영합니다.

Claude에게 묻는 말

“내 보관함에서 기한이 지난 게 뭐야? 미룰 수 있는 건 월요일로 옮기고, 미룰 수 없는 건 우선순위를 올려줘.”

보관함에 기록되는 내용

- [ ] 도메인 갱신하기 📅 2026-07-13

- [ ] 외주 청구서 결제하기 ⏫ 📅 2026-07-09

Claude는 query_tasks로 작업을 읽은 다음 update_task로 날짜와 우선순위를 그 자리에서 다시 씁니다. 일정 변경은 TaskForge와 Obsidian에 동시에 나타납니다.

Claude에게 묻는 말

“월요일 리뷰 준비 작업을 추가해줘. 우선순위 높게, 마감은 이번 주 금요일.”

보관함에 기록되는 내용

- [ ] 월요일 리뷰 준비하기 ⏫ 📅 2026-07-10

add_task가 보관함의 기본 대상에 줄을 기록하며, 보관함이 작업을 쓰는 방식 그대로 포맷됩니다. 앱이 다음에 보관함을 읽을 때 TaskForge에 나타납니다.

내 기기 안에서만 동작합니다

taskforge MCP 서버는 지정한 보관함 안의 마크다운 파일만 읽고 씁니다. 계정도, API 키도, 관여하는 TaskForge 서버도 없습니다. 이미 보관함을 동기화하고 있는 iCloud, Dropbox, Obsidian Sync가 Claude의 편집 내용을 다른 기기로 전달합니다.

자주 묻는 질문

Claude가 제 할 일 목록을 관리할 수 있나요?

네. taskforge MCP 서버를 통해 Claude Desktop을 Obsidian 보관함에 연결하면 Claude가 30가지 도구로 작업을 추가하고 찾고 일정을 옮기고 완료할 수 있습니다. 작업은 일반 마크다운 줄이므로 TaskForge와 Obsidian 모두 Claude의 편집 내용을 보여줍니다.

MCP 서버가 꼭 필요한가요, 아니면 Claude가 파일을 그냥 편집해도 되나요?

둘 다 가능합니다. MCP 서버는 Claude Desktop에 타입이 있는 도구와, 스스로 고칠 수 있는 구조화된 오류를 제공합니다. 대신 Claude에 보관함 폴더 직접 접근 권한을 주면, Obsidian에서 직접 하듯 마크다운 작업 줄을 편집할 수 있습니다.

제 데이터가 어딘가로 전송되나요?

이미 실행하기로 선택한 Claude에게만 전달됩니다. taskforge 서버 자체는 로컬에서 동작하며, 보관함 안의 마크다운 파일만 다루고 네트워크 호출은 하지 않습니다. TaskForge 계정도 클라우드도 없습니다.

이건 어떤 Claude와 함께 동작하나요?

MCP 클라이언트가 있는 Claude Desktop이 일반적인 선택입니다. Claude Code도 동작하며, 그것을 쓰신다면 터미널 워크플로를 위한 전용 안내가 따로 있습니다.

Claude가 엉뚱한 작업을 삭제하면 어떻게 되나요?

delete_task는 무엇이든 삭제되기 전에 모델이 작업의 현재 제목을 정확히 그대로 되돌려주게 하며, 이는 오래되었거나 잘못 지어낸 id를 걸러내는 안전장치입니다. 그리고 보관함은 일반 폴더이므로 git, iCloud, Obsidian Sync가 이미 버전을 관리하고 있어, 잘못된 편집도 되돌리기 한 번이면 끝입니다.

관련 설정

TaskForge는 Claude뿐 아니라 파일을 다룰 수 있는 어떤 에이전트와도 동작합니다. AI 개요 페이지는 전체 그림을 다루고, MCP와 CLI 페이지는 각 방법을 자세히 다룹니다.

Claude가 닿을 수 있는 곳에 작업을 두세요.

내 보관함 속 일반 마크다운. TaskForge는 iPhone, iPad, Mac, Android, Windows에서 무료로 다운로드할 수 있습니다.