はじめに
こんばんは。
前回、Laravel MCP 1.0を触ってみた記事を書きました。
前回は、名前でユーザーを検索するToolを1つ作って、Claude Codeから呼んでみました。
次はToolを複数用意して、Toolを組み合わせて答えられるかを試してみました。
本題
準備
前回のデモプロジェクトに、検証用の解約日と問い合わせ履歴のデータと、検証用のToolを2つ足します。
Claude Codeで作ります。
このLaravelプロジェクトに、Laravel MCPのToolを追加してください。 準備 - usersテーブルに解約日(cancelled_at, nullable)を追加 - 問い合わせ履歴のinquiriesテーブルとInquiryモデルを追加(user_id, subject, created_at) - Seederでダミーデータを作成。ユーザー30人程度、うち数人は先月(実行日の前月)に解約、 数人はそれ以外の月に解約。問い合わせは1人あたり0〜5件をランダムに Tool(app/Mcp/Tools に作成し、DemoServerの$toolsに登録) - SearchCancelledUsersTool:期間(from, to)を指定して、その間に解約したユーザーを返す - GetUserInquiriesTool:ユーザーIDを1つ指定して、そのユーザーの問い合わせ履歴を返す ルール - 既存のSearchUsersToolを参考に、use文は省略せずに書く - どちらも #[IsReadOnly] と #[Description] を付ける - 特定の質問に直接答えるToolは作らない。汎用的な部品にする
今回は検証用なので「特定の質問に直接答えるToolは作らない」という作りにしています。
マイグレーションとSeederの実行まで、全部やってくれました。データは、ユーザー31人(うち9月の解約5人、それ以外の月の解約5人)、問い合わせ67件です。
できたToolはこの2つです。
SearchCancelledUsersTool:fromとto(YYYY-MM-DD)で、その期間に解約したユーザーを返すGetUserInquiriesTool:user_idを1つ指定して、そのユーザーの問い合わせ履歴を返す
質問してみる
新しいToolを読み込ませるために、Claude Codeを起動し直してから聞きました。
demoのToolだけを使って答えてください。先月解約した人のうち、3回以上問い合わせしていた人は?
「demoのToolだけを使って」を付けているのは、プロジェクトの中で起動しているClaude Codeは、Toolを使わずに自分でSQLを叩いたりSeederを読んだりして答えられてしまうからです。
返ってきた答えはこれです。
demoのツールで調べたところ、先月(2026年9月)に解約した5人のうち、問い合わせが3回以上あったのは 2人 でした。 ┌─────┬────────────────────┬────────────────────────────────┬────────────┬────────────────┐ │ ID │ 名前 │ メール │ 解約日 │ 問い合わせ件数 │ ├─────┼────────────────────┼────────────────────────────────┼────────────┼────────────────┤ │ 24 │ Lisandro Buckridge │ landen.satterfield@example.org │ 2026-09-01 │ 5件 │ ├─────┼────────────────────┼────────────────────────────────┼────────────┼────────────────┤ │ 25 │ Jack Will │ amir.terry@example.net │ 2026-09-05 │ 4件 │ └─────┴────────────────────┴────────────────────────────────┴────────────┴────────────────┘ 問い合わせの内容 - Lisandro Buckridge:ログインできない、メールアドレスを変更したい、料金が高い、請求内容について、領収書の発行依頼(2025年9月〜2026年3月) - Jack Will:不具合の報告、パスワードを再設定したい、請求内容について、メールアドレスを変更したい(2025年11月〜2026年9月) - 最後の問い合わせ(9/2)は解約日(9/5)の3日前です。 条件に当てはまらなかった3人は、Pedro Rohan(1件)、Camila Jakubowski(1件)、Grace Heidenreich(0件)です。 問い合わせ件数は、期間を絞らずに全期間で数えています。「解約前の◯か月以内」のように期間を区切る場合は、その条件で数え直します。
条件に当てはまらなかった3人の件数まで答えているので、解約ユーザーを検索したあと、5人全員分の問い合わせ履歴を1人ずつ取りに行っているのがわかります。
SQLで答え合わせ
本番の管理画面ならこう書く、という1本のSQLで正解を出して、比べてみました。
$ php artisan db sqlite> SELECT u.id, u.name, u.cancelled_at, COUNT(i.id) AS inquiries FROM users u JOIN inquiries i ON i.user_id = u.id WHERE u.cancelled_at >= '2026-09-01' AND u.cancelled_at < '2026-10-01' GROUP BY u.id, u.name, u.cancelled_at HAVING COUNT(i.id) >= 3; 24|Lisandro Buckridge|2026-09-01 21:57:08|5 25|Jack Will|2026-09-05 11:54:26|4
ID 24 が5件、ID 25 が4件で、Claude Codeの答えと一致しました。
AIが自分で判断していたところ
前回のユーザー検索は、条件も絞り込みもTool側のSQLが全部やっていて、AIは結果を伝えるだけでした。
今回は、Toolの外でAIが自分で判断している部分がありました。
- 「先月」を、実行日から2026年9月と解釈して、解約ユーザーを検索していた
- 解約ユーザーの一覧と問い合わせ履歴を、自分で突き合わせて件数を数えていた
- 「件数は全期間で数えた。期間を区切るなら数え直す」と、自分の解釈をはっきり書いてきた
こういうイメージを補完してくれるのはいいところですよね。
終わりに
AIがToolを組み合わせて、正しく答えられることは確認できました。
大体のニュアンスで通じるのはいいですね。
現場からは以上です。