
Architecture9分
WebアプリをAIから操作できるようにした話(第1回)— MCPサーバー化の動機とアーキテクチャ
チームのタスク管理WebアプリをMCPサーバーとして公開し、Claude Codeから自然言語でタスクを操作できるようにした取り組みを4回に分けて解説します。第1回は動機とアーキテクチャ全体像です。
MCPNext.jsTypeScriptAWSClaude
4件の記事

チームのタスク管理WebアプリをMCPサーバーとして公開し、Claude Codeから自然言語でタスクを操作できるようにした取り組みを4回に分けて解説します。第1回は動機とアーキテクチャ全体像です。

Next.js App RouterのAPI RouteとしてMCP Streamable HTTPサーバーを実装します。JSON-RPC 2.0のハンドラー、バッチリクエスト対応、Lambda特有のGET/SSEハンドシェイク処理まで解説します。

MCPサーバーの認証設計を解説します。SHA-256ハッシュでトークンをDynamoDBに保存するデュアルレコードパターン、チームメンバーシップによる認可、設定画面でのトークン管理UIまで。

MCPサーバーの実装が完成したのに Claude Code から繋がらない。そこには2つの落とし穴がありました。①GETエンドポイント未実装で接続失敗、②settings.jsonのmcpServersは無視されるという問題の原因と解決法を解説します。