veyra-webhooks

AIエージェント向けのWebhookリレーMCPツールです。ターゲットURLの登録、HTTP経由でのペイロード送信、送信履歴の閲覧が可能です。読み取りは常に無料です。書き込み操作にはVeyraのコミットモード認証が必要です。

概要

veyra-webhooksを使用すると、AIエージェントは登録されたWebhookエンドポイントを通じて外部サービスとやり取りできます。履歴は監査のためにSQLiteに保存されます。ペイロードの送信および登録の管理には、Veyraコミットモードが必要です。

インストール

npm install
npm run build

データは ~/.veyra-webhooks/data.db に保存され、初回実行時に自動的に作成されます。

MCP設定 (Claude Desktop)

{
  "mcpServers": {
    "veyra-webhooks": {
      "command": "node",
      "args": ["/absolute/path/to/veyra-webhooks/dist/index.js"]
    }
  }
}

ツール

ツール	入力	クラス	価格
`list_webhooks`	`{}`	—	無料
`get_history`	`{ webhook_id, limit? }`	—	無料
`register_webhook`	`{ name, url, headers?, veyra_token? }`	A	€0.005
`send_webhook`	`{ webhook_id, payload, method?, veyra_token? }`	B	€0.02
`delete_webhook`	`{ webhook_id, veyra_token? }`	B	€0.02

例

読み取り (トークン不要)

// List all registered webhooks
{ "tool": "list_webhooks", "arguments": {} }

// View send history
{ "tool": "get_history", "arguments": { "webhook_id": "1712345678-abc1234", "limit": 20 } }

書き込み (Veyraトークンが必要)

// Register a webhook
{
  "tool": "register_webhook",
  "arguments": {
    "name": "Slack Notifications",
    "url": "https://hooks.slack.com/services/...",
    "headers": "{\"Authorization\": \"Bearer token123\"}",
    "veyra_token": "vt_..."
  }
}

// Send a payload (actually fires an HTTP request)
{
  "tool": "send_webhook",
  "arguments": {
    "webhook_id": "1712345678-abc1234",
    "payload": "{\"text\": \"Deployment complete\"}",
    "method": "POST",
    "veyra_token": "vt_..."
  }
}

// Delete a webhook (also clears its history)
{
  "tool": "delete_webhook",
  "arguments": {
    "webhook_id": "1712345678-abc1234",
    "veyra_token": "vt_..."
  }
}

トークンが不足している場合のエラーレスポンス

{
  "error": "VeyraCommitRequired",
  "message": "Write operations require Veyra commit mode.",
  "currentMode": "open",
  "requiredMode": "commit",
  "authorize_endpoint": "https://api.veyra.to/v1/authorize-action",
  "docs_url": "https://veyra.to"
}

Veyraの仕組み

Veyraは、AIエージェント向けのコミットモード認証レイヤーです。エージェントが書き込みを試みるとき：

エージェントが veyra_token なしでツールを呼び出す → authorize_endpoint を含む VeyraCommitRequired を受け取ります。
エージェント/ユーザーが認証エンドポイントを呼び出し、トークンを取得します。
エージェントが veyra_token を設定して再試行します。
veyra-webhooks はアクションを実行する前に @veyrahq/sdk-node を介してトークンを検証します。

詳細なドキュメントについては veyra.to を参照してください。

ライセンス

MIT

veyra-webhooks

veyra-webhooks

概要

インストール

MCP設定 (Claude Desktop)

ツール

例

読み取り (トークン不要)

書き込み (Veyraトークンが必要)

トークンが不足している場合のエラーレスポンス

Veyraの仕組み

ライセンス

Resources

Latest Blog Posts

MCP directory API