Skip to main content

概要

以下の 4 つのツールで、ノートのタイトルとフォルダの構成を変更できます。
  • update_note — ノートのタイトルを更新します。スコープ mcp:note:write
  • update_folder — フォルダのタイトル・説明・色を更新します。スコープ mcp:folder:write
  • move_folder — フォルダを別の親の下へ、またはワークスペースのルートへ移動します。スコープ mcp:folder:write
  • reorder_folders — 同じ親の下にある兄弟フォルダを並べ替えます。スコープ mcp:folder:write
使うとき
  • 会議後、実際の内容を反映するようにノートのタイトルを付け直すとき。
  • フォルダ名を変更したり、説明を整理したり、一目でグループがわかるように色を変えたりするとき。
  • フォルダツリーを再構成するとき: フォルダを別のフォルダの下にネストする、ワークスペースのルートに昇格させる、兄弟フォルダの表示順を変える。
アカウントのAPIキーとワークスペースのAPIキーの違い(フォルダツール)。 update_foldermove_folderreorder_folders の場合: アカウントのAPIキーは編集権限を持つフォルダ(個人またはチーム)であれば何でも編集できます。ワークスペースのAPIキーは ワークスペースの全メンバーに共有されたフォルダのみ を編集できます。個人フォルダと一部のメンバーにだけ共有したフォルダは拒否されます(システムAPIキーが読み取るノートの範囲)。update_note はアカウント・ワークスペース・組織のいずれのAPIキーでも動作します。

update_note

ノートのタイトルを更新します。

パラメータ

リクエスト:
レスポンス:

update_folder

フォルダのタイトル・説明・色を更新します。AIP-134 の field-mask による更新で、渡したフィールドのみが変更され、省略したフィールドはそのまま維持されます。少なくとも 1 つのフィールドが必須です。

パラメータ

titledescriptioncolor のうち少なくとも 1 つを指定する必要があります。省略したフィールドは変更されません。たとえばタイトルを再送信せずに色だけを変更できます。

リクエスト:
レスポンス:

move_folder

フォルダを別の親の下へ、またはワークスペースのルートへ移動します。

パラメータ

リクエスト:
フォルダ 12346 をフォルダ 12345 の下へ移動します。 レスポンス:
フォルダをワークスペースのルートへ移動するには、newParentId を省略します(または null を渡します)。 リクエスト:

reorder_folders

兄弟フォルダを並べ替えます。1 つの兄弟セットの完全な希望順を渡してください。ワークスペースは最初のフォルダ ID から推定されます。

パラメータ

リクエスト:
3 つの兄弟フォルダを指定した順序で並べ替えます。 レスポンス:

スコープ要件

update_notemcp:note:write スコープを必要とし、update_foldermove_folderreorder_foldersmcp:folder:write スコープを必要とします。
API key は key に設定されたスコープに従います — スコープ未指定の key、および note:write/folder:write を持つ key がこれらのツールを呼び出せます。OAuth クライアント は、接続時の consent 画面で 読み取り + 書き込み を選択したトークンのみ呼び出せます。
API key は Tiro Platform API Keys で構成してください。

関連ツール

  • get_note — タイトルを更新する前に、ノートの現在のメタデータを確認します。
  • フォルダ検索 — 編集・移動・並べ替えの前に、名前からフォルダの folderId を見つけます。
  • get_note_folders — ノートが属するフォルダの一覧を取得します。