自作 Web アプリに MCP を生やして Claude Code から書き込む|状態を持つ MCP サーバーの作り方
前作の MCP は計算を返すだけだった。今回は DB を持ち、人間がブラウザで同時に見ている台帳に AI が書き込む。author を環境変数で固定し、権限を DB で持ち、失敗を AI に届く形で返す。Claude Code に頼んだ項目が青いバッジ付きでかんばんに現れるまで。
前作の MCP は計算を返すだけだった。今回は DB を持ち、人間がブラウザで同時に見ている台帳に AI が書き込む。author を環境変数で固定し、権限を DB で持ち、失敗を AI に届く形で返す。Claude Code に頼んだ項目が青いバッジ付きでかんばんに現れるまで。
MCP サーバは、関数に飾りを付けて起動するだけで作れる。電子工作の計算3つを題材に、最小構成から Claude Code への登録まで一本道で通す。docstring がそのまま AI への説明書になること、エラーの文言がモデルに届く条件まで。
ESP-IDF 6.0 の idf.py に内蔵された MCP サーバを Claude Code から使う。ターゲット設定・ビルド・書き込みの公開ツール、接続設定、リモートのドキュメント MCP サーバ、実際に詰まった点までを公式手順にもとづき図解で整理した。