Skip to main content
Glama
veyra-webhooks

veyra-webhooks

by Aquariosan

veyra-webhooks

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

概要

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

Related MCP server: agent-webhook

インストール

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エージェントのためのコミットモード認証レイヤーです。エージェントが書き込みを試みると、以下のプロセスが発生します:

  1. エージェントが veyra_token なしでツールを呼び出す → authorize_endpoint を含む VeyraCommitRequired を受け取る。

  2. エージェント/ユーザーが認証エンドポイントを呼び出し、トークンを取得する。

  3. エージェントが veyra_token を設定して再試行する。

  4. veyra-webhooks がアクションを実行する前に @veyrahq/sdk-node を介してトークンを検証する。

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

ライセンス

MIT

ホスト型パック (推奨)

1つのURLで統合できるホスト型パックを推奨します:

{
  "mcpServers": {
    "veyra": {
      "url": "https://mcp.veyra.to/sse"
    }
  }
}

1つのURL。48個のツール。24個の無料読み取り。24個の保護された書き込み。

ホスト型パック: https://mcp.veyra.to/sse

パックマニフェスト: https://mcp.veyra.to/.well-known/veyra-pack.json

すべてのVeyraツールファミリー全体で最も迅速なMCP統合パスが必要な場合は、ホスト型パックを使用してください。 このツール単体が必要な場合は、このスタンドアロンパッケージを使用してください。

Veyraエコシステムの一部

Veyraは、本番環境のAIエージェントアクションのためのコミットモードです。 すべてのツール:読み取りは無料、書き込みにはVeyraコミットモードが必要です。

ツール

説明

インストール

veyra-memory

キーバリューストア

npm i -g veyra-memory

veyra-notes

タグ付きメモ作成

npm i -g veyra-notes

veyra-tasks

タスク管理

npm i -g veyra-tasks

veyra-snippets

コードスニペット保存

npm i -g veyra-snippets

veyra-bookmarks

ブックマーク管理

npm i -g veyra-bookmarks

veyra-contacts

連絡先管理

npm i -g veyra-contacts

veyra-forms

フォームビルダー

npm i -g veyra-forms

SDK: npm install @veyrahq/sdk-node ウェブサイト: veyra.to

Related MCP Connectors

Related MCP Servers