ToDoリストをエージェントに任せましょう

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"
      }
    }
  }
}

Windows では npx の前に cmd /c を付けてください。Claude Desktop などのデスクトップ MCP クライアントはシェルを介さずにサーバーを起動しますが、npx は .cmd スクリプトのため、Windows ではシェル経由でしか実行できません:

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

npxではなくソースからtaskforgeをビルドしましたか。その場合は設定をバイナリに直接向けてください。

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

MCPクライアントはデスクトップで動くため、デスクトップ版のみです。taskforgeはmacOS、Windows向けに単一のネイティブバイナリとして配布され、MCPサーバーはそのサブコマンドの一つです。Linux版は近日公開予定です。

ツールセットの全体像

合計30個のツールで、タスクとノートのライフサイクル全体を扱えます。作成、読み取り、更新、完了、アーカイブ、削除にはそれぞれ一括版があります。さらに、移動、親の付け替え、インライン行とタスクファイルの相互変換、リンクを壊さないノートの作成・名前変更・削除・編集、書き込み前のlintチェック、保管庫の状態を確認するdoctor呼び出し、エージェントが操作前に形式を把握するためのdialectとspacesのリソースがあります。以下の6つは特によく使うものです。呼び出しのたびにディスクから保管庫を読み直すので、エージェントは常に最新のファイルに対して操作します。

各ツールにはアノテーションが付いているので、クライアントはどの呼び出しが読み取り専用で、どれが書き込みを行い、どれが削除するのかを一目で判別できます。残りのツールセットには、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_spaces、create_note、read_note、update_note、patch_note_block、patch_note_frontmatter、delete_note、move_note、normalize_references、get_dialectも含まれます。

3つのリソース

ツールに加えて、サーバーは読み取り専用のコンテキストも公開しています。エージェントは操作の前に、これで保管庫のルールを把握します。

保管庫が見つからない場合

サーバーは、保管庫の場所がまだわからない段階でも常に起動するので、Claude Desktopが「server failed to start」のような原因のわからないエラーを表示することはありません。ツール呼び出しが保管庫を解決できないとき、サーバーはエージェントがそのまま伝えられる明快なエラーを返します。TASKFORGE_VAULT 環境変数に保管庫のパスを設定するか、バンドルを再インストールしてプロンプトが出たら保管庫ディレクトリを入力してください。

ローカルのみ

TaskForge MCPサーバーはローカルで動作し、保管庫のMarkdownファイルを読み書きします。npx経由でインストールすると、パッケージがnpmからダウンロードされます。お使いのAIクライアントは、ツールの入力と結果をそのプロバイダーに送信することがあり、そのプライバシー設定が引き続き適用されます。デバイス間での変更の反映は、すでにお使いの保管庫の同期サービスが行います。

ターミナル派ですか？

エージェントから操作するのではなく、タスクをスクリプト化したり単発のコマンドを実行したりしたい場合は、taskforge CLIが同じ保管庫を同じルールでカバーします。

よくある質問