إعداد MCP | Bank Statement Conversion - Bank-Statement-Conversion
خادم MCP البعيد

قم بإعداد Bank Statement Conversion MCP.

قم بتوصيل العملاء المتوافقين مع Claude، وCodex، وCursor، والوكلاء المخصصين لأدوات التحويل المباشرة باستخدام رمز مميز للوحة المعلومات.

ابدأ الإعداد عرض خيارات الوكيل
نقطة النهاية البعيدةhttps://bank-statement-conversion.com/mcp/bank-statement-conversionمتغير بيئة الرمز المميزBSC_API_TOKEN

أربع خطوات الإعداد.

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

1

إنشاء رمز مخصص

استخدم صفحة API Tokens بلوحة المعلومات لإنشاء رمز مميز لهذا الوكيل، بشكل منفصل عن الرموز المميزة الشخصية أو تطبيقات الإنتاج.

2

تمكين القدرات النطاقية

امنح فقط حالة الحساب، والتحميل، وقراءة الحالة، وقدرات التنزيل التي تحتاجها أدوات MCP.

3

أضف نقطة النهاية البعيدة

قم بتوجيه العميل القادر على استخدام MCP إلى نقطة النهاية Bank Statement Conversion المستضافة.

4

تأكيد الإجراءات الحساسة

اطلب من الوكيل أن يسألك قبل تحميل المستندات المالية أو إعداد تنزيلات الملفات المحولة.

نقطة النهاية

أضف خادم MCP البعيد.

استخدم Streamable HTTP عندما يطلب عميلك النقل. يقبل بعض العملاء متغير بيئة الرمز المميز لحامله، بينما يستخدم البعض الآخر رأس التفويض.

التكوين Codex
[mcp_servers.bank_statement_conversion]
url = "https://bank-statement-conversion.com/mcp/bank-statement-conversion"
bearer_token_env_var = "BSC_API_TOKEN"
التكوين العام Streamable HTTP
{
    "mcpServers": {
        "bank-statement-conversion": {
            "type": "streamable-http",
            "url": "https://bank-statement-conversion.com/mcp/bank-statement-conversion",
            "headers": {
                "Authorization": "Bearer ${BSC_API_TOKEN}"
            }
        }
    }
}
المصادقة

احتفظ بالرمز المميز بعيدًا عن المطالبات.

قم بإنشاء رمز مميز للوحة المعلومات، وقم بتخزينه كمتغير بيئة، ولا تقم مطلقًا بلصق الرمز المميز في الدردشة أو التعليمات البرمجية المصدر أو المستندات أو لقطات الشاشة أو السجلات.

إنشاء الرمز المميز API
متغير البيئة
BSC_API_TOKEN=your_dashboard_token
account:status conversion:read conversion:upload conversion:download

إعداد Claude وAnthropic.

استخدم نفس نقطة النهاية MCP المستضافة مع موصلات Claude أو Anthropic Messages API.

Claude

التطبيق Claude وClaude Desktop

  1. قم بإنشاء رمز مميز للوحة المعلومات Bank Statement Conversion من API Tokens.
  2. افتح إعدادات Claude، ثم انتقل إلى الموصلات واختر إضافة موصل مخصص.
  3. أدخل https://bank-statement-conversion.com/mcp/bank-statement-conversion كعنوان URL لخادم MCP البعيد.
  4. استخدم الرمز المميز للوحة القيادة لمصادقة الحامل عندما يطلب Claude الاتصال.
  5. قم بتمكين الموصل في الدردشة وقم بتشغيل التحقق من حالة الحساب قبل تحميل الملفات.
Anthropic API

موصل Messages API MCP

احتفظ BSC_API_TOKEN جانب الخادم وتمريره كرمز ترخيص خادم MCP. يحتاج الطلب أيضًا إلى مجموعة أدوات MCP التي تشير إلى نفس اسم الخادم.

Anthropic MCP شكل الطلب
{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "Check whether my Bank Statement Conversion account can run a conversion."
        }
    ],
    "mcp_servers": [
        {
            "type": "url",
            "url": "https://bank-statement-conversion.com/mcp/bank-statement-conversion",
            "name": "bank-statement-conversion",
            "authorization_token": "${BSC_API_TOKEN}"
        }
    ],
    "tools": [
        {
            "type": "mcp_toolset",
            "mcp_server_name": "bank-statement-conversion"
        }
    ],
    "betas": [
        "mcp-client-2025-11-20"
    ]
}

متاح سير العمل MCP.

يتم تعيين الأدوات إلى نفس سير عمل التحويل العام الذي يستخدمه REST API.

حالة الحساب

تحقق من الاعتمادات، وبدل الصفحة، والخطة، وما إذا كان يمكن تشغيل التحويل.

تحميل ملفات التحويل

أرسل بيانات بنكية مؤكدة أو فواتير أو إيصالات أو ملفات بيانات منظمة.

قراءة حالة التحويل

تقدم مهمة الاستطلاع حتى تتضمن الاستجابة المكتملة رمزًا مميزًا للتنزيل.

تحميل الإخراج

استرجع التحويل المكتمل باستخدام رمز التنزيل الذي تم إرجاعه.

GET /api/user-statusPOST /api/uploadGET /api/conversion-status/{jobId}GET /api/download/{downloadToken}
نطاق السلامة

تحتاج المستندات المالية إلى رقابة واضحة.

يجعل MCP التحويل متاحًا داخل الدردشة، لذلك يجب أن يظل سير العمل ضيقًا وقابلاً للتدقيق وسهل الإلغاء.

استخدم رمز API المخصص لكل مساحة عمل وكيل.
قم بتمكين قدرات التحويل الأربعة الموضحة في هذه الصفحة فقط.
تأكد قبل تحميل البيانات أو الفواتير أو الإيصالات أو ملفات المحاسبة.
قم بالتأكيد قبل إعداد روابط التنزيل للمخرجات المحولة.
استخدم رموز التنزيل التي تم إرجاعها. لا تقم بإنشاء عناوين URL للملفات.
قم بإلغاء الرمز المميز للوحة المعلومات عندما يجب أن يتوقف وصول الوكيل.

هل أنت مستعد لتوصيل عميل MCP؟

قم بتعيين BSC_API_TOKEN، وأضف نقطة النهاية البعيدة، واطلب من الوكيل تشغيل فحص الحالة أولاً.

إدارة الرموز المميزة API مرجع API