Skip to content

MCP

接続前に参照できる静的なカタログです。接続後の tools/list同じ全 tool を返します—— 権限による絞り込みはしません。

実際に呼べるかは呼び出したときに決まります。 権限が足りなければ 403 が返り、 その応答にどの権限が足りないかが入っています。一覧に出ていることは、呼べることを意味しません。

protocol 2026-07-28 / server 1.6.0 / 70 tools。 カタログの生データは /mcp/catalog/ にあります。

読み方

  • 説明は AI クライアントが受け取る文そのものです。この資料のために書き換えていません。
  • scope は、その tool を使うために資格情報へ与えておく必要のある権限です。 実際に呼べるかは、利用者本人の権限とので決まります。 引数によって必要な権限が変わる tool は、候補を全部挙げたうえで何で決まるかを添えています。
  • 破壊的な更新と付いた tool は、既存のデータを上書き・削除しうるものです。 付いていない書き込みは追加のみを行います。
  • 変更系の tool は validate_ で始まる対を持ち、先に検証してから実行するのが想定の手順です。検証は何度呼んでも状態を変えません。 対を持たないのは次だけです:change_qa_inquiry_exclusionexecute_immediate_applicationmanage_application_commentssubmit_application_input

tool の一覧

基本

whoami読み取りのみme:read
認証された kouro.ai の利用者情報と、実行できる操作を返す。
get_message_catalog読み取りのみreference:read
地域化された公開メッセージカタログを返す。
get_work_dashboard読み取りのみapplication:read(resource により決まる)
呼び出し元向けの申請ダッシュボードを 1 件返す。

申請種別とフォーム

list_application_types読み取りのみapplication_type:read
認証された利用者が起票できる申請種別を一覧する。
get_form_guide読み取りのみapplication_type:read
起票できる申請種別について、入力検証の観点で項目の手引きを返す。
search_application_targets読み取りのみapplication_type:read
起票できる申請種別について、サービスが管理する対象を検索する。
get_application_target読み取りのみapplication_type:read
申請対象 1 件について、現在許可されている時点情報と版を返す。
search_form_options読み取りのみapplication_type:read
起票できるフォーム項目について、サーバーが宣言した選択肢を検索する。
get_application_type_initiation読み取りのみapplication_type:read
申請種別について、権限のある起票方式とフォームを返す。

申請をつくる・出す

validate_draft読み取りのみapplication:submit
下書きを作らず冪等キーも予約せずに、下書きの内容を検証する。
create_draft追加のみapplication:submit
検証を通したうえで申請の下書きを作成する。
validate_submit_application読み取りのみapplication:submit
ワークフローの状態を変えずに、下書きの提出可否を検証する。
submit_application破壊的な更新application:submit
申請の下書きを提出する。
validate_update_draft読み取りのみapplication:submit
申請を変更せずに、下書きデータの置き換え可否を検証する。
update_draft破壊的な更新application:submit
編集できる下書きのデータを置き換える。
validate_delete_draft読み取りのみapplication:submit
下書きを変更せずに、破棄の可否を検証する。
delete_draft破壊的な更新application:submit
編集できる下書きを破棄する。
validate_withdraw_application読み取りのみapplication:submit
ワークフローの状態を変えずに、取り下げの可否を検証する。
withdraw_application破壊的な更新application:submit
提出済みの申請を取り下げる。
validate_reapply_application読み取りのみapplication:submit
差し戻された、または却下された申請の再提出の可否を検証する。
reapply_application破壊的な更新application:submit
差し戻された、または却下された申請を再提出する。
submit_application_input破壊的な更新application:approveapplication:submit(mode により決まる)
承認段を承認せずに、申請者の入力または入力担当段の入力を提出する。
execute_immediate_application破壊的な更新application:submit
期待する公開フロー版に対して、小さなインラインファイルを含む即時完了の申請操作を実行する。

申請を読む

get_application読み取りのみapplication:read
認証された利用者が閲覧できる申請を 1 件返す。
list_my_applications読み取りのみapplication:read
認証された利用者が閲覧できる申請を一覧する。
list_application_history読み取りのみapplication:read
申請の閲覧できる履歴を一覧する。
get_application_runtime_view読み取りのみapplication:read
権限のある申請のビュー・イベント時系列・展開済みフローを返す。

承認・差し戻し・却下

list_pending_approvals読み取りのみapplication:read
認証された利用者の承認待ちを一覧する。includeUpcoming=true で将来担当予定を同じ一覧に含める。
validate_approve_task読み取りのみapplication:approve
未処理タスクを消費せずに、承認の可否を検証する。
approve_task破壊的な更新application:approve
未処理の承認タスクを承認する。
validate_reject_task読み取りのみapplication:reject
未処理タスクを消費せずに、却下の可否を検証する。
reject_task破壊的な更新application:reject
未処理の承認タスクを却下する。
validate_sendback_task読み取りのみapplication:sendback
未処理タスクを消費せずに、差し戻しの可否を検証する。
sendback_task破壊的な更新application:sendback
未処理の承認タスクを、許可された上流の段へ差し戻す。
get_approval_task読み取りのみapplication:read
閲覧できる承認タスクと、その時点で実行できる操作を返す。
list_sendback_targets読み取りのみapplication:read
未処理タスクについて、差し戻し先に指定できる段を一覧する。
get_approver_summary読み取りのみapplication:read
公開 v1 が出している承認者ダッシュボードの 4 つの件数を返す。upcoming は「承認中=関与する進行中申請すべて」で、PENDING / SENT_BACK / BLOCKED の現担当・対応済み・将来候補を申請IDで重複排除した件数。

