English Français العربية

Formfeed

السجل الرسمي الإنتاجية

Render PDFs and images from templates, validate data and convert Office files to PDF.

الشيفرة المصدرية الموقع التوثيق

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http formfeed 'https://mcp.formfeed.dev/mcp' --header 'Authorization: <Bearer followed by a Formfeed API key (ff_test_… or ff_live_…); without it the client signs in with your Formfeed account (OAuth) and you choose the workspace>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "formfeed": {
            "type": "http",
            "url": "https://mcp.formfeed.dev/mcp",
            "headers": {
                "Authorization": "<Bearer followed by a Formfeed API key (ff_test_… or ff_live_…); without it the client signs in with your Formfeed account (OAuth) and you choose the workspace>"
            }
        }
    }
}
Remote (streamable-http)
Claude Code 
claude mcp add --transport http formfeed 'https://mcp.formfeed.dev/mcp/{workspace_id}'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "formfeed": {
            "type": "http",
            "url": "https://mcp.formfeed.dev/mcp/{workspace_id}"
        }
    }
}
NPM package @formfeed/mcp
Claude Code 
claude mcp add formfeed -e 'FORMFEED_API_KEY=<your formfeed_api_key>' -e 'FORMFEED_REGION=eu' -- npx -y @formfeed/mcp@0.3.20
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "formfeed": {
            "command": "npx",
            "args": [
                "-y",
                "@formfeed/mcp@0.3.20"
            ],
            "env": {
                "FORMFEED_API_KEY": "<your formfeed_api_key>",
                "FORMFEED_REGION": "eu"
            }
        }
    }
}

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

  • FORMFEED_API_KEY سري Formfeed API key: ff_test_… renders for free (with a test mark on the Free plan), ff_live_… consumes units. Without one, only validate_template with html and check_invoice work
  • FORMFEED_REGION API region of the workspace

التوثيق

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

Formfeed packages

Client libraries, command line tools and integrations for Formfeed, the API for generating PDFs and images from templates. Documentation lives at docs.formfeed.dev.

PackageRegistryWhat it is
@formfeed/sdknpmTypeScript client: renders, batches, templates, webhooks. No dependencies, Web APIs only
formfeedPyPIPython client, sync and async
formfeednpmCLI: templates as files, offline preview and validation, renders through the API
@formfeed/enginenpmThe template engine (Jinja2, Liquid, Handlebars) the API and the editor use
@formfeed/devkitnpmTemplate folders, project config and local rendering
@formfeed/testingnpmVitest and Jest matchers for templates
@formfeed/mcpnpmModel Context Protocol server for AI agents
n8n-nodes-formfeednpmn8n community node

Every npm package is built and published from this repository by GitHub Actions with provenance, and the Python package with trusted publishing, so each release can be traced to the commit and workflow run it came from.

Development

Node 22 or newer and pnpm (the version in package.json, corepack enable picks it up):

pnpm install
pnpm nx run-many -t lint test --exclude sdk-python   # TypeScript packages
pnpm nx run-many -t bundle smoke                     # build, pack and try every npm package
cd packages/sdk-python && pip install pytest httpx pydantic && python -m pytest -q

This repository is generated from Formfeed's main repository, where the packages are developed together with the API they talk to. See CONTRIBUTING.md for how issues and pull requests are handled.

Licence

MIT, see LICENSE. Bundled third-party code keeps its own licence; the CLI and MCP packages list it in THIRD_PARTY_LICENSES.md.

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

ما هو Formfeed؟

Render PDFs and images from templates, validate data and convert Office files to PDF.

كيف أثبّت Formfeed؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http formfeed 'https://mcp.formfeed.dev/mcp' --header 'Authorization: <Bearer followed by a Formfeed API key (ff_test_… or ff_live_…); without it the client signs in with your Formfeed account (OAuth) and you choose the workspace>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

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

من يصون Formfeed؟

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

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