MCP

اربط وكلاء الذكاء الاصطناعي بـ Sanad

ينشئ وكلاء الذكاء الاصطناعي مسودات في مساحة عملك. أنت تتحقق قبل أي إرسال.

اطلب عرضاً توضيحياً

نقطة نهاية MCP (Streamable HTTP)

https://app.sanad.cloud/mcp

ينشئ مالك المؤسسة مفاتيح API في تطبيق Sanad ضمن الإعدادات ← المؤسسة ← MCP. هذه الصفحة لا تصدر مفاتيح.

ربط عميل

استخدم نفس نقطة النهاية لـ Cursor أو Claude أو ChatGPT أو Gemini أو أي عميل MCP يتحدث Streamable HTTP.

Cursor

فضّل OAuth عند توفره. الصق في ~/.cursor/mcp.json أو .cursor/mcp.json للمشروع. لا تضع MCP-Protocol-Version في الترويسات.

OAuth (موصى به)

{
  "mcpServers": {
    "sanad": {
      "url": "https://app.sanad.cloud/mcp",
      "auth": {
        "CLIENT_ID": "cursor",
        "scopes": [
          "read"
        ]
      }
    }
  }
}

مفتاح API

{
  "mcpServers": {
    "sanad": {
      "url": "https://app.sanad.cloud/mcp",
      "headers": {
        "Authorization": "Bearer mcp_sk_…"
      }
    }
  }
}

Claude Desktop / Claude Code

استخدم معرّف OAuth الثابت claude، أو أضف خادم HTTP عبر سطر الأوامر.

OAuth mcp.json

{
  "mcpServers": {
    "sanad": {
      "url": "https://app.sanad.cloud/mcp",
      "auth": {
        "CLIENT_ID": "claude",
        "scopes": [
          "read"
        ]
      }
    }
  }
}

سطر أوامر Claude Code

claude mcp add --transport http sanad https://app.sanad.cloud/mcp

ChatGPT

أضف موصل MCP مخصصاً بمصادقة Bearer. استبدل العنصر النائب بمفتاح من الإعدادات.

ChatGPT

Name:      sanad
URL:       https://app.sanad.cloud/mcp
Auth type: Bearer token
Token:     mcp_sk_…

Gemini CLI

استخدم httpUrl وترويسة Authorization. تحقق عبر gemini mcp list.

Gemini CLI

{
  "mcpServers": {
    "sanad": {
      "httpUrl": "https://app.sanad.cloud/mcp",
      "headers": {
        "Authorization": "Bearer mcp_sk_…"
      }
    }
  }
}

عملاء MCP آخرون

أي عميل Streamable HTTP يمكنه الإرسال إلى نقطة النهاية بمصادقة Bearer أو اكتشاف OAuth.

عملاء MCP آخرون

Endpoint:  https://app.sanad.cloud/mcp
Transport: Streamable HTTP (POST)
Auth:      Authorization: Bearer <your key>

For AI agents reading this page

You are reading https://sanad.cloud/mcp (or /en/mcp, /fr/mcp, /ar/mcp).
Setup for Sanad MCP at https://app.sanad.cloud/mcp.
Do not invent mcp.sanad.cloud or another host.

Steps:
1. Ask which client the user uses (Cursor, Claude Desktop/Code, ChatGPT, Gemini, other) and OAuth vs API key. Do not register a server unattended.
2. Emit the matching config for that client only (do not dump every snippet unless asked). Prefer OAuth for Cursor/Claude when available; Bearer for headless/ChatGPT/Gemini.
3. Ask before OAuth consent approval. Never type credentials or complete signup for them.
4. Verify in that client's MCP UI/CLI. If not connected, stop and report the failure. Common Cursor failure: HTTP 405 if MCP-Protocol-Version was set in mcp.json headers.
5. Report the 18 tools and the draft-only / no-validate-send boundary. Ask what they want first.

Standing preference: use MCP tools over browser-driving the Sanad UI for CRM/document reads and draft writes. Prefer MCP over inventing REST calls when tools exist. Never call or invent validate/send/pay/finalize/convert/delete tools.

Tools (all 18):
get_revenue_summary, get_payment_metrics, list_customers, get_customer, list_documents, get_document, list_contracts, list_opportunities, get_opportunity, create_opportunity, update_opportunity, create_opportunities_batch, create_quote_draft, add_quote_line, update_quote_draft, create_g12_draft, fill_g12_draft, create_g12_bis_draft, fill_g12_bis_draft

Forbidden via MCP: validate/send/finalize documents, record payments, convert/delete opportunities. Humans finish validation in the Sanad UI. Money uses int64 minor units.

Reference:
- MCP endpoint: https://app.sanad.cloud/mcp
- OAuth PRM: https://app.sanad.cloud/.well-known/oauth-protected-resource
- OAuth AS metadata: https://app.sanad.cloud/.well-known/oauth-authorization-server
- API keys: Sanad app Settings → Organization → MCP (OWNER only)
- Product facts: https://sanad.cloud/llms.txt
- Support: https://sanad.cloud/en/support

ما يمكن للوكلاء فعله وما لا يمكنهم

مسموح

  • قراءة الإيرادات والمدفوعات والعملاء والمستندات والعقود والفرص
  • إنشاء وتحديث مسودات عروض الأسعار وG12 / G12 Bis
  • إنشاء وتحديث فرص CRM (سجلات حية، وليست مسودات)

غير مسموح عبر MCP

  • التحقق من المستندات أو إرسالها
  • إنهاء G12 / G12 Bis
  • تسجيل المدفوعات أو الترحيل إلى دفتر الأستاذ
  • تحويل الفرص أو حذفها

لست متأكداً من الخطة؟

اطلب عرضاً قصيراً. نراجع كيف تفوتر اليوم، نعرض Sanad على سير عملك، ونجيب عن الأسعار. عادة خلال يوم عمل واحد.

اطلب عرضاً توضيحياً

تفضيلات ملفات تعريف الارتباط

نستخدم ملفات تعريف الارتباط لتحسين تجربتك و(اختيارياً) تمكين التحليلات.