FormVault

السجل الرسمي الذكاء الاصطناعي والوكلاء

Create and manage GDPR-compliant, EU-hosted forms from any MCP-compatible AI assistant.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http formvault 'https://api.formvault.eu/mcp' --header 'Authorization: <Bearer token: "Bearer fv_..." with an API key from https://formvault.eu/app/api-keys>'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "formvault": {
            "type": "http",
            "url": "https://api.formvault.eu/mcp",
            "headers": {
                "Authorization": "<Bearer token: \"Bearer fv_...\" with an API key from https://formvault.eu/app/api-keys>"
            }
        }
    }
}
NPM package @formvault/mcp
Claude Code
claude mcp add formvault -e 'FORMVAULT_API_KEY=<your formvault_api_key>' -- npx -y @formvault/mcp@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "formvault": {
            "command": "npx",
            "args": [
                "-y",
                "@formvault/mcp@0.1.2"
            ],
            "env": {
                "FORMVAULT_API_KEY": "<your formvault_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • FORMVAULT_API_KEY إلزامي سري FormVault API key (fv_...), created at https://formvault.eu/app/api-keys

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. FormVault MCP server
  2. Prerequisites
  3. Setup (hosted — recommended)
  4. Setup (npx / stdio)
  5. Self-hosting / local development
  6. Tools
  7. About respondent data
  8. Links
  9. Support
  10. License

FormVault MCP server

Create and manage GDPR-compliant, EU-hosted forms from any MCP-compatible AI assistant.

This is an MCP server for FormVault, a form builder hosted in Germany. Point Claude, ChatGPT, Cursor, Copilot or any MCP-compatible assistant at your FormVault account and build forms by describing them.

Prerequisites

A FormVault account and an API key. Create the key at formvault.eu/app/api-keys.

Add the hosted server to your assistant's MCP configuration — no install, no local process:

{
  "mcpServers": {
    "formvault": {
      "url": "https://api.formvault.eu/mcp",
      "headers": {
        "Authorization": "Bearer fv_your_key_here"
      }
    }
  }
}

Claude Desktop's support for remote/header-based MCP servers depends on your version — check its current docs if the above doesn't show up as an option.

No tool takes a tenant id. The API key carries its own, so it cannot read or write another organisation's forms — and a form id it may not touch reports as not found rather than forbidden, so a key cannot be used to discover what exists. The server itself holds no standing credentials of its own; every request is scoped to whichever key you send. Revoke a key at any time from the API keys page.

Setup (npx / stdio)

For clients that don't yet support a remote/header-based server:

{
  "mcpServers": {
    "formvault": {
      "command": "npx",
      "args": ["-y", "@formvault/mcp"],
      "env": {
        "FORMVAULT_API_KEY": "fv_your_key_here"
      }
    }
  }
}

Restart your assistant and ask for what you need, for example:

  • "Build me a client intake form with a GDPR consent checkbox."
  • "List my forms and tell me which have no fields yet."
  • "Delete the test form I made earlier."
VariableRequiredDefault
FORMVAULT_API_KEYyes—
FORMVAULT_API_URLnohttps://api.formvault.eu

Self-hosting / local development

You can run this package yourself, either as a local stdio server or as your own HTTP deployment. It is a client of the FormVault API, so it still needs a FormVault account and API key:

npm install
npm run build

# stdio (for a local Claude Desktop/Code config using "command"/"args")
FORMVAULT_API_KEY=fv_... node dist/index.js

# HTTP (what the hosted deployment runs)
PORT=3003 FORMVAULT_API_URL=https://api.formvault.eu node dist/httpServer.js

To develop against a local FormVault API, point FORMVAULT_API_URL at it (for example http://localhost:3000).

Tools

ToolWhat it does
list_formsEvery form in your account, with field counts
get_formOne form's full field and settings definition
create_formBuild a form from a description
delete_formRemove a form (irreversible)
list_submissionsDecrypted responses for a form

About respondent data

list_submissions returns your respondents' personal data in the clear. It is described to the model with an instruction not to call it unless you explicitly ask for responses, so ordinary form-building work never pulls it into context.

That is a deliberate boundary, not a limitation. FormVault stores submissions encrypted with AES-256-GCM on servers in Nuremberg, Germany, with a signed DPA on every plan. Whatever you send to your AI provider is your decision — this server's job is to make sure it is a decision rather than a side effect.

Support

Questions and bug reports: open an issue. Pull requests are welcome.

License

MIT

الأسئلة الشائعة

ما هو FormVault؟

Create and manage GDPR-compliant, EU-hosted forms from any MCP-compatible AI assistant.

كيف أثبّت FormVault؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http formvault 'https://api.formvault.eu/mcp' --header 'Authorization: <Bearer token: "Bearer fv_..." with an API key from https://formvault.eu/app/api-keys>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج FormVault إلى مفتاح API؟

نعم. يتطلب FORMVAULT_API_KEY, Authorization، وتضبطها في إعداداته.

هل FormVault مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون FormVault؟

ينشره terjetyl. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.