Claude Desktop で動く MCP サーバーを TypeScript で自作して npm publish するまで

Devuntu はかんばんボード、カレンダー連携、Slack 通知、MCP サーバー、AI エージェント機能を備えたセルフホスト型プロジェクト管理ツール。Claude Code でチケット処理を自動化でき、就寝中の処理や GitHub/GitLab 連携、AI コードレビュー自動化ワークフローに対応している。

MCP ツールを直接呼び出す従来方式と、エージェントがコードを書いて実行する方式の 2 パターンで、顧客注文の集計タスクのトークン消費量を実測比較。直接呼び出し版では 10 本のツール定義と全件の生データが context に蓄積されるのに対し、コード実行版では必要なツール定義のみ読み込んで集計処理をコード内で完結させ、最終結果だけを返す設計で context 圧縮を実現。

Claude Code と n8n の MCP を組み合わせ、LINE 問い合わせ対応ワークフロー（32ノード）を1日で構築・検証した実践記録。MCP のツール体系と役割分担、実行記録からの原因特定方法、MCP 経由で画面操作と異なる落とし穴を解説。

MCP サーバーで print 文がデバッグ用に残されていると、stdioトランスポートが stdout を JSON-RPC 通信路として使うため、出力がプロトコルを破壊し接続が切断される。単体テストは通るが接続時だけ失敗する理由と、logging への置き換え・print の差し替え・ローカル開発での stdio 以外の起動という 3 つの対策コードを示す。