otterkit について
otterkitは、AIコーディングエージェントにOtterKitのトンネルやWebhookエンドポイントの操作を教えるAgent Skillsです。イベントのキャプチャ、検証、再送に加え、Stripe、GitHub、Shopify、Slackの署名付きイベントを扱います。
主な機能
- 01トンネルとWebhookエンドポイントの管理
- 02Webhook配信のキャプチャ、確認、再送
- 03プロバイダー署名付きの合成イベント送信
- 04署名シークレットによるリクエスト検証
- 05Stripe、GitHub、Shopify、Slackのワークフロー
活用シーン
- 01合成イベントによるローカルWebhookハンドラーのテスト
- 02キャプチャしたWebhook配信の確認と検証
- 03新しい署名でキャプチャ済みイベントを再送
- 04AIコーディングエージェントでOtterKitのワークフローを設定
MCP 対応
`claude mcp add otterkit -- npx otterkit mcp`でOtterKitをMCPサーバーとして追加でき、Skillsと同じ機能を提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
11掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| ttl | string | いいえ | 例:45m、4h、3d 後に自動停止(デフォルト 24h、最長 7d) |
| respond | integer | いいえ | 自動応答の HTTP ステータスコード(デフォルト 200) |
| standby | boolean | いいえ | デーモンが停止または切断してもエンドポイントを稼働状態に保ちます。サーバーが自動応答を返し、リクエストを最大 200 件バッファリングして、再接続時にログへ再生します。切断中も課金されます。 |
| subdomain | string | いいえ | 固定の予約済みサブドメイン(初回使用時にアカウントに割り当て) |
| respondBody | string | いいえ | 自動応答本文(デフォルト {"received":true}) |
詳細
OtterKit エージェントスキル
AI コーディングエージェント(Claude Code、Cursor、Copilot など、Agent Skills 形式を読み取れるもの)に、OtterKit の操作方法を教えるスキルです。キャプチャ、署名検証、再生機能を備えたトンネルとサーバーレスの Webhook エンドポイントを扱います。
| スキル | エージェントが学ぶ内容 |
|---|---|
otterkit | 基本機能:トンネル、Webhook エンドポイント、キャプチャ、検査、再生、デーモン、料金 |
stripe-webhooks | Stripe:署名付き合成イベント、Stripe-Signature の検証、再署名して再生 |
github-webhooks | GitHub Apps:永続的なキャプチャエンドポイント、X-Hub-Signature-256 の検証、再生 |
shopify-webhooks | Shopify:CLI 用の安定した --tunnel-url、HMAC 検証、待機状態のエンドポイント |
slack-webhooks | Slack:キャプチャトンネル経由の Events API、署名シークレットの検証、再署名して再生 |
インストール(Claude Code)
任意のスキルディレクトリを、プロジェクト内の .claude/skills/(すべてのプロジェクトで使う場合は ~/.claude/skills/)にコピーします。
git clone https://github.com/useotterkit/skill && cp -r skill/stripe-webhooks .claude/skills/
または、同じ機能をツールとして公開する OtterKit MCP サーバーを追加します。
claude mcp add otterkit -- npx otterkit mcp
通常のトンネルとの違い
各スキルでは、ngrok クラスのツールにない次の 3 つの機能を活用します。
otterkit send— 実際の署名ヘッダーを付けたプロバイダーイベントの合成イベント(stripe:payment_intent.succeeded、github:pull_request.openedなど)を、ローカルのハンドラーに対して送信します。無料で、プロバイダーアカウントとのやり取りは不要です。otterkit verify— キャプチャした配信を署名シークレットと照合して、リクエストごとに検証し、失敗理由も確認します。otterkit replay --resign— キャプチャしたイベントをローカルコードに再配信し、現在のタイムスタンプで再署名します。これにより、タイムスタンプに許容範囲を設けたハンドラー(Stripe、Slack)でも引き続き受け入れられます。
スキルは CLI の実際の実装を基に生成され、CLI と同時に更新されます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。