Claude Code MCP Elicitation実践ガイド — MCPサーバーからの対話的入力要求とHooksによる自動応答パターン

// クライアント → サーバー（初期化時）
{
  "capabilities": {
    "elicitation": {
      "form": {},
      "url": {}
    }
  }
}

// Formモードのリクエスト例
{
  "method": "elicitation/create",
  "params": {
    "message": "デプロイ先の環境を選択してください",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "environment": {
          "type": "string",
          "enum": ["staging", "production"],
          "description": "デプロイ環境"
        }
      },
      "required": ["environment"]
    }
  }
}

// accept時のレスポンス
{
  "action": "accept",
  "content": {
    "environment": "staging"
  }
}

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";

const server = new McpServer({
  name: "feedback-server",
  version: "1.0.0",
});

server.tool(
  "collect-feedback",
  "ユーザーからフィードバックを収集する",
  { projectName: z.string() },
  async ({ projectName }, ctx) => {
    const result = await ctx.mcpReq.elicitInput({
      message: `「${projectName}」へのフィードバックをお願いします`,
      requestedSchema: {
        type: "object",
        properties: {
          rating: {
            type: "string",
            enum: ["great", "good", "neutral", "bad"],
            description: "総合評価",
          },
          comment: {
            type: "string",
            description: "コメント（任意）",
          },
        },
        required: ["rating"],
      },
    });

    if (result.action === "accept") {
      // result.content に { rating, comment } が入る
      return {
        content: [
          { type: "text", text: `フィードバック受領: ${result.content.rating}` },
        ],
      };
    }

    return {
      content: [
        { type: "text", text: "フィードバックがキャンセルされました" },
      ],
    };
  }
);

server.tool("authenticate", "OAuthで認証する", {}, async (_args, ctx) => {
  const result = await ctx.mcpReq.elicitInput({
    message: "GitHubアカウントで認証してください",
    url: "https://your-server.example.com/oauth/start?session=abc123",
  });

  if (result.action !== "accept") {
    return { content: [{ type: "text", text: "認証がキャンセルされました" }] };
  }

  // URLモード完了後、セッションから認証情報を取得して処理を継続
  const token = await fetchTokenFromSession("abc123");
  return { content: [{ type: "text", text: "認証成功" }] };
});

server.tool(
  "deploy",
  "アプリをデプロイする",
  { app: z.string(), env: z.string().optional() },
  async ({ app, env }, ctx) => {
    if (!env) {
      const result = await ctx.mcpReq.elicitInput({
        message: `${app} のデプロイ先を指定してください`,
        requestedSchema: {
          type: "object",
          properties: {
            env: { type: "string", enum: ["staging", "production"] },
          },
          required: ["env"],
        },
      });
      if (result.action !== "accept") {
        return { content: [{ type: "text", text: "デプロイを中止しました" }] };
      }
      env = result.content.env;
    }
    // デプロイ処理を継続
  }
);

server.tool(
  "drop-table",
  "テーブルを削除する",
  { table: z.string() },
  async ({ table }, ctx) => {
    const result = await ctx.mcpReq.elicitInput({
      message: `テーブル「${table}」を削除します。この操作は取り消せません。`,
      requestedSchema: {
        type: "object",
        properties: {
          confirm: {
            type: "boolean",
            description: "本当に削除しますか？",
          },
        },
        required: ["confirm"],
      },
    });

    if (result.action !== "accept" || !result.content.confirm) {
      return { content: [{ type: "text", text: "削除を中止しました" }] };
    }

    await db.run(`DROP TABLE ${table}`);
    return { content: [{ type: "text", text: `${table} を削除しました` }] };
  }
);

// ~/.claude/settings.json
{
  "hooks": {
    "Elicitation": [
      {
        "matcher": "my-trusted-server",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/auto-respond.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# auto-respond.sh — Elicitation Hookの自動応答スクリプト

# stdinからHook入力を読み取る
INPUT=$(cat)

SERVER_NAME=$(echo "$INPUT" | jq -r '.mcp_server_name')
MESSAGE=$(echo "$INPUT" | jq -r '.message')
MODE=$(echo "$INPUT" | jq -r '.mode')

# URLモードのURLは自動で開かない（セキュリティ対策）
if [ "$MODE" = "url" ]; then
  echo "URL elicitation blocked in CI" >&2
  exit 2
fi

# 信頼サーバーのFormモードのみ自動応答
if [ "$SERVER_NAME" = "my-deploy-server" ]; then
  # 環境変数から値を読み取って応答を構築
  cat <<EOF
{
  "hookSpecificOutput": {
    "action": "accept",
    "content": {
      "environment": "${DEPLOY_ENV:-staging}",
      "api_key": "${API_KEY}"
    }
  }
}
EOF
  exit 0
fi

# 未知のサーバーからのElicitationは拒否
exit 2