できることとできないこと

「処理が終わったら知らせたい」。よくある要望ですが、MCP ではできることとできないことがはっきり分かれます。先に線を引いておきます。

進捗を知らせる

ホストが _meta.progressToken を付けて呼んできたとき、そのときだけ進捗を送れます。

実際に届くもの

Claude Code から tools/call が来たときの中身です。

{
  "method": "tools/call",
  "params": {
    "name": "add",
    "arguments": { "a": 2, "b": 3 },
    "_meta": {
      "claudecode/toolUseId": "toolu_018tCHaryTHbnYbduhcYUqZW",
      "progressToken": 2
    }
  },
  "jsonrpc": "2.0",
  "id": 2
}

progressToken: 2 が付いています。これを添えて通知を返します。

送る

server.registerTool(
	'countdown',
	{
		title: '数える',
		description: '指定した秒数を数え、その間に進捗を知らせる',
		inputSchema: { seconds: z.number().int().min(1).max(10).default(3) },
	},
	async ({ seconds }, extra) => {
		const token = extra._meta?.progressToken;

		for (let i = 1; i <= seconds; i++) {
			await sleep(1000);
			if (token === undefined) continue;
			await extra.sendNotification({
				method: 'notifications/progress',
				params: { progressToken: token, progress: i, total: seconds, message: `${i}/${seconds} 秒` },
			});
		}

		return { content: [{ type: 'text', text: `${seconds} 秒数えた` }] };
	},
);

流れる通知です。

{"method":"notifications/progress","params":{"progressToken":"t1","progress":1,"total":2,"message":"1/2 秒"},"jsonrpc":"2.0"}
{"method":"notifications/progress","params":{"progressToken":"t1","progress":2,"total":2,"message":"2/2 秒"},"jsonrpc":"2.0"}

利用者に尋ねる

サーバーからリクエストは送れない、と書きました。ただし例外があります。クライアントが「尋ねられる用意がある」と名乗っている場合です。

相手が名乗っているか確かめる

Claude Code は initialize でこう名乗ってきます。

"capabilities": { "roots": { "listChanged": true }, "elicitation": {} }

elicitation があるので、尋ねられます。

尋ねる

const answer = await extra.sendRequest(
	{
		method: 'elicitation/create',
		params: {
			mode: 'form',
			message: 'お名前を教えてください',
			requestedSchema: {
				type: 'object',
				properties: { name: { type: 'string', title: '名前' } },
				required: ['name'],
			},
		},
	},
	z.object({ action: z.string(), content: z.record(z.string(), z.unknown()).optional() }),
);

if (answer.action !== 'accept') {
	return { content: [{ type: 'text', text: `尋ねたが ${answer.action} だった` }] };
}
return { content: [{ type: 'text', text: `こんにちは、${answer.content?.name} さん` }] };

3 つの返事

実測

対話していない状態（claude -p での実行）で呼ぶと、こう返ります。

elicitation の答え: {"action":"cancel"}

画面に出せる相手がいないので cancel です。断られる前提で書いておく必要があります。

画面に出す（枠の外）

「ビルドが終わったら気づきたい」。この要望に最も確実に応えるのは、MCP の外側です。サーバーは普通のプロセスなので、OS の通知を出せます。

await execFileAsync('powershell', [
	'-NoProfile', '-ExecutionPolicy', 'Bypass',
	'-File', join(HERE, 'toast.ps1'),
	'-Title', title, '-Message', message,
]);

呼ばれる toast.ps1 の中身です。

[void][Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime]

$xml = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent(
	[Windows.UI.Notifications.ToastTemplateType]::ToastText02)

$texts = $xml.GetElementsByTagName('text')
[void]$texts.Item(0).AppendChild($xml.CreateTextNode($Title))
[void]$texts.Item(1).AppendChild($xml.CreateTextNode($Message))

# 送り主として登録済みのアプリ ID が要る。PowerShell のものを借りる
$appId = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\WindowsPowerShell\v1.0\powershell.exe'

$notifier = [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($appId)
$notifier.Show([Windows.UI.Notifications.ToastNotification]::new($xml))

呼ばれていないときは届かない

最後に、はっきり線を引きます。

実際にはこう作る

次の章へ

「長い処理を投げて、後から結果を取る」仕組みが仕様にあります。次の章で作りますが、手元の Claude Code では使われませんでした。その実測も含めて扱います。