veyra-webhooks

Ein Webhook-Relay-MCP-Tool für KI-Agenten. Registrieren Sie Ziel-URLs, senden Sie Payloads via HTTP und durchsuchen Sie den Sendeverlauf. Lesezugriffe sind immer kostenlos. Schreibvorgänge erfordern eine Autorisierung im Veyra-Commit-Modus.

Übersicht

veyra-webhooks ermöglicht es KI-Agenten, über registrierte Webhook-Endpunkte mit externen Diensten zu interagieren. Der Verlauf wird zur Überprüfung in SQLite gespeichert. Das Senden von Payloads und die Verwaltung von Registrierungen erfordern den Veyra-Commit-Modus.

Installation

npm install
npm run build

Die Daten werden unter ~/.veyra-webhooks/data.db gespeichert und beim ersten Start automatisch erstellt.

MCP-Konfiguration (Claude Desktop)

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

Tools

Beispiele

Lesen (kein Token erforderlich)

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

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

Schreiben (Veyra-Token erforderlich)

// 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_..."
  }
}

Fehlerantwort bei fehlendem Token

{
  "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"
}

Funktionsweise von Veyra

Veyra ist eine Autorisierungsebene für den Commit-Modus für KI-Agenten. Wenn ein Agent einen Schreibvorgang versucht:

1. Der Agent ruft das Tool ohne veyra_token auf → erhält VeyraCommitRequired mit authorize_endpoint.

2. Der Agent/Benutzer ruft den Autorisierungs-Endpunkt auf, um ein Token zu erhalten.

3. Der Agent versucht es erneut mit gesetztem veyra_token.

4. veyra-webhooks verifiziert das Token über @veyrahq/sdk-node, bevor die Aktion ausgeführt wird.

Siehe veyra.to für die vollständige Dokumentation.

Lizenz

MIT