English Français العربية

ai.vortexiq/vortex-iq

السجل الرسمي التسويق والمبيعات

Read-only access to your VortexIQ store data: audits, KPIs, alerts, Brand DNA, reports, Ask VIQ.

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

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http vortex-iq 'https://app.vortexiq.ai/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "vortex-iq": {
            "type": "http",
            "url": "https://app.vortexiq.ai/mcp"
        }
    }
}

التوثيق

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

المحتويات
  1. VortexIQ MCP Connector
  2. Connect
  3. What you can ask
  4. Tools (30, all read-only)
  5. Notes & limitations
  6. Support

VortexIQ MCP Connector

Read-only Model Context Protocol connector for VortexIQ — an AI operating system for ecommerce.

Connect it to Claude (or any MCP client) and ask about your store's health, KPIs, alerts, brand voice, SEO drafts and more — in conversation, scoped to your own VortexIQ workspace. Every tool is read-only: the connector cannot create, edit, delete, publish or send anything.

  • Server URL: https://app.vortexiq.ai/mcp
  • Transport: Streamable HTTP (remote MCP server)
  • Auth: per-user OAuth 2.1 (Authorization Code + PKCE, S256)
  • Access: read-only, scoped to the signed-in user's organization

Connect

Claude (web / desktop)
  1. Settings → Connectors → Add custom connector.
  2. Server URL: https://app.vortexiq.ai/mcp
  3. Sign in with your existing VortexIQ (Google) login and click Allow.
  4. The tools appear in Claude. Try "List my recent store audits."

You need a VortexIQ account. Data returned is scoped to your organization and your role's permissions.

Any OAuth client

The full OAuth 2.1 + PKCE flow (registration, authorize, token, refresh) is documented in MCP_OAUTH_LIVE_USAGE.md. Endpoints are machine-discoverable:

GET https://app.vortexiq.ai/.well-known/oauth-authorization-server
GET https://app.vortexiq.ai/.well-known/oauth-protected-resource

What you can ask

PromptTools it uses
"List my recent store audits, then show the findings for integration <id>."store audit runs → report
"What KPIs are available, and show the 30-day KPIs for <integration>."KPI library → integration KPIs
"List my active Nerve Centre alerts and the 24h incident summary."alerts → alert summary
"Show my Brand DNA voice/tone guidelines."brand profile
"Show my Kanban health-fix backlog."kanban board → fix items

Tools (30, all read-only)

Full per-tool reference lives in docs/tools/ — one page per tool with parameters, an example prompt, and what it returns.

AreaTools
Store Auditlist store audit runs · get store audit report · get store audit status
Nerve Centre & KPIslist nerve-centre alerts · get alert summary · list alert activity · get integration KPIs · list KPI library · get nerve integration counts · list nerve-centre profiles · list nerve configurations · list connector catalog · list monitors by type · get dashboard activity feed · list dashboard stores
Brand DNAget brand profile · list brand profiles · list brand ecommerce stores
Ask VIQlist Ask VIQ conversations · get Ask VIQ conversation
Kanban (health-fix)get kanban board · get kanban fix items · get kanban fix status
Reports & Insightslist insights reports · list report profiles · list report schedules
Inventory & Memorylist CloudHub inventory tabs · list Vortex memory files · list Vortex memory reports
Deploymentsget deployment history

Notes & limitations

  • Read-only. No write, delete, publish or send tools exist.
  • Per-user scope. Each call runs as the connecting user against their own organization's data — there is no shared account.
  • Response caps. Some list results are capped (first 50 items / ~40k chars) to stay model-friendly; request a specific id to drill in.

Support

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

ما هو ai.vortexiq/vortex-iq؟

Read-only access to your VortexIQ store data: audits, KPIs, alerts, Brand DNA, reports, Ask VIQ.

كيف أثبّت ai.vortexiq/vortex-iq؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http vortex-iq 'https://app.vortexiq.ai/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ai.vortexiq/vortex-iq إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل ai.vortexiq/vortex-iq مفتوح المصدر؟

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

من يصون ai.vortexiq/vortex-iq؟

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

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