Tovanix
Tovanix

الوصول عبر MCP

اربط حساب Tovanix بأي عميل AI يدعم MCP. الواجهة https://tovanix.com/api/mcp/rpc تستخدم Streamable HTTP دون حالة، وتقبل POST فقط.

  • المصادقة: Authorization: Bearer <credential> أوترويسة X-MCP-Key؛ تبدأ بيانات الاعتماد بـmcp_live_ وتُعرض مرة واحدة
  • الأذونات: كل قدرة متوقفة حتى تفعلها؛ تُرجع tools/list القدرات المفعلة فقط، بأسماء تبدأ بـtovanix_ يليها اسم القدرة
  • تتطلب أدوات الإنفاق والإجراءات الدائمة رمز totp_code لمرة واحدة، وتلتزم بحدود كل استدعاء والحدود اليومية
  • قوائم سماح لـIP المصدر وتواريخ انتهاء وحد معدل افتراضي 120 استدعاء في الدقيقة (حتى 600)
  • ثلاثة موارد (دليل القدرات ونظرة الحساب العامة ودليل المنصة) وثلاثة قوالب تعليمات (فحص الحساب وتقرير الإنفاق وفحص الانتهاء)
  • الأخطاء: 401 بيانات اعتماد غير صالحة، و403 المصدر أوحالة الحساب غير مسموحين، و405 الطلب ليس POST، و413 الطلب كبير جدًا
  • يتطلب إنشاء بيانات الاعتماد قراءة اتفاقية الوصول إلى MCP وقبولها؛ أنت مسؤول عن المحتوى والإجراءات المرسلة باسمك
  • إضافةً إلى الإنفاق والإجراءات الدائمة، تتطلب إعدادات مهمة مثل روابط الإشعار والمنشورات العامة ووصول الحاويات العام رمزًا لمرة واحدة؛ تخضع منشورات AI ورسائل الدعم والبريد وقراءة Telegram المباشرة لحدود لكل حساب، وتُرفض المنشورات ورسائل الدعم المتكررة، وتُوسم رسائل الدعم بعبارة "أُرسلت عبر مساعد AI"

POST /api/mcp/rpc

ثلاثة أنواع من بيانات الاعتماد، لكل منها دوره

يتيح MCP (Model Context Protocol) لعملاء الذكاء الاصطناعي مثل Claude استدعاء قدرات حساب Tovanix بوصفها «أدوات». أنشئ في لوحة التحكم بيانات اعتماد MCP لكل عميل وفعّل القدرات المسموح له بها واحدة تلو الأخرى؛ يتصل العميل بنقطة النهاية بهذه البيانات، ثم يمكنه البحث عن المعلومات وإنجاز المهام ضمن المحادثة.

