Skip to main content
Glama
veyra-forms
by Aquariosan

veyra-forms

AI 에이전트를 위한 양식 및 설문조사 빌더 MCP 도구입니다. 유형이 지정된 필드로 양식을 정의하고, 구조화된 응답을 수집하며, 결과를 조회할 수 있습니다. 읽기 작업은 항상 무료입니다. 쓰기 작업에는 Veyra 커밋 모드 인증이 필요합니다.

개요

veyra-forms를 사용하면 AI 에이전트가 프로그래밍 방식으로 양식을 생성하고, 응답을 제출하며, 결과를 읽을 수 있습니다. 이 모든 과정은 SQLite를 기반으로 합니다. 양식 생성 및 응답 제출은 Class B 작업입니다.

Related MCP server: veyra-contacts

설치

npm install
npm run build

데이터는 ~/.veyra-forms/data.db에 저장되며, 처음 실행 시 자동으로 생성됩니다.

MCP 구성 (Claude Desktop)

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

도구

도구

입력

클래스

가격

list_forms

{}

—

무료

get_form

{ form_id }

—

무료

get_responses

{ form_id }

—

무료

create_form

{ title, fields: [{name, type, required?}], veyra_token? }

B

€0.02

submit_response

{ form_id, data: {}, veyra_token? }

B

€0.02

delete_form

{ form_id, veyra_token? }

B

€0.02

필드 유형

모든 문자열이 type으로 허용됩니다. 일반적인 값: text, email, number, boolean, date, textarea.

예시

읽기 (토큰 불필요)

// List all forms
{ "tool": "list_forms", "arguments": {} }

// Get a form and its field schema
{ "tool": "get_form", "arguments": { "form_id": "1712345678-abc1234" } }

// Get all responses for a form
{ "tool": "get_responses", "arguments": { "form_id": "1712345678-abc1234" } }

쓰기 (Veyra 토큰 필요)

// Create a form
{
  "tool": "create_form",
  "arguments": {
    "title": "Customer Feedback",
    "fields": [
      { "name": "name", "type": "text", "required": true },
      { "name": "email", "type": "email", "required": true },
      { "name": "rating", "type": "number", "required": true },
      { "name": "comment", "type": "textarea" }
    ],
    "veyra_token": "vt_..."
  }
}

// Submit a response
{
  "tool": "submit_response",
  "arguments": {
    "form_id": "1712345678-abc1234",
    "data": {
      "name": "Alice",
      "email": "alice@example.com",
      "rating": 5,
      "comment": "Excellent service!"
    },
    "veyra_token": "vt_..."
  }
}

// Delete a form (also deletes all responses)
{
  "tool": "delete_form",
  "arguments": { "form_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-forms는 작업을 실행하기 전에 @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

모든 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-webhooks

웹훅 발신자

npm i -g veyra-webhooks

SDK: npm install @veyrahq/sdk-node 웹사이트: veyra.to

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Bookmark manager for AI agents with tags, categories, and full-text search. Reads are free, writes require Veyra commit mode.
      2 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to build and operate production-ready forms, quizzes, surveys, and workflows, including creation, publishing, submission management, and integration with webhooks and analytics.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to create local web forms with unlimited brainstorming questions and retrieve user answers as JSON, including support for file uploads.
      MIT