MCP連携 概要
TWPは MCP（Model Context Protocol）サーバー を公開しています。Claude Code をはじめとする MCP 対応の AI クライアントから、TWP のプロジェクト・タスク・ノート・レポートなどを直接操作できます。
「AI に指示するだけで、TWP のタスク一覧を取得したり、コメントを追加したり、レポートを作成したり」が、画面を開かずに行えるようになります。
はじめての方へ：APIキーの発行から Claude Code での接続までの具体的な手順は Claude Code セットアップ にまとめています。まずはそちらをご覧ください。
MCP とは
MCP（Model Context Protocol）は、AI アシスタントと外部システムを接続するためのオープンな標準規格です。MCP に対応したクライアント（Claude Code など）に TWP の MCP サーバーを登録すると、AI が TWP の機能を「ツール」として呼び出せるようになります。
[Claude Code など] ──(MCP / HTTP)──▶ [TWP MCPサーバー] ──▶ [TWP]
AIクライアント mcp.tocca.systemsREST API との違い
TWP には 2 種類の外部連携インターフェースがあります。目的に応じて使い分けてください。
| MCP連携（本セクション） | 公開REST API | |
|---|---|---|
| 用途 | AIクライアント（Claude Code等）からの操作 | 自社Webサイト・アプリへの組み込み |
| 接続先 | https://mcp.tocca.systems | https://api.tocca.systems |
| 認証ヘッダー | Authorization: Bearer twpu_... | X-API-Key: ... |
| 認証方式 | 個人用APIキー（twpu_）または TWPアカウントでのログイン（OAuth） | 組織APIキー（twpk_） |
| 主な対象 | プロジェクト / タスク / ノート / レポート / 取引 等 | コンテンツ / 問い合わせ |
よくある間違い：MCP連携では、「組織管理」→「APIキー」で発行する API キー（
twpk_）ではなく、個人用 API キー（twpu_） を使用します。組織APIキーは CMS・問い合わせ用のため、MCP サーバーでは利用できません。
エンドポイント一覧
TWP MCP サーバーは、扱う機能ごとに複数のエンドポイントに分かれています。すべて Streamable HTTP トランスポートを使用します。通常はコアエンドポイント（/api/mcp）を登録すれば、日常的なプロジェクト・タスク操作をカバーできます。
| エンドポイント | 主な機能 |
|---|---|
https://mcp.tocca.systems/api/mcp | コア（プロジェクト・タスク・コメント・添付・ステータス・通知・ユーザー） |
https://mcp.tocca.systems/api/mcp/report | レポート管理 |
https://mcp.tocca.systems/api/mcp/note | ノート（ナレッジベース） |
https://mcp.tocca.systems/api/mcp/hearing | ヒアリング |
https://mcp.tocca.systems/api/mcp/sales | 取引（見積・契約・請求・入金） |
https://mcp.tocca.systems/api/mcp/prospect | アプローチ先（見込客）とアプローチ履歴 |
https://mcp.tocca.systems/api/mcp/customer | 顧客（顧客企業・人物/担当者・対応履歴） |
https://mcp.tocca.systems/api/mcp/attendance | 自分の勤怠（参照のみ） |
https://mcp.tocca.systems/api/mcp/budget | 予実管理の部署按分設定・目標の参照・登録 |
https://mcp.tocca.systems/api/mcp/support | TWP運営へのサポート依頼 |
https://mcp.tocca.systems/api/mcp/worker-agent | ワーカーエージェントの作成・実行・結果確認（手順） |
https://mcp.tocca.systems/api/mcp/project-master | プロジェクトマスタ（工程・品質チェック項目）の取得・追加・編集 |
https://mcp.tocca.systems/api/mcp/personal | 個人連携（Backlog・Microsoft 365） |
仕様変更のお知らせ：これまでコアエンドポイント（
/api/mcp）に含まれていたノート・ヒアリングのツールは、専用エンドポイントに移動しました。コアだけを登録している場合、これらのツールは呼び出せなくなります。引き続きご利用になる場合は、ノートは/api/mcp/note、ヒアリングは/api/mcp/hearingを追加で登録してください（登録方法は Claude Code セットアップ の「複数エンドポイントを登録する」を参照）。
各エンドポイントで利用できるツールの一覧は 利用できるツール をご覧ください。
認証
MCP サーバーへの接続方法は 2 通りあります。
| 方式 | 使い方 | 権限の設定場所 |
|---|---|---|
| 個人用 API キー | 発行した twpu_ キーを Authorization: Bearer twpu_... として送る | 「プロフィール設定」→「APIキー」（キーごとに設定） |
| TWPアカウントでのログイン（OAuth） | キーを登録せずに接続し、初回にブラウザで TWP にログインする | 「プロフィール設定」→「動的OAuth設定」（アカウント単位で設定） |
Authorization: Bearer twpu_xxxxxxxxxxxxxxxxAPI キーの発行方法は Claude Code セットアップ のステップ1で、OAuth での接続方法は同ページの「TWPアカウントでログインして接続する（OAuth）」 で説明します。
OAuth で接続できるのは MCP サーバーだけです。公開REST API（コンテンツ・問い合わせ）は、引き続き組織APIキー（
twpk_）で利用してください。
次のステップ
- Claude Code セットアップ — API キー発行から接続までの具体的な手順
- 利用できるツール — 各エンドポイントで呼び出せるツールの一覧
- トラブルシューティング — 接続できないときの確認ポイント
AI クライアントを用意せず、ターミナルから直接 TWP を操作したい場合は TWP CLI もご利用いただけます。