English Français العربية

ai.gency/gency-mcp

السجل الرسمي أدوات المطورين

Gency AI product image generation - MCP server for Claude, Codex, Cursor, VS Code

الشيفرة المصدرية

التثبيت

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

NPM package @gency-ai/gency-mcp
Claude Code 
claude mcp add gency-mcp -e 'GENCY_API_URL=https://openapi.gency.ai' -e 'GENCY_OAUTH_CLIENT_ID=<GENCY_OAUTH_CLIENT_ID>' -e 'GENCY_OAUTH_CLIENT_SECRET=<your gency_oauth_client_secret>' -e 'GENCY_OAUTH_API_BASE=<GENCY_OAUTH_API_BASE>' -e 'GENCY_OAUTH_SCOPE=product:read product:write team:read team:write user:read' -e 'GENCY_MCP_ALLOWED_CLIENT_IDS=<GENCY_MCP_ALLOWED_CLIENT_IDS>' -e 'GENCY_MCP_UPLOAD_SECRET=<your gency_mcp_upload_secret>' -e 'GENCY_MCP_OAUTH_RESOURCE=<GENCY_MCP_OAUTH_RESOURCE>' -- npx -y @gency-ai/gency-mcp@0.7.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "gency-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@gency-ai/gency-mcp@0.7.0"
            ],
            "env": {
                "GENCY_API_URL": "https://openapi.gency.ai",
                "GENCY_OAUTH_CLIENT_ID": "<GENCY_OAUTH_CLIENT_ID>",
                "GENCY_OAUTH_CLIENT_SECRET": "<your gency_oauth_client_secret>",
                "GENCY_OAUTH_API_BASE": "<GENCY_OAUTH_API_BASE>",
                "GENCY_OAUTH_SCOPE": "product:read product:write team:read team:write user:read",
                "GENCY_MCP_ALLOWED_CLIENT_IDS": "<GENCY_MCP_ALLOWED_CLIENT_IDS>",
                "GENCY_MCP_UPLOAD_SECRET": "<your gency_mcp_upload_secret>",
                "GENCY_MCP_OAUTH_RESOURCE": "<GENCY_MCP_OAUTH_RESOURCE>"
            }
        }
    }
}

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

  • GENCY_API_URL Gency API base URL
  • GENCY_OAUTH_CLIENT_ID OAuth client ID override. Defaults to the built-in official client, so most users never set this.
  • GENCY_OAUTH_CLIENT_SECRET سري OAuth client secret, only needed for confidential clients.
  • GENCY_OAUTH_API_BASE OAuth provider base URL. Defaults to GENCY_API_URL.
  • GENCY_OAUTH_SCOPE Space-separated OAuth scopes.
  • GENCY_MCP_ALLOWED_CLIENT_IDS serve-http only: OAuth client IDs whose tokens this server accepts (space or comma separated). Empty accepts any client.
  • GENCY_MCP_UPLOAD_SECRET سري serve-http only: HMAC key for signed upload handles. Only needed when running more than one instance, so a handle issued by one verifies on another.
  • GENCY_MCP_OAUTH_RESOURCE RFC 8707 resource indicator to send on authorize/token/refresh requests. Opt-in until the Gency authorization server is confirmed to accept it.

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

ما هو ai.gency/gency-mcp؟

Gency AI product image generation - MCP server for Claude, Codex, Cursor, VS Code

كيف أثبّت ai.gency/gency-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add gency-mcp -e 'GENCY_API_URL=https://openapi.gency.ai' -e 'GENCY_OAUTH_CLIENT_ID=<GENCY_OAUTH_CLIENT_ID>' -e 'GENCY_OAUTH_CLIENT_SECRET=<your gency_oauth_client_secret>' -e 'GENCY_OAUTH_API_BASE=<GENCY_OAUTH_API_BASE>' -e 'GENCY_OAUTH_SCOPE=product:read product:write team:read team:write user:read' -e 'GENCY_MCP_ALLOWED_CLIENT_IDS=<GENCY_MCP_ALLOWED_CLIENT_IDS>' -e 'GENCY_MCP_UPLOAD_SECRET=<your gency_mcp_upload_secret>' -e 'GENCY_MCP_OAUTH_RESOURCE=<GENCY_MCP_OAUTH_RESOURCE>' -- npx -y @gency-ai/gency-mcp@0.7.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ai.gency/gency-mcp إلى مفتاح API؟

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

هل ai.gency/gency-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون ai.gency/gency-mcp؟

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

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