Claude Code MCP Elicitation実践ガイド — MCPサーバーからユーザー入力を要求する双方向ワークフローの構築

// formモード: サーバー→クライアントへのリクエスト
{
  "method": "elicitation/create",
  "params": {
    "message": "デプロイ先の環境を選択してください",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "environment": {
          "type": "string",
          "enum": ["staging", "production"],
          "description": "デプロイ環境"
        },
        "confirm": {
          "type": "boolean",
          "description": "本当にデプロイしますか？"
        }
      },
      "required": ["environment", "confirm"]
    }
  }
}

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

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

server.tool(
  "deploy",
  { service: { type: "string", description: "デプロイ対象サービス" } },
  async ({ service }, { server: mcpServer }) => {
    // Elicitationでユーザーに承認を求める
    const result = await mcpServer.elicitInput({
      message: `${service} をデプロイします。環境を選択してください。`,
      requestedSchema: {
        type: "object",
        properties: {
          environment: {
            type: "string",
            enum: ["staging", "production"],
            description: "デプロイ先環境",
          },
          skip_tests: {
            type: "boolean",
            description: "テストをスキップする",
          },
        },
        required: ["environment"],
      },
    });

    // accept / decline / cancel の3パターンを必ずハンドリング
    if (result.action === "decline") {
      return {
        content: [{ type: "text", text: "デプロイがユーザーにより拒否されました。" }],
      };
    }

    if (result.action === "cancel") {
      return {
        content: [{ type: "text", text: "デプロイがキャンセルされました。再度実行してください。" }],
      };
    }

    // accept: 入力値を使って処理続行
    const env = result.content?.environment as string;
    const skipTests = (result.content?.skip_tests as boolean) ?? false;

    // 実際のデプロイ処理...
    return {
      content: [{
        type: "text",
        text: `${service} を ${env} にデプロイしました（テストスキップ: ${skipTests}）`,
      }],
    };
  }
);

const transport = new StdioServerTransport();
await server.connect(transport);

// .claude/settings.json
{
  "hooks": {
    "Elicitation": [
      {
        "matcher": "",
        "hooks": [{
          "type": "command",
          "command": "node /path/to/elicitation-gate.mjs"
        }]
      }
    ]
  }
}

// elicitation-gate.mjs
import { readFileSync } from "fs";

const input = JSON.parse(readFileSync("/dev/stdin", "utf-8"));

// 信頼済みMCPサーバーリスト
const TRUSTED_SERVERS = ["deploy-gate", "config-manager"];

if (TRUSTED_SERVERS.includes(input.mcp_server_name)) {
  // 自動承認: デフォルト値で応答
  const content = {};
  for (const field of input.form_fields) {
    if (field.type === "boolean") content[field.name] = true;
  }
  console.log(JSON.stringify({
    hookSpecificOutput: {
      hookEventName: "Elicitation",
      action: "accept",
      content,
    },
  }));
} else {
  // 信頼されていないサーバーはブロック
  process.stderr.write(`Blocked elicitation from: ${input.mcp_server_name}`);
  process.exit(2);
}

{
  "hookSpecificOutput": {
    "hookEventName": "PreToolUse",
    "permissionDecision": "defer"
  }
}

# .github/workflows/deploy.yml
name: Deploy with approval
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Run Claude headless
        id: claude
        run: |
          result=$(claude -p "deploy-gateツールでproductionデプロイを実行して" \
            --headless \
            --permission-mode default \
            --output-format json)
          echo "result=$result" >> "$GITHUB_OUTPUT"

      - name: Check for deferred tool
        id: check
        run: |
          stop_reason=$(echo '${{ steps.claude.outputs.result }}' | jq -r '.stop_reason')
          session_id=$(echo '${{ steps.claude.outputs.result }}' | jq -r '.session_id')
          echo "stop_reason=$stop_reason" >> "$GITHUB_OUTPUT"
          echo "session_id=$session_id" >> "$GITHUB_OUTPUT"

      - name: Wait for Slack approval
        if: steps.check.outputs.stop_reason == 'tool_deferred'
        run: |
          # Slack承認ボタン送信 → Webhook待受
          # 承認後にresumeを実行
          claude -p --resume ${{ steps.check.outputs.session_id }} \
            --permission-mode default

server.tool("smart-deploy", schema, async (args, { server: mcpServer }) => {
  // クライアントがElicitation対応かチェック
  const capabilities = mcpServer.getClientCapabilities?.();
  
  if (!capabilities?.elicitation) {
    // 非対応: デフォルト値で続行
    return executeDeploy(args.service, "staging", false);
  }

  // 対応: ユーザーに確認
  const result = await mcpServer.elicitInput({ /* ... */ });
  // ...
});