0Pricing
MCP Academy · درس

مصافحة التهيئة

كيف يتفق العميل والخادم على الإصدار والميزات.

مصافحة التهيئة درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

First Words Matter

Before any tool runs, client and server must meet. That opening exchange is the initialize handshake, and nothing else happens until it finishes.

The Client Speaks First

The handshake always starts with the client sending an initialize request. The server stays quiet and waits to be greeted before it replies.

{"jsonrpc": "2.0", "id": 0, "method": "initialize"}

Agreeing on a Version

The client offers a protocolVersion so both sides speak the same MCP edition. The server confirms a version it can support in its reply.

{"params": {"protocolVersion": "2025-06-18"}}

Declaring Capabilities

Each side lists its capabilities, such as tools, resources, or sampling. This tells the other party which features it may safely use.

{"capabilities": {"tools": {}, "resources": {}}}

Introducing Yourself

The client also sends clientInfo with its name and version. It is a friendly nameplate so the server knows exactly who connected.

{"clientInfo": {"name": "claude-desktop", "version": "1.0"}}

The Server Responds

The server replies with its own chosen version, its capabilities, and serverInfo. Now both sides know what the other can do.

{"result": {"protocolVersion": "2025-06-18",
  "serverInfo": {"name": "my-server", "version": "0.1"}}}

Sealing the Deal

After the reply, the client sends a final notifications/initialized message. It has no id and no answer, simply signaling that setup is complete.

{"jsonrpc": "2.0", "method": "notifications/initialized"}

Only Then, Real Work

Until that initialized notification arrives, the server should refuse other calls. The handshake gates everything that follows it.

Why Negotiate at All

Versions and features evolve, so the handshake lets a new client and an old server negotiate common ground instead of crashing on mismatch.

Capabilities Shape the Session

If the server never advertised resources, a polite client will not ask for them. Declared capabilities quietly define the rules of the whole session.

The Handshake in Three Beats

Remember the rhythm: client sends initialize, server responds, client confirms with initialized. Three beats and the connection is live.

Quick Check

What does the client send to finish the initialize handshake?

Recap: Saying Hello

You traced the handshake end to end: the client offers a version and capabilities, the server confirms, and a final initialized note opens the session for real work.

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

هل درس «مصافحة التهيئة» مجاني؟

نعم — نص درس «مصافحة التهيئة» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.

ماذا ستتعلم في «مصافحة التهيئة»؟

كيف يتفق العميل والخادم على الإصدار والميزات. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟

لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «مصافحة التهيئة»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟

نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. الطلبات والاستجابات والإشعارات
  2. بنية استدعاء JSON-RPC
  3. مصافحة التهيئة
  4. قراءة الأخطاء في سلك الاتصال
← العودة إلى MCP Academy