English Français العربية

Novence

السجل الرسمي السحابة وDevOps

Hosted MCP for creating, checking, deploying, and hosting static sites for AI agents.

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

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http novence 'https://api.novence.ai/mcp' --header 'Authorization: <Optional to start. Call bootstrap(email) for an nv_ key, then Bearer nv_… for authenticated tools (checkout / mpp_upgrade need verified email).>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "novence": {
            "type": "http",
            "url": "https://api.novence.ai/mcp",
            "headers": {
                "Authorization": "<Optional to start. Call bootstrap(email) for an nv_ key, then Bearer nv_… for authenticated tools (checkout / mpp_upgrade need verified email).>"
            }
        }
    }
}

التوثيق

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

المحتويات
  1. Novence MCP
  2. Install (Claude Code)
  3. Cursor / shell
  4. Generic MCP clients
  5. Tools
  6. Official registry
  7. License

Novence MCP

Hosted Model Context Protocol server for Novence — static site hosting for AI agents.

Your agent can build the site. Then in seconds, give it somewhere to ship.

20 seconds · Claude Code, Cursor, Codex, or any other agent · plugin to a live URL

  • Endpoint: https://api.novence.ai/mcp (streamable HTTP)
  • Auth: optional to start. Call bootstrap(email); the session adopts the nv_ key. Then Authorization: Bearer nv_… for later sessions.
  • Docs: novence.ai/mcp
  • Privacy: novence.ai/privacy

This repository is the Claude Code plugin / install package (Novence-ai/mcp). The MCP server itself is hosted; there is nothing to run locally.

The Dockerfile and catalog/ stdio adapter are only for MCP directories (Glama). They answer tools/list with public tool schemas. They do not contain the hosting API. End users should use https://api.novence.ai/mcp.

Root .mcp.json (and mcp.json for Cursor / Agent Plugins) is Cursor-safe: URL only, no Claude ${user_config.*} placeholders. After bootstrap, Cursor / shell clients persist auth with env NOVENCE_API_KEY and a Bearer header. The Claude Code plugin keeps Keychain / userConfig.api_key via .claude-plugin/plugin.json inline mcpServers.

Skill for registries: skills/novence-deploy (gh skill install Novence-ai/mcp novence-deploy when available).

Install (Claude Code)

claude plugin marketplace add Novence-ai/mcp
# or: enable from the Claude plugin directory after listing is approved

Leave Novence API key blank. Call bootstrap(email) (MCP). After the live URL, paste the nv_ key in plugin settings (Keychain) and run /reload-plugins so later sessions stay authenticated.

Claude stores the key via plugin userConfig. Empty interpolation is treated as unauthenticated (Bearer / uninterpolated ${user_config.api_key}), so bootstrap works before you fill the field.

Cursor / shell

Root .mcp.json matches this URL-only shape (no auth header). Connect with no header, then bootstrap:

{
  "mcpServers": {
    "novence": {
      "url": "https://api.novence.ai/mcp"
    }
  }
}

After bootstrap, persist the key:

export NOVENCE_API_KEY='nv_…'
{
  "mcpServers": {
    "novence": {
      "url": "https://api.novence.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NOVENCE_API_KEY}"
      }
    }
  }
}

One-click install (no key): Add to Cursor

Generic MCP clients

Same as Cursor: URL only first, then add Authorization: Bearer nv_… after bootstrap.

REST fallback if you are not on MCP:

# Deploy first (no email): curl -sS -X POST https://api.novence.ai/v1/demo
curl -sS -X POST https://api.novence.ai/v1/bootstrap \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'

Verify the emailed OTP after the live URL to unlock full Free quotas.

Tools

ToolDescription
bootstrap / verify_email / resend_verification / reissue_keySignup without a prior nv_ key; OTP after live URL
create_project / list_projects / get_project / update_project_settingsProject lifecycle (share_gate_emails OTP on *.novence.ai only; site_mcp visitor MCP on Pro/Scale; data_edit_emails + data_edit_names owner /edit on Pro/Scale)
get_upload_url / get_upload_urls_batch / confirm_upload / confirm_uploads_batchUpload site files
list_files / get_file / delete_fileManage project files
set_redirectsStage /_redirects (SPA: /* /index.html 200); call deploy to apply
put_site_dataLive /data/{name}.json without a deploy (Pro/Scale)
get_site_brief / put_site_brief / list_site_eventsPrivate webmaster brief + inbox (Pro/Scale). Session start: get then list.
deploy / get_deployment_status / get_preview_url / rollbackPublish, poll, preview aliases (Pro/Scale), rollback last 5
publish_htmlOne HTML document → index.html + deploy (omit project_id to create)
run_checks / get_checks_resultsQuality checks (Lighthouse, a11y, links)
configure_custom_domain / get_domain_statusCustom domains (CNAME www → fallback.novence.ai; apex ALIAS or URL-redirect)
create_form / list_forms / update_form / list_form_submissions / delete_form_submissionForms
checkout / mpp_upgrade / billing_portalPaid plans (verified email; after 2nd project or a 402)
get_quotas_and_usage / get_project_usage / update_project_settings (analytics_enabled) / get_project_analytics / get_accountQuotas, usage, and opt-in site traffic
create_account_session / get_account_console_kitBilling/account console kit (never embed nv_ in HTML)

Official registry

Published as ai.novence/mcp on registry.modelcontextprotocol.io.

License

MIT — see LICENSE.

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

ما هو Novence؟

Hosted MCP for creating, checking, deploying, and hosting static sites for AI agents.

كيف أثبّت Novence؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http novence 'https://api.novence.ai/mcp' --header 'Authorization: <Optional to start. Call bootstrap(email) for an nv_ key, then Bearer nv_… for authenticated tools (checkout / mpp_upgrade need verified email).>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

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

من يصون Novence؟

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

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