利用できるツール
TWP MCP サーバーの各エンドポイントで呼び出せるツールの一覧です。ツールは AI クライアントが自動的に選択して呼び出すため、通常は個別のツール名を意識する必要はありませんが、何ができるかの目安としてご利用ください。
利用できるツールは、API キーに付与した権限(スコープ)とアカウントの利用権限の範囲に制限されます。
コア https://mcp.tocca.systems/api/mcp
日常的なプロジェクト・タスク運用の中心となるエンドポイントです。
プロジェクト
list_projects— プロジェクト一覧の取得get_project— プロジェクト詳細の取得create_project— プロジェクトの作成update_project— プロジェクトの更新
タスク
list_tasks— タスク一覧の取得・検索get_task— タスク詳細の取得create_task— タスクの作成update_task— タスクの更新(ステータス・担当者変更等)delete_task— タスクの削除
コメント
list_comments— コメント一覧の取得create_comment— コメントの投稿(質問形式の投稿も可)update_comment/delete_comment— コメントの更新・削除
添付ファイル
list_task_attachments/get_task_attachment— 添付の一覧・取得generate_upload_url/commit_task_attachment— 添付のアップロードget_download_url— ダウンロードURLの取得explain_attachment— 添付内容の説明delete_task_attachment— 添付の削除
ステータス・マスタ・ユーザー
list_statuses— タスクステータス一覧list_types/list_categories/list_labels/list_milestones— 各種マスタの一覧list_users— ユーザー一覧
通知
list_notifications/get_notification/get_notification_counts— 通知の取得mark_notification_read/mark_all_notifications_read— 既読操作
仕様変更のお知らせ:以前はコアエンドポイントにノート・ヒアリングのツールも含まれていましたが、それぞれ専用エンドポイント(
/api/mcp/note・/api/mcp/hearing)に移動しました。引き続きご利用になる場合は、下記の専用エンドポイントを追加で登録してください。
レポート https://mcp.tocca.systems/api/mcp/report
list_reports/get_report/create_report/update_report/complete_report/delete_reportreview_report/mark_report_as_readlist_report_formats/get_report_formatlist_report_comments/create_report_comment
ノート https://mcp.tocca.systems/api/mcp/note
ナレッジベース(ノート)専用のエンドポイントです。
- ノート:
list_notes/search_notes/get_note/create_note/update_note/delete_note - ノートのコメント:
list_note_comments/create_note_comment/update_note_comment/delete_note_comment - ノートのカテゴリ:
list_note_categories/create_note_category/update_note_category/delete_note_category
ヒアリング https://mcp.tocca.systems/api/mcp/hearing
ヒアリング(ヒアリング内容・セッション・トラッカー)を参照する専用のエンドポイントです。
list_hearings— ヒアリング一覧の取得get_hearing— ヒアリング詳細の取得list_hearing_sessions— ヒアリングセッション一覧の取得get_hearing_session— ヒアリングセッション詳細の取得list_hearing_trackers— ヒアリングトラッカー一覧の取得
参照のみのエンドポイントです。ヒアリングの作成・設計・招待はTWPの画面から行います(ヒアリングの使い方)。
取引 https://mcp.tocca.systems/api/mcp/sales
見積・契約・請求・入金などの販売管理機能です。
- 見積:
list_estimates/get_estimate/create_estimate/update_estimate - 契約:
list_contracts/get_contract/create_contract/update_contract - 請求:
list_invoices/get_invoice/create_invoice/update_invoice - 入金:
list_deposits/get_deposit/create_deposit/update_deposit - マスタ(読み取り):
list_sales_companies/list_business_places/list_payees/list_seal_impressionsほか
アプローチ先 https://mcp.tocca.systems/api/mcp/prospect
まだ取引の始まっていないアプローチ先(見込客)と、そのアプローチ履歴を扱うエンドポイントです。
- アプローチ先:
search_prospects/get_prospect/create_prospect/bulk_create_prospects/update_prospect/delete_prospect - アプローチ履歴:
list_prospect_activities/create_prospect_activity - 選択肢・マスタ(読み取り):
list_prospect_campaigns/list_prospect_activity_options
一覧の取得結果は items に入り、ページ送りは next_cursor をたどるカーソル方式です(ページ番号は使いません)。詳しくは下の「一覧取得の共通ルール」をご覧ください。
顧客への昇格は取り消せない操作のため、TWPの画面からのみ行えます(アプローチ先の使い方)。
サポート依頼 https://mcp.tocca.systems/api/mcp/support
TWP運営へのサポート依頼を、画面を開かずに起票・確認できるエンドポイントです。
- カテゴリ(読み取り):
list_support_categories - 依頼:
list_supports/get_support/create_support - コメント:
create_support_comment
起票には category_id が必要です。先に list_support_categories でカテゴリを取得してください。
get_support は依頼の詳細とあわせてコメント履歴・ステータス履歴を返します。
list_supports は status で絞り込めます(new 未対応 / in_progress 対応中 / waiting 対応済み・ご確認待ち / re_inquiry 再問い合わせ / closed 完了 / withdrawn 取り下げ)。
見えるのは自分が起票した依頼だけです(サポート機能の管理者はテナント内の全件)。
依頼内容の修正・取り下げ・完了・再問い合わせ、および添付ファイルの追加はTWPの画面から行ってください。
個人連携 https://mcp.tocca.systems/api/mcp/personal
Backlog・Microsoft 365 との個人連携ツールです。利用には TWP 側で各サービスの連携設定が必要です。
Backlog
backlog_list_issues/backlog_get_issue/backlog_create_issue/backlog_update_issue/backlog_delete_issuebacklog_list_projects/backlog_list_statuses/backlog_list_usersほか- コメント・添付ファイル操作
Microsoft 365
- Outlook:
outlook_list_messages/outlook_get_message/outlook_send_message/outlook_reply_messageほか - Teams:
teams_list_teams/teams_list_channels/teams_send_channel_message/teams_list_chatsほか - OneDrive/SharePoint:
drive_list_files/drive_download_file/drive_upload_file/drive_create_sharing_linkほか - カレンダー:
calendar_list_events/calendar_create_event/calendar_update_event/calendar_delete_event
一覧取得の共通ルール
一覧系ツール(list_* / search_*)の結果は、どのエンドポイントでも取得した行が items に入ります(list という項目はありません)。
ページ送りの情報は、エンドポイントによって置き場所が2通りあります。どちらの項目名も同じ意味です。
| 置き場所 | 例 |
|---|---|
pagination の下(pagination.total など) | タスク・コメント・ノート・プロジェクト・レポートなど |
最上位(total など) | アプローチ先(search_prospects / list_prospect_activities) |
| 項目 | 意味 |
|---|---|
total | 総件数。null は「件数不明」であって 0 件ではありません。2ページ目以降は null になります |
has_more | 次のページがあるかどうか |
next_cursor | 次のページを取るための値。次の呼び出しで cursor に渡します |
- ページ送りはカーソル方式です。
page_no/page_limitのようなページ番号は受け付けず、指定しても無視されます。has_moreがfalseになるまでnext_cursorをたどってください totalに件数が入っているのに行が空に見えるときは、読み取っている項目名をご確認ください。 存在しない項目を読んでもエラーにはならず、空として扱われます
ツールの詳細な引数や最新の一覧は、MCP サーバーのトップページ
https://mcp.tocca.systemsでも確認できます。