veyra-webhooks

Инструмент MCP для ретрансляции вебхуков для ИИ-агентов. Регистрируйте целевые URL, отправляйте полезные нагрузки через HTTP и просматривайте историю отправки. Операции чтения всегда бесплатны. Для операций записи требуется авторизация в режиме фиксации Veyra.

Обзор

veyra-webhooks позволяет ИИ-агентам взаимодействовать с внешними сервисами через зарегистрированные конечные точки вебхуков. История сохраняется в SQLite для аудита. Отправка полезных нагрузок и управление регистрациями требуют режима фиксации Veyra.

Related MCP server: mcp-webhook-tools

Установка

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 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 — это уровень авторизации в режиме фиксации для ИИ-агентов. Когда агент пытается выполнить запись:

1. Агент вызывает инструмент без veyra_token → получает VeyraCommitRequired с authorize_endpoint.

2. Агент/пользователь вызывает конечную точку авторизации для получения токена.

3. Агент повторяет попытку с установленным veyra_token.

4. veyra-webhooks проверяет токен через @veyrahq/sdk-node перед выполнением действия.

Полную документацию см. на veyra.to.

Лицензия

MIT

Хостинг-пакет (рекомендуется)

Рекомендуется использовать хостинг-пакет для интеграции по одному URL:

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

Один URL. 48 инструментов. 24 бесплатных чтения. 24 защищенных записи.

Хостинг-пакет: https://mcp.veyra.to/sse

Манифест пакета: https://mcp.veyra.to/.well-known/veyra-pack.json

Используйте хостинг-пакет, если вам нужен самый быстрый путь интеграции MCP для всех семейств инструментов Veyra. Используйте этот автономный пакет, если вам нужен только этот конкретный инструмент.

Часть экосистемы Veyra

Veyra — это режим фиксации для производственных действий ИИ-агентов. Все инструменты: чтение бесплатно, запись требует режима фиксации Veyra.

SDK: npm install @veyrahq/sdk-node Веб-сайт: veyra.to