Railhook について
RailhookのMCPサーバーは、AIエージェントによるWebhookイベントの送信や、プロジェクトのエンドポイント、サブスクリプション、配信の再試行を扱います。このパッケージはリモートサーバーに直接接続できないMCPクライアント向けのstdioブリッジです。
主な機能
- 01Webhookイベントの送信
- 02エンドポイントの一覧・作成
- 03サブスクリプションの一覧・作成
- 04配信の確認と再実行
- 05読み取り専用APIキー対応
活用シーン
- 01AIエージェントからのイベント送信
- 02プロジェクトのWebhookエンドポイント設定
- 03失敗した配信の確認と再試行
MCP 対応
このパッケージはstdioのMCPクライアントをRailhookのリモートMCPサーバーにつなぎ、ツール一覧と呼び出しを転送します。リモートMCPサーバーに対応するクライアントは `https://railhook.io/mcp` に直接接続できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://railhook.io/mcpclaude mcp add --transport http vadymkykalo-railhook https://railhook.io/mcp{"mcpServers":{"vadymkykalo-railhook":{"type":"http","url":"https://railhook.io/mcp"}}}Cursor で開く{"servers":{"vadymkykalo-railhook":{"type":"http","url":"https://railhook.io/mcp"}}}VS Code で開く{"mcpServers":{"vadymkykalo-railhook":{"type":"http","url":"https://railhook.io/mcp"}}}{"mcpServers":{"vadymkykalo-railhook":{"serverUrl":"https://railhook.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
@railhook/mcp
Claude Desktop など、ローカルプロセスのみを起動するクライアント向けの、Railhook の MCP サーバーへの stdio ブリッジです。
リモートサーバーに対応しているクライアント(Claude Code、Cursor)は、https://railhook.io/mcp に接続してください。セルフホストの場合は <your origin>/mcp に接続し、このパッケージは使用しないでください。このブリッジは tools/list と tools/call をそのまま中継し、独自のツールはありません。
使用方法
Node.js 18 以降が必要です。
{
"mcpServers": {
"railhook": {
"command": "npx",
"args": ["-y", "@railhook/mcp"],
"env": {
"RAILHOOK_API_KEY": "your-project-api-key"
}
}
}
}
| 変数 | 必須 | 意味 |
|---|---|---|
RAILHOOK_API_KEY | はい | プロジェクト API キーです。READ_ONLY キーでは読み取りツールを使用できますが、すべての書き込みが拒否されます。 |
RAILHOOK_BASE_URL | いいえ | デフォルトは https://railhook.io です。セルフホストの場合は、オリジンを設定してください。 |
キーは Authorization: Bearer <key> として送信され、ログに記録されることはありません。
ツール:send_event、list_endpoints、create_endpoint、list_subscriptions、create_subscription、list_deliveries、get_delivery、replay_delivery。各ツールは、キーが属するプロジェクトを対象に動作します。
詳細ガイド:https://railhook.io/docs/tools/mcp/
開発
npm ci
npm test
npm run build
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。