خادم MCP

تكشف Nexevo عن خادم Model Context Protocol (MCP)، بحيث يمكن لعميل MCP — Claude Desktop، Cursor، أو أي مضيف يدعم MCP — استدعاء مجموعة فرعية آمنة من أدوات مساحة عملك، بما في ذلك البحث في معرفتك الخاصة.

المُنفّذ

مُنفّذ JSON-RPC 2.0 واحد (مراجعة MCP 2025-03-26، HTTP قابل للبث):

POSThttps://nexevo.ai/v1/mcp

يجب أن يُفعّل المسؤول خادم MCP في Settings قبل أن يستجيب — يُرجع 404 حتى ذلك الحين. هذا مفتاح إطلاق متعمّد (مطابق لـ Tools API)، نظرًا لأنه سطح عام.

المصادقة

استخدم نفس مفتاح API لمساحة العمل كـ REST API، في ترويسة Authorization. يربط المفتاح الاتصال بمساحة عمل واحدة — يرى العميل فقط أدوات وبيانات تلك المساحة.

http

Authorization: Bearer sk-ws-...

ما الذي يُكشف

فقط مجموعة فرعية آمنة، للقراءة / الحساب فقط من مجموعة أدوات الـ agent متاحة عبر MCP (استدعِ tools/list لرؤية القائمة الدقيقة لمساحة عملك):

بحث الويب — web_search, url_reader, advanced_scrape, document_read, ocr_extract.
البيانات المفتوحة — arxiv_search, sec_edgar, world_bank, oecd, financial_data, currency_convert, weather, rss_read.
معرفة مساحة عملك — rag_search فوق ذاكرتها طويلة الأمد ومعرفتها المرفوعة، بالإضافة إلى spreadsheet_analyze.
الحوسبة — calculator, convert, current_time, base64, random_choice.

التوليد (صور / فيديو / كلام)، وإجراءات خدمة العملاء، والبريد، والمتصفح / سطح المكتب، والموصلات، وSQL غير مكشوفة عبر MCP — لذا يمكن لعميل متصل أن يقرأ ويستنتج، لكن لا يستطيع الإنفاق بكثرة أو تغيير أي شيء.

الطرق

MCP القياسي: initialize، وإشعار notifications/initialized، وtools/list، وtools/call، وping.

جرّبه مع curl

اسرد الأدوات المتاحة:

bash

curl https://nexevo.ai/v1/mcp \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

استدعِ واحدة — ابحث في معرفة مساحة عملك:

bash

curl https://nexevo.ai/v1/mcp \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"rag_search","arguments":{"query":"our refund policy"}}}'

ربط عميل MCP

في أي مضيف MCP يدعم خادم HTTP قابل للبث عن بُعد مع ترويسات مخصصة، وجّهه إلى المُنفّذ ومرّر مفتاحك. يختلف الشكل حسب العميل، لكن الشيئين اللذين يحتاجهما كل عميل هما الـ URL وترويسة Authorization:

json

{
  "mcpServers": {
    "nexevo": {
      "url": "https://nexevo.ai/v1/mcp",
      "headers": { "Authorization": "Bearer sk-ws-..." }
    }
  }
}

تُفوترة استدعاءات الأدوات عبر MCP بنفس معدل كل استدعاء الذي يستخدمه الـ agent (معظم أدوات القراءة فقط مجانية). تُعقَّم الاستجابات — لا يرى عميل MCP أبدًا أخطاء داخلية خام.