添付とコメント

validate_upload_attachment読み取りのみapplication:submit
分割アップロードを始める前に、添付ファイルのメタデータを検証する。
upload_attachment追加のみapplication:submit
添付ファイルの分割アップロードを開始・追記・確定する。
list_attachments読み取りのみapplication:read
申請上で閲覧できる添付ファイルのメタデータを一覧する。
download_attachment読み取りのみapplication:read
閲覧できる添付ファイルに対して、短命の MCP リソースリンクを作る。
validate_delete_attachment読み取りのみapplication:submit
添付ファイルを変更せずに、削除の可否を検証する。
delete_attachment破壊的な更新application:submit
編集できる申請から添付ファイルを削除する。
manage_application_comments破壊的な更新application:readapplication:submit(action により決まる)
申請のコメントを一覧・投稿・編集・削除する。

通知

list_notifications読み取りのみnotification:read
認証された利用者の通知を一覧する。
validate_mark_notification_read読み取りのみnotification:write
通知を変更せずに、既読にできるかを検証する。
mark_notification_read追加のみnotification:write
通知を既読にする。
get_notification_summary読み取りのみnotification:read
呼び出し元のワークフローのバッジ件数を返す(差し戻しの未読・完了/却下の未読・自分宛ての承認待ちタスク数)。

組織と参照

search_employees読み取りのみuser:read
範囲を限定した条件で、公開されている社員の要約を検索する。
get_employee_profile読み取りのみuser:read
権限のある社員詳細、または公開されている社員項目カタログを返す。
browse_organization読み取りのみdepartment:readorg:readposition:read(resource により決まる)
読み取り専用の組織ディレクトリを参照する。
search_work_resources読み取りのみannouncement:readapplication:readcompany:readequipment:readexpense:readproject:read(resource により決まる)
業務資源・備品・申請に紐づく備品の貸出状況・お知らせを検索する。
lookup_reference_data読み取りのみqualification:readreference:read(resource により決まる)
公開されている郵便番号・銀行・支店・資格の参照データを引く。
get_employee_relationships読み取りのみuser:read
社員の申請履歴・配下・上長の連なりのいずれかを返す。

Q&A

use_qa_assistant読み取りのみqa:chat
個人の Q&A 履歴の一覧・質問例の一覧・社内資料に基づく回答の生成を行う。
get_qa_inquiry_exclusion読み取りのみqa:chat
問い合わせのナレッジ再利用対象外状態・版・変更可否を取得する。問い合わせの閲覧権限が必要。
change_qa_inquiry_exclusion破壊的な更新qa:chat
問い合わせをナレッジ再利用の対象外にする、または指定を解除する。本人・担当者のみ変更できる。解除しても過去の知識や処理は再開しない。

マスタを読む(汎用)

list_data_types読み取りのみme:read
呼び出し元が参照できるデータ種別(dataType)を一覧する。
describe_data_type読み取りのみannouncement:readcompany:readdepartment:readequipment:readexpense:readposition:readproject:readqualification:readuser:read(dataType により決まる)
データ種別の定義(項目・型・絞り込み / 並び替え / 検索の可否・既定の並び順)を返す。
list_data読み取りのみannouncement:readcompany:readdepartment:readequipment:readexpense:readposition:readproject:readqualification:readuser:read(dataType により決まる)
現在有効な確定済みデータを種別横断の共通形式で一覧する(絞り込み・並び替え・簡易検索・カーソルページング)。
get_data読み取りのみannouncement:readcompany:readdepartment:readequipment:readexpense:readposition:readproject:readqualification:readuser:read(dataType により決まる)
現在有効な確定済みデータを 1 件取得する。

フロー定義(内部管理者向け)

get_flow_authoring_context読み取りのみflow_definition:read
フロー編集の現在の主体・権限・反映可否を返す。
list_flow_definitions読み取りのみflow_definition:read
現在の管理者が閲覧できる、編集中または公開済みのフロー定義を一覧する。
get_flow_definition読み取りのみflow_definition:read
フロー定義 1 件と、その編集中リビジョン(整数)・不透明なリビジョントークンを返す。
get_flow_authoring_registry読み取りのみflow_definition:read
サーバーが正とする段・宛先・条件・効果・フォームの定義集を返す。
list_flow_authoring_candidates読み取りのみflow_definition:read
指定した版ちょうどのフロー定義について、テナント内の候補を検索する。
plan_flow_change読み取りのみflow_definition:read
型付きの変更意図をメモリ上で適用し、決定的な差分と提案のダイジェストを返す。
validate_flow_change読み取りのみflow_definition:read
定義を変更せずに、サーバーが正とする公開前検査をすべて実行する。
simulate_flow_change読み取りのみflow_definition:read
副作用なしに、実テナントのシナリオ 1 件を型付きの候補へ当てて模擬実行する。
commit_flow_change破壊的な更新flow_definition:update
事前に計画・確認した型付きの変更一式を、下書きへ不可分に反映する。