エージェントに、あなたのTo-Doリストを任せよう

MCPかCLIか

エージェントがすでにTaskForgeへのMCP接続を持っているなら、MCPツールを使うのがおすすめです。型があり、エージェントが自己修正できる構造化されたエラーを返し、PATHに何も必要ありません。MCP接続のないシェル環境、スクリプトやcron、CI、リポジトリのチェックアウト内で動くコーディングエージェントなどでは、代わりにCLIを使ってください。どちらも同じエンジンを同じ意味論で動かすので、ランタイムにすでに用意されている方を選べば十分です。vaultファイルを手で編集するのは最後の手段です。

インストール

{
  "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チェック、vaultの状態を確認するdoctor呼び出し、そしてエージェントが操作前にフォーマットを学習するためのスキーマ・リストリソースも含まれます。以下の6つは特によく使うものです。呼び出しのたびにディスクからvaultを読み直すので、エージェントは常に最新のファイルに対して動作します。

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

3つのリソース

ツールに加えて、サーバーは読み取り専用のコンテキストも公開しています。エージェントは行動する前に、これであなたのvaultのルールを学習します。

vaultが見つからない場合

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

ローカルのみ

taskforge mcp --stdioは、設定したvault内のマークダウンファイルだけを読み書きします。それ以外には何もしません。アカウントもクラウドも不要です。iCloud、Dropbox、Obsidian Syncなど、すでにお使いの同期の仕組みが、変更をデバイス間で運びます。

ターミナル派ですか？

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

よくある質問