Webhook MCP Server について
Webhook MCP Server は、呼び出し時に設定済みの webhook URL へ通知を送信します。長時間のタスク完了を報告する AI アシスタントのワークフロー向けで、任意のメッセージや外部リンクを含められます。
主な機能
- 01設定した webhook への通知送信
- 02カスタムメッセージの追加
- 03外部リンクの添付
- 04webhook URL による設定
活用シーン
- 01長時間タスクの完了通知
- 02アラートへのタスク固有メッセージの追加
- 03通知から外部ページへのリンク
MCP 対応
MCP クライアントに webhook 通知ツールを提供します。設定した URL に通知を送り、任意でメッセージと外部リンクを含められます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Webhook MCP サーバー
呼び出されると Webhook 通知を送信する Model Context Protocol(MCP)サーバーです。
このサーバーは、Echobell などの Webhook 通知サービスと組み合わせて、時間のかかるタスクが完了したときに通知を受け取るために使用できます。サーバーに Echobell の Webhook URL(または別のサービスの URL)を設定し、タスクのプロンプト内で AI アシスタントに「完了したら通知してください」と指示するだけです。
設定
MCP サーバーを設定する方法はいくつかあります。
Smithery 経由でインストールする
Smithery 経由で、Claude Desktop 用の Webhook MCP Server を自動的にインストールするには、次のようにします。
npx -y @smithery/cli install @noobnooc/webhook-mcp --client claude
Claude、Cursor、Windsurf
設定に以下を追加して、Claude、Cursor、または Windsurf で MCP サーバーを使用するように設定します。
- NPM を使用する場合:
{
"mcpServers": {
"notification": {
"command": "npx",
"args": ["-y", "webhook-mcp"],
"env": {
"WEBHOOK_URL": "your-webhook-url-here"
}
}
}
}
- Docker を使用する場合:
{
"mcpServers": {
"notification": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"WEBHOOK_URL",
"noobnooc/webhook-mcp"
],
"env": {
"WEBHOOK_URL": "<your-webhook-url-here>"
}
}
}
}
VS Code
以下の設定を VS Code の settings.json に追加します。
- NPM を使用する場合:
{
"mcp": {
"servers": {
"notification": {
"command": "npx",
"args": ["-y", "webhook-mcp"],
"env": {
"WEBHOOK_URL": "your-webhook-url-here"
}
}
}
}
}
- Docker を使用する場合:
{
"mcp": {
"servers": {
"notification": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"WEBHOOK_URL",
"noobnooc/webhook-mcp"
],
"env": {
"WEBHOOK_URL": "<your-webhook-url-here>"
}
}
}
}
}
環境変数
WEBHOOK_URL(必須):Webhook 通知の送信先 URL
パラメーター
Webhook は、次のオプションのパラメーターを指定して呼び出すことができます。
message:Webhook ペイロードに含めるカスタムメッセージurl:Webhook ペイロードにexternalLinkとして含める外部 URL
開発
プロジェクトをビルドするには:
npm install
npm run build
デバッグ用に MCP inspector で実行するには:
npm run inspector
公開
パッケージをビルドして公開するには:
npm run publish
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。