ツール

エージェントが利用できる MCP ツールの一覧です。

このページでは、現在利用できる MCP ツールを紹介します。ツール名は CLI のコマンド名に対応します。たとえば epismo_case_start は epismo case start に対応します。

公開カタログや公開案件の閲覧、UUID を指定した公開プレイブックの取得には OAuth 認証が不要で、クレジットも消費しません。書き込み、非公開データの取得、検索語を指定した検索、エイリアスや本人情報の取得には Authorization: Bearer <oauth_access_token> が必要です。認証が必要な呼び出しには 401 の OAuth チャレンジが返ります。接続やツール一覧の取得だけならログインは不要です。

チーム

epismo_team_list
epismo_team_create
epismo_team_update
epismo_team_member_list
epismo_team_member_add
epismo_team_member_delete

チームのツールは、認証時に選択されたワークスペースを使います。案件の ACL を設定する前に epismo_team_list で一覧を取得し、general などの名前に対応するチーム ID を確認してください。

案件

epismo_case_start
epismo_case_get
epismo_case_list
epismo_case_popular
epismo_case_access_get
epismo_case_access_set
epismo_case_share
epismo_case_assign
epismo_case_update
epismo_case_handoff_create
epismo_case_handoff_remove
epismo_case_handoff_candidates_list
epismo_case_handoff_graph_get
epismo_case_review
epismo_case_brief_set
epismo_case_brief_delete
epismo_case_brief_generate
epismo_case_close
epismo_case_reopen

プレイブックに基づく案件を始める場合は versionId を指定します。プレイブックを使わない場合は、versionId を省略してタイトルを指定します。autoReview を設定すると、開始時または更新時に成果物の記録が追加された際、Epismo AI のレビューがキューに入ります。費用は案件開始時に確定した請求先に課金されます。担当者の変更と ACL の変更は別々の操作です。既存の案件を変更する際は、最新のロックバージョンを指定してください。

epismo_case_handoff_create で案件同士を引き継ぎ関係で結びます。元の案件を閲覧でき、引き継ぎ先の案件を編集できる場合は、epismo_case_handoff_remove で不要な関係を削除できます。epismo_case_handoff_candidates_list は循環を生まない候補を返し、epismo_case_handoff_graph_get は引き継ぎ関係全体を返します。epismo_case_list は自分が関わる案件を、epismo_case_popular は公開案件のランキングを表示します。

外部ソース

epismo_case_source_link
epismo_case_source_unlink
epismo_case_source_refresh
epismo_case_source_get

現在のスペースに接続した本人のアカウントで、Slack スレッドまたは Google Docs・Sheets・Slides のファイルを紐づけます。Slack はワークスペース専用で、Google Drive は個人スペースとワークスペースの両方に対応します。Google Drive は先に Web で接続し、Google Picker でファイルを選択してください。URL だけではアクセス権は付与されません。Google Drive のプロバイダーキーは gdrive です。紐づけ・解除は各2クレジットで、初回の取得は紐づけ料金に含まれます。手動・自動の再取得は完了時に、そのソースを持つ案件の課金アカウントへ1クレジットを計上します。終了済み案件では明示的な再取得依頼だけを処理します。依頼の受付、失敗、ページ分割、再試行は無料です。複数の依頼を1回の取得にまとめた場合、その案件への課金は1回だけです。case get の sources は案件の作業共有先だけに返されます。閲覧は保存済みの内容を使うため、状態と日時を確認してください。内容が省略された場合は、ソース ID で最新の保存内容全体を取得します。過去の内容は保持しません。外部ソースは記録とは別で、公開閲覧者には返しません。共有範囲・自動更新・取得内容の削除についてはSlack ・ Google Driveを参照してください。

4つのツールは caseId を指定します。紐づけは url、取得・再取得・解除は sourceId も指定します。書き込みは idempotencyKey を使います。epismo_case_get の snapshotOmitted・checkedAt・snapshot.capturedAt を確認してください。

タスク

epismo_case_task_create
epismo_case_task_list
epismo_task_list
epismo_case_task_get
epismo_case_task_update
epismo_case_task_set_status

案件の開始時にはタスクは作成されません。担当や承認を明示する必要がある場合に、作業用の work タスク、または承認用の approval タスクを作成します。承認タスクでは、subjectRecordId に対象の記録を指定できます。epismo_case_task_update はタスクの内容や担当者を変更し、epismo_case_task_set_status は結果を付けてタスクを完了、または再開します。

記録

epismo_case_record_append
epismo_case_record_update
epismo_case_record_delete
epismo_case_record_list

作成者は自分の記録を更新・削除できますが、システムが作成した記録は変更できません。クライアントが指定できる kind は note、output、review です。review の data.verdict は pass、changes_requested、insufficient のいずれかです。activity はサーバー専用です。削除すると本文とデータが消去され、ID と deleted_at を持つ削除済みの記録が残ります。

epismo_case_record_list では、scope に self、ancestors、descendants、neighbors、connected を指定して、引き継ぎでつながる案件の記録も取得できます。taskId、createdBy、kinds、origins、acl で絞り込み、並び順とカーソルを指定してページを送れます。絞り込みで閲覧権限が広がることはありません。

案件の編集者は epismo_case_review で Epismo AI のレビューを依頼できます。呼び出しはすぐに返り、完了したレビューは epismo_case_record_list に kinds=review と origins=system を指定して確認できます。同じ冪等性キーで再試行しても取得できます。prompt を指定すると、所定のレビュー規則に指示を追加できます。

案件には、終了後も、280文字以内の一文を保存する Brief があります。アーカイブした案件は変更できません。案件の取得・一覧で brief（updatedAt、content）を返し、読み取りでは生成しません。案件の編集者は case brief set / epismo_case_brief_set（PUT /v1/cases/{caseId}/brief）で空でない本文を設定し、case brief delete / epismo_case_brief_delete（DELETE /v1/cases/{caseId}/brief）で削除できます。case brief generate / epismo_case_brief_generate（POST /v1/cases/{caseId}/brief）は同期的に本文を生成・保存し、履歴の Record は追記しません。同じ冪等性キーの再送では、その呼び出しで保存した Brief を返します。set と delete は update 系の操作としてそれぞれ、操作した人が選択中のワークスペース（未選択なら個人アカウント）から2 credits、generate は開始時に固定した案件の billing account から消費 token に応じて課金します。generate には Epismo AI の許可が必要で、ウェブ検索は使いません。review は Brief を更新しません。接続先の証拠は、保存先案件の全閲覧者が読める場合だけ利用します。公開案件では、保存した Brief も公開されます。

プレイブック、バージョン、エイリアス

epismo_playbook_list
epismo_playbook_search
epismo_playbook_resource_list
epismo_playbook_get
epismo_playbook_copy
epismo_playbook_copies_list
epismo_playbook_create
epismo_playbook_draft_get
epismo_playbook_draft_save
epismo_playbook_draft_publish
epismo_playbook_draft_discard
epismo_playbook_version_list
epismo_playbook_version_get
epismo_playbook_version_publish
epismo_playbook_version_archive
epismo_playbook_access_get
epismo_playbook_access_set
epismo_playbook_owner_transfer
epismo_playbook_alias_set
epismo_playbook_alias_list
epismo_playbook_alias_delete
epismo_playbook_share
epismo_playbook_archive

epismo_playbook_get は UUID または pb:alias / pb:handle/alias 形式の参照を受け付けます。epismo_playbook_list は更新日時が新しい順に一覧を返し、epismo_playbook_search はテキストまたは pb: 形式の参照を検索します。

epismo_playbook_access_get と epismo_playbook_access_set は、公開範囲を表す visibility と編集者を扱います。公開設定で許可されるのは公開済みコンテンツの閲覧だけです。ワークスペースが所有するプレイブックの公開済みバージョンは、所属メンバー全員が閲覧できます。ワークスペースのオーナーと管理者は、編集者に追加されていなくても編集できます。それ以外のメンバーが編集するには、本人または所属チームへの編集権限の付与が必要です。所属メンバーはそのワークスペース名義でプレイブックを作成できます。epismo_playbook_owner_transfer で個人所有の非公開プレイブックをワークスペースに移すこともできます。編集者は、自分以外のユーザーを1人以上、またはチームを1つ以上、編集権限を持つ共有先として残せば、公開範囲と共有先を変更できます。共有先をすべて削除する操作と、プレイブックや過去のバージョンのアーカイブは、プレイブックの所有者、または所有元ワークスペースのオーナー・管理者だけが行えます。最新版のアーカイブもできません。

提案

epismo_playbook_suggestion_create
epismo_playbook_suggestion_list
epismo_suggestion_list
epismo_playbook_suggestion_get
epismo_playbook_suggestion_update
epismo_playbook_suggestion_resolve

提案は、変更できない既存のバージョンを基に作成します。epismo_suggestion_list は、既定では自分が送った提案を返します。管理するプレイブックに届いた提案を見るには view="inbox" を指定します。未解決の提案は作成者が編集でき、プレイブックの所有者が解決します。applied として解決する場合は、変更を反映したバージョンの ID が必要です。解決しても自動的には公開されません。

クレジット

epismo_credit_balance
epismo_credit_checkout

クレジットのツールは、ワークスペースを利用中ならそのアカウント、そうでなければ個人アカウントを使います。epismo_credit_checkout は購入手続き用のページを開くための URL を返します。呼び出しただけではクレジットは追加されません。

ツールを呼び出す際の注意

ロックバージョンや基になるバージョンが必要な変更では、先に最新の状態を取得します。
ツールが冪等性キーを求める場合は、操作ごとに新しい UUID を生成します。結果が不明な同じ操作の再試行に限り、同じキーを使います。
競合が起きたら最新の状態を読み直し、変更内容がまだ適切か確認します。
一時的な実行情報はクライアント側に残し、共同作業に必要な情報だけを Epismo に保存します。

作成と共有設定の更新は access: { visibility, grants } を使います。公開範囲は private/public、共有先はユーザー・チームの UUID をキーに viewer/editor を指定します。更新は設定全体を置き換えるため、無関係な共有先を保持してください。public は共有先のキーには使いません。閲覧者は編集できず、プレイブックの下書きには編集権限が必要です。所有者と案件担当者は管理権限を保持します。設定全体の取得は管理者の access-get を使います。通常のリソース JSON は非公開の共有先マップを含みません。アクセスと権限も参照してください。

読める公開済みバージョンをコピーして、独立した内容として調整できます。コピーは独自の内容とバージョンを持ち、共有設定、下書き、案件、提案、エイリアス、スター、履歴を引き継ぎません。編集は同期されません。API/CLI/MCP では所有者と共有設定を明示してください。copiedFrom は直近の元プレイブックと固定バージョンを保持し、sourceAccessible は元を現在も読めるかを示します。コピー一覧には読めるものだけを返します。料金は通常のプレイブック作成と同じです。