Skip to content

[機能要望] deleteDocument ツールの追加 #64

@k-kuroda-dac

Description

@k-kuroda-dac

概要

ドキュメントの削除(deleteDocument)ツールの追加を要望します。

背景

v0.4.0 で追加されたドキュメント関連ツール(#8)は取得系(get_documents / get_document / get_document_tree)の3つで、v0.7.0 で作成(addDocument, #42)が追加されました。

しかし、Backlog API には DELETE /api/v2/documents/:documentId エンドポイントが存在し、backlog-js にも deleteDocument() メソッドが実装済みであるにもかかわらず、MCP サーバーには deleteDocument ツールが未実装の状態です。

ドキュメントの作成・更新のサイクルにおいて、不要になったドキュメントを AI エージェント経由で削除できないため、手動で Backlog UI から削除する必要があります。

実装してほしいツール

ツール名 対応 API 説明
deleteDocument DELETE /api/v2/documents/:documentId 指定したドキュメントを削除する

DELETE API の挙動について

実テストにより、DELETE /api/v2/documents/:documentId完全削除(ハードデリート) であることを確認しました。

  • 削除後のドキュメントは 404 で取得不可(復元不能)
  • Backlog UI にある「ゴミ箱に移動」(ソフトデリート)とは異なり、DELETE API は不可逆な削除を実行します
  • Document Tree API の trashTree には移動しません

そのため、ツールの説明文(description)には 削除が不可逆であること を明記することを推奨します。

API 仕様

備考

  • backlog-js には既に deleteDocument() が実装されています(PR #128
  • 他のリソース(Issue, Wiki 等)では既に削除ツールが提供されており、ドキュメントのみ欠落している状態です

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions