Skip to Content
MCP連携（Claude Code）概要

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.systems

REST API との違い

TWP には 2 種類の外部連携インターフェースがあります。目的に応じて使い分けてください。

MCP連携（本セクション）公開REST API
用途AIクライアント（Claude Code等）からの操作自社Webサイト・アプリへの組み込み
接続先https://mcp.tocca.systemshttps://{tenant}.api.tocca.systems
認証ヘッダーAuthorization: Bearer twpu_...X-API-Key: ...
使うAPIキー個人用APIキー（twpu_）組織APIキー（twpk_）
主な対象プロジェクト / タスク / ノート / レポート / 取引 等コンテンツ / 問い合わせ

よくある間違い：MCP連携では、組織設定で発行する 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/personal個人連携（Backlog・Microsoft 365）

仕様変更のお知らせ：これまでコアエンドポイント（/api/mcp）に含まれていたノート・ヒアリングのツールは、専用エンドポイントに移動しました。コアだけを登録している場合、これらのツールは呼び出せなくなります。引き続きご利用になる場合は、ノートは /api/mcp/note、ヒアリングは /api/mcp/hearing を追加で登録してください（登録方法は Claude Code セットアップ の「複数エンドポイントを登録する」を参照）。

各エンドポイントで利用できるツールの一覧は 利用できるツール をご覧ください。

認証

MCP サーバーへのリクエストには、個人用 API キーを Bearer トークン として付与します。

Authorization: Bearer twpu_xxxxxxxxxxxxxxxx

API キーの発行方法は Claude Code セットアップ のステップ1で説明します。

次のステップ

Last updated on
エラーコードClaude Code セットアップ