لـ MCP نقطة نهاية وبيانات اعتماد خاصة، مستقلة عن API المفتوح وعن تسجيل الدخول إلى لوحة التحكم: لا يؤثر حذف بيانات اعتماد MCP في تكاملات API المفتوح الحالية، والعكس صحيح.

  • API المفتوح /api/v1/* — مفتاح API (X-API-Key / التوقيع) — البرامج التي تكتبها — وفق إعدادات المفتاح
  • MCP /api/mcp/rpc — بيانات اعتماد MCP (Bearer) — عملاء الذكاء الاصطناعي — لا شيء — تُفعّل واحدة تلو الأخرى
  • لوحة التحكم — جلسة تسجيل الدخول — أنت — كل ما في حسابك

بدء سريع

يمكن لأي عميل MCP يدعم Streamable HTTP ويتيح ضبط ترويسات الطلب الاتصال. اختر أداتك أدناه وانسخ الأمر أو الإعداد المناسب.

يمكنك أيضًا التحقق من بيانات الاعتماد باستدعاء tools/list عبر curl: الخادم عديم الحالة، لذا لا يلزم استدعاء initialize أولًا.

تُحفظ بصمة بيانات الاعتماد فقط، لذا لا يمكن استعادتها — إذا فقدتها، احذفها وأنشئ غيرها. احتفظ بها في إعدادات العميل؛ ولا تضعها في مستودع عام أو لقطة شاشة أو محادثة.

نقطة النهاية والمصادقة

تعرض صفحة «الوصول عبر MCP» في لوحة التحكم نقطة نهاية حسابك جاهزةً للنسخ.

  • نقطة النهاية — تُرسل كل الطلبات إلى هذا الرابط الواحد.
  • النقل — Streamable HTTP عديم الحالة: يُصادَق على كل طلب بشكل مستقل، ويُقبل POST فقط ولا يُصدر Mcp-Session-Id؛ يعيد GET وDELETE الحالة 405.
  • المصادقة — Authorization: Bearer <credential>. إذا كان العميل يتيح إضافة ترويسات مخصصة فقط ولا يتيح تغيير Authorization، فاستخدم X-MCP-Key: <credential> بدلًا منه.
  • إصدارات البروتوكول — 2025-06-18 (الأحدث) و2025-03-26 و2024-11-05، ويُتفاوض عليها وفق الإصدار الذي يرسله العميل في initialize؛ تعود الإصدارات غير المدعومة إلى الأحدث.
  • الرسائل — JSON-RPC 2.0، بحد أقصى 1 MB لمحتوى الطلب. يمكن للطلبات المجمّعة من العملاء الأقدم أن تحتوي على 32 عنصرًا كحد أقصى.
  • طلبات المتصفح — تُرفض الطلبات التي تحمل ترويسة Origin من مواقع غير مواقع المنصة (حماية من إعادة ربط DNS). لا يرسل عملاء سطح المكتب وسطر الأوامر Origin ولا يتأثرون.

بيانات الاعتماد والأذونات

تبدأ بيانات الاعتماد بـ mcp_live_ ويبلغ طولها 73 حرفًا. لكل بيانات اعتماد الإعدادات أدناه، ويمكن تعديلها في لوحة التحكم في أي وقت؛ وتتوقف البيانات المنتهية أو المعطّلة عن العمل فورًا.

قبل إنشاء بيانات اعتماد، يجب قراءة اتفاقية الوصول عبر MCP وقبولها. تحدد مخاطر السماح للذكاء الاصطناعي بإدارة حسابك ومن يتحملها: أنت مسؤول عن العمليات والخسائر عبر MCP. لا يمكن إنشاء بيانات اعتماد ما لم تُنشر اتفاقية؛ وبعد تحديثها تحتاج البيانات الجديدة إلى قبول مجدد، بينما تواصل البيانات القائمة العمل.

عندما يكون الحساب مقيّدًا، يسمح MCP بقدرات القراءة فقط؛ وتُرفض عمليات الكتابة والإنفاق والإجراءات غير القابلة للتراجع مع رسالة توجه المستخدم إلى لوحة التحكم. وإذا جُمّد الحساب، تعيد جميع الطلبات 403.

الأدوات وتسميتها

اسم الأداة = tovanix_ + اسم القدرة، مع استبدال النقاط بشرطات سفلية. مثلًا، تصبح القدرة account.balance.get الأداة tovanix_account_balance_get.

يعيد tools/list القدرات المفعّلة لهذه البيانات فقط. يشرح وصف كل أداة متى تُستخدم ومعاني معاملاتها وما يجب الانتباه إليه، مما يساعد عملاء الذكاء الاصطناعي على اختيار الأدوات.

قراءة: للاطلاع فقط. كتابة: تغييرات قابلة للتراجع مثل تعديل ملاحظة. إنفاق: خصم من رصيدك. غير قابل للتراجع: مثل حذف مفتاح أو إلغاء بطاقة. تتطلب أدوات الإنفاق والإجراءات غير القابلة للتراجع رمزًا لمرة واحدة (انظر القسم التالي). بعض التغييرات القابلة للتراجع التي تحتاج إلى موافقتك المباشرة — كتغيير رابط الإشعار الراجع أو نشر منشور أو إتاحة حاوية للعامة — تتطلب الرمز أيضًا؛ وتُوسم في لوحة التحكم بـ «الرمز مطلوب».

رموز لمرة واحدة

تأخذ أدوات الإنفاق والإجراءات غير القابلة للتراجع معاملًا إضافيًا totp_code، وهو الرمز الحالي المكوّن من 6 أرقام من تطبيق المصادقة لديك. لا يستطيع الذكاء الاصطناعي الحصول عليه وسيطلبه منك عند الحاجة. وينطبق ذلك أيضًا على الأدوات الموسومة بـ «الرمز مطلوب».

  • يعمل كل رمز مرة واحدة فقط. ولا يمكن إعادة استخدام رمز استُخدم للتو في لوحة التحكم عبر MCP أيضًا.
  • إذا لم تكن المصادقة الثنائية مفعّلة للحساب، تُرفض هذه الأدوات دائمًا مع طلب تفعيلها في لوحة التحكم.
  • يُتحقق من الرمز قبل أي شيء آخر، لذا لا يستهلك الرمز الخاطئ شيئًا من حد الإنفاق اليومي.

حدود الإنفاق

يمر كل استدعاء يتطلب إنفاقًا بالخطوات الأربع التالية بالترتيب؛ وإذا أخفقت أي خطوة، فلا تُخصم أموال.

confirmed_total_usd

تتطلب معظم أدوات الإنفاق confirmed_total_usd: الإجمالي الذي عرضه الذكاء الاصطناعي ووافقت عليه. إذا كان السعر وقت التنفيذ أعلى، فلا تُنفذ العملية ويُخبرك الذكاء الاصطناعي بالسعر الجديد.

ما يحدث للحد عند الإخفاق

إذا أخفق الاستدعاء وكان مؤكدًا أنه لم تُخصم رسوم، يُعاد المبلغ المحجوز إلى الحد المتاح. وإذا تعذّر التأكد من نتيجة الخصم، يبقى المبلغ محجوزًا حتى لا يُستبعد من الحساب خصم ربما حدث. تعرض فواتيرك الرسوم الفعلية.

حدود معدل الطلبات والمحتوى المرسل نيابةً عنك

بالإضافة إلى حد كل بيانات اعتماد، تخضع الأدوات التي تكتب محتوى نيابةً عنك أو تجري طلبات Telegram مباشرة لحدود على مستوى الحساب: تشترك فيها جميع بيانات اعتماد الحساب، وتُعاد يوميًا عند 00:00 وفق UTC+8. تُرفض الاستدعاءات التي تتجاوز الحد ويُطلب من الذكاء الاصطناعي التوقف؛ وتُرفض أيضًا منشورات المجتمع ورسائل الدعم المتطابقة خلال 10 دقائق، بينما يُمنع تكرار البريد عبر مفتاح عدم تكرار الأثر لا عبر المحتوى. تُوسم هذه الأدوات في لوحة التحكم بـ «مقيّد بالمعدل».

المحتوى المرسل باسمك

بعد تفعيل الأدوات المناسبة، يمكن للذكاء الاصطناعي النشر والرد في المجتمع ومراسلة الدعم المباشر وإرسال البريد من حساب SMTP باسمك. يمثلك هذا المحتوى وأنت مسؤول عنه:

الموارد والموجهات

بالإضافة إلى الأدوات، يوفر الخادم ثلاثة موارد للقراءة فقط وثلاثة موجهات يمكن للعملاء استخدامها مباشرةً.

  • tovanix://catalog — دليل القدرات: جميع المجالات والقدرات، وما فعّلته هذه البيانات منها. يقرأه الذكاء الاصطناعي عند ظهور «غير مصرح» أو عند سؤاله عما يمكنه فعله.
  • tovanix://account/overview — نظرة عامة على الحساب: حالة الحساب والخدمات المستخدمة وأذونات هذه البيانات واستهلاك الحد اليومي. يظهر الرصيد فقط عند تفعيل «عرض رصيد الحساب».
  • tovanix://guide — دليل المنصة: طريقة عرض المبالغ والعملات وحالات الطلبات وما يجب تأكيده قبل إنشاء طلب.
  • account_health — — — فحص الحساب: الرصيد والاشتراكات وتواريخ الانتهاء عبر الخدمات والطلبات غير المعتادة وقائمة المهام المطلوب معالجتها.
  • spend_report — days، القيمة الافتراضية 30 — تقرير الإنفاق: الفواتير الحديثة والإنفاق مجمعًا حسب الخدمة.
  • renewal_check — within_days، القيمة الافتراضية 14 — فحص الانتهاء: الخدمات التي قاربت على الانتهاء وتكلفة تجديدها — لا يُجدّد شيء تلقائيًا.

الأخطاء واستكشاف المشكلات

تُعاد مشكلات الاتصال والمصادقة كرموز حالة HTTP. وتُعاد إخفاقات العمليات كنتائج أدوات (isError: true) يوضح نصها للذكاء الاصطناعي ما ينبغي فعله، مثل «اطلب رمزًا لمرة واحدة من المستخدم» أو «الرصيد غير كافٍ — اطلب من المستخدم الشحن أولًا».

ربط Tovanix MCP من كل أداة AI

استبدل <YOUR_MCP_CREDENTIAL> ببيانات اعتماد MCP التي أنشأتها في لوحة التحكم.

  • Claude Code — التشغيل في الطرفية
    claude mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"
  • Codex — ملف الإعداد: ~/.codex/config.toml
    [mcp_servers.tovanix]
    url = "https://tovanix.com/api/mcp/rpc"
    bearer_token_env_var = "TOVANIX_MCP_CREDENTIAL"
  • Cursor — ملف الإعداد: ~/.cursor/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • GitHub Copilot (VS Code) — ملف الإعداد: .vscode/mcp.json
    {
      "servers": {
        "tovanix": {
          "type": "http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer ${input:tovanix-credential}"
          }
        }
      },
      "inputs": [
        {
          "type": "promptString",
          "id": "tovanix-credential",
          "description": "Tovanix MCP credential",
          "password": true
        }
      ]
    }
  • Gemini CLI — ملف الإعداد: ~/.gemini/settings.json
    {
      "mcpServers": {
        "tovanix": {
          "httpUrl": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • OpenCode — ملف الإعداد: ~/.config/opencode/opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "tovanix": {
          "type": "remote",
          "url": "https://tovanix.com/api/mcp/rpc",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Qwen Code — التشغيل في الطرفية
    qwen mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"
  • Kimi Code CLI — ملف الإعداد: ~/.kimi-code/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • CodeBuddy Code — التشغيل في الطرفية
    codebuddy mcp add --scope user --transport http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" tovanix https://tovanix.com/api/mcp/rpc
  • Qoder CLI — ملف الإعداد: ~/.qoder/settings.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "streamable-http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Kiro — ملف الإعداد: ~/.kiro/settings/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae — ملف الإعداد: .trae/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae CN — ملف الإعداد: .trae/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae CLI — ملف الإعداد: trae_cli.yaml
    mcp_servers:
      - name: "tovanix"
        url: "https://tovanix.com/api/mcp/rpc"
        type: "http"
        headers:
          Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
  • GitHub Copilot CLI — ملف الإعداد: ~/.copilot/mcp-config.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          },
          "tools": [
            "*"
          ]
        }
      }
    }
  • Cline — ملف الإعداد: cline_mcp_settings.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "streamableHttp",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Kilo Code — ملف الإعداد: ~/.config/kilo/kilo.jsonc
    {
      "mcp": {
        "tovanix": {
          "type": "remote",
          "url": "https://tovanix.com/api/mcp/rpc",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Continue — ملف الإعداد: ~/.continue/config.yaml
    mcpServers:
      - name: tovanix
        type: streamable-http
        url: https://tovanix.com/api/mcp/rpc
        requestOptions:
          headers:
            Authorization: Bearer <YOUR_MCP_CREDENTIAL>
  • Zed — ملف الإعداد: ~/.config/zed/settings.json
    {
      "context_servers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Junie — ملف الإعداد: ~/.junie/mcp/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Amp — ملف الإعداد: ~/.config/amp/settings.json
    {
      "amp.mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Goose — ملف الإعداد: ~/.config/goose/config.yaml
    extensions:
      tovanix:
        enabled: true
        type: streamable_http
        name: tovanix
        uri: https://tovanix.com/api/mcp/rpc
        headers:
          Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
        timeout: 300
  • Augment (Auggie) — التشغيل في الطرفية
    auggie mcp add tovanix --transport http --url https://tovanix.com/api/mcp/rpc --header "Authorization:Bearer <YOUR_MCP_CREDENTIAL>"
  • Factory Droid — التشغيل في الطرفية
    droid mcp add tovanix https://tovanix.com/api/mcp/rpc --type http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" --no-oauth
  • Crush — ملف الإعداد: ~/.config/crush/crushrc
    mcp add tovanix --type http --url https://tovanix.com/api/mcp/rpc --header Authorization "Bearer <YOUR_MCP_CREDENTIAL>"
  • Warp — اللصق في إعدادات التطبيق
    {
      "tovanix": {
        "url": "https://tovanix.com/api/mcp/rpc",
        "headers": {
          "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
        }
      }
    }
  • Windsurf — ملف الإعداد: ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "tovanix": {
          "serverUrl": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Claude (ويب / سطح المكتب) — أدخل العنوان في التطبيق وأضف ترويسة Authorization (Bearer + بيانات الاعتماد)
    https://tovanix.com/api/mcp/rpc
  • LM Studio — ملف الإعداد: mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Dify — أدخل العنوان في التطبيق وأضف ترويسة Authorization (Bearer + بيانات الاعتماد)
    https://tovanix.com/api/mcp/rpc
  • Coze — أدخل العنوان في التطبيق وأضف ترويسة Authorization (Bearer + بيانات الاعتماد)
    https://tovanix.com/api/mcp/rpc
  • n8n — أدخل العنوان في التطبيق وأضف ترويسة Authorization (Bearer + بيانات الاعتماد)
    https://tovanix.com/api/mcp/rpc
  • عملاء MCP آخرون — اللصق في إعدادات التطبيق
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }

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

لماذا تُرجع tools/list قائمة فارغة؟

لم تُفعل أي قدرة لبيانات الاعتماد بعد. فعّل ما تحتاجه ضمن "الوصول إلى MCP" في اللوحة وأعد الاتصال.

لماذا تُرفض أدوات الإنفاق دائمًا؟

تحقق من ثلاثة أمور: هل حدود الإنفاق ما زالت بالقيمة الافتراضية 0، وهل المصادقة الثنائية مفعلة، وهل نُفدت الحصة اليومية.

صفحات ذات صلة: دع مساعد الذكاء الاصطناعي يدير حساب Tovanix · وثائق الواجهة البرمجية · تكامل للمطورين

جارٍ التحميل…