veyra-forms

AIエージェント向けのフォームおよびアンケート作成用MCPツールです。型指定されたフィールドを持つフォームを定義し、構造化された回答を収集し、結果をクエリできます。読み取りは常に無料です。書き込み操作にはVeyraのコミットモード認証が必要です。

概要

veyra-formsを使用すると、AIエージェントはプログラムでフォームを作成し、回答を送信し、結果を読み取ることができます。これらはすべてSQLiteによってバックアップされます。フォームの作成と回答の送信はクラスBの操作です。

インストール

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エージェント向けのコミットモード認証レイヤーです。エージェントが書き込みを試みるとき：

エージェントがveyra_tokenなしでツールを呼び出す → authorize_endpointを含むVeyraCommitRequiredを受け取ります。
エージェント/ユーザーが認証エンドポイントを呼び出してトークンを取得します。
エージェントがveyra_tokenを設定して再試行します。
veyra-formsはアクションを実行する前に@veyrahq/sdk-nodeを介してトークンを検証します。

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

ライセンス

MIT

veyra-forms

veyra-forms

概要

インストール

MCP設定 (Claude Desktop)

ツール

フィールドタイプ

例

読み取り (トークン不要)

書き込み (Veyraトークンが必要)

トークンが不足している場合のエラーレスポンス

Veyraの仕組み

ライセンス

Resources

Latest Blog Posts

MCP directory API