veyra-webhooks

AI 에이전트를 위한 웹훅 릴레이 MCP 도구입니다. 대상 URL을 등록하고, HTTP를 통해 페이로드를 전송하며, 전송 기록을 탐색할 수 있습니다. 읽기 작업은 항상 무료입니다. 쓰기 작업에는 Veyra 커밋 모드 인증이 필요합니다.

개요

veyra-webhooks를 사용하면 AI 에이전트가 등록된 웹훅 엔드포인트를 통해 외부 서비스와 상호 작용할 수 있습니다. 기록은 감사를 위해 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