سياق سير العمل لعملاء الذكاء الاصطناعي مع Smartsheet MCP على AWS

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

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

في هذا المنشور، نستعرض طريقتين يمكنك من خلالهما ربطه بسير عملك الحالي. Amazon Quick هو مساحة عمل ذكاء اصطناعي وكيلية مبنية لمستخدمي الأعمال ومديري المشاريع وفرق العمليات. يمكنهم طرح الأسئلة وتحديث الأوراق وإنشاء لوحات المعلومات من خلال اللغة الطبيعية دون كتابة تعليمات برمجية. Kiro هو بيئة تطوير متكاملة وكيلية يتصل بها المطورون بـ Smartsheet عبر MCP للرجوع إلى مواصفات المشروع وتحديث حالة المهام وتتبع الاعتماديات دون مغادرة سير عملهم البرمجي.

نظرة عامة على المعمارية

يوضح المخطط التالي كيف يشكل خادم Smartsheet MCP طبقة التكامل المركزية المتصلة بخدمات AWS. يتصل Amazon Quick وKiro مباشرةً كعميلين لـ MCP.

يخدم Amazon Quick العاملين المعرفيين ومديري المشاريع وفرق العمليات الذين يرغبون في الاستعلام عن Smartsheet وتحديثه وأتمتته من خلال اللغة الطبيعية. ومع Kiro، يمكن للمطورين الرجوع إلى مواصفات المشروع وتحديث حالة المهام وتتبع الاعتماديات دون مغادرة سير عملهم البرمجي.

يوضح مخطط المعمارية التالي مسارات التكامل هذه: خادم Smartsheet MCP في المنتصف، مع Amazon Quick وKiro كعميلين لـ MCP على اليسار، وطبقة API والبيانات الخاصة بـ Smartsheet على اليمين.

الشكل 1: معمارية خادم Smartsheet MCP توضح اتصالات عملاء MCP من Amazon Quick وKiro عبر الخادم إلى طبقة API الخاصة بـ Smartsheet

إدارة الدورات السريعة (Sprints) باستخدام Amazon Quick وKiro

لنتأمل فريقًا لهندسة البرمجيات يتتبع دورته السريعة في Smartsheet. توجد المهام والمسؤولون والحالات والعوائق جميعها في ورقة مشروع. إليك كيف يبدو كل مسار لنفس الفريق:

عندما يرغب مستخدم، مثل مدير مشروع، في التحقق من المهام السريعة المحجوبة هذا الأسبوع، يمكنه سؤال Amazon Quick من خلال اللغة الطبيعية. يستعلم وكيل المحادثة في Amazon Quick عن خادم Smartsheet MCP، ويجلب الصفوف ذات الصلة، ويعرض ملخصًا يتضمن أسماء المسؤولين وتواريخ الاستحقاق. يتم توليد الاستجابة من بيانات Smartsheet المباشرة دون الحاجة إلى إنشاء تقرير أو لوحة معلومات.

أما المطورون الذين يعملون على إصلاح الأخطاء أو تنفيذ الميزات فيمكنهم أن يطلبوا من Kiro جلب ورقة الدورة السريعة الحالية وعرض المهام الخلفية المفتوحة المسندة إليهم. يستعلم Kiro عن Smartsheet عبر MCP ويعرض القائمة داخليًا. وعندما يُودَع الإصلاح، يقوم خطاف (hook) في Kiro تلقائيًا بتحديث حالة الصف المقابل إلى مكتمل (Complete).

المتطلبات الأساسية

يوفر خادم Smartsheet MCP سياقًا مُهيكلًا بدقة، بما في ذلك علاقات الصفوف وأنواع الأعمدة وسجل الخلايا والتعليقات. هذا ينتج أحجام بيانات فعالة من حيث الاستهلاك الرمزي بدلاً من إرجاع حمولات API الخام. ويتضاعف هذا القرار الهندسي ليصبح خفضًا في التكلفة وتحسينًا في زمن الاستجابة على نطاق واسع عند تشغيل مئات الاستعلامات المدعومة بالذكاء الاصطناعي عبر محفظة مشاريع. لمعرفة كيف بنى فريق Smartsheet خادم MCP البعيد الخاص بهم على AWS، راجع كيف بنت Smartsheet خادم MCP بعيدًا على AWS.

قبل ربط خادم Smartsheet MCP بـ Amazon Quick وKiro، تحقق من توفر ما يلي:

• حساب AWS نشط بأذونات AWS Identity and Access Management (IAM) مناسبة للخدمة التي تتصل بها (Amazon Quick أو Kiro)
• حساب Smartsheet على خطة Business أو Enterprise أو AWM.
• رمز وصول شخصي (Personal Access Token) لـ Smartsheet، أو بيانات اعتماد OAuth إذا كان عميلك يدعم تدفق OAuth.
• بالنسبة إلى Amazon Quick: أذونات بمستوى مؤلف (Author) أو أعلى في حسابك على Amazon Quick.
• بالنسبة إلى Kiro: بيئة Kiro IDE المثبتة من kiro.dev مع Node.js متاح في بيئتك.

خادم Smartsheet MCP متاح في ثلاث نقاط نهاية إقليمية. يستخدم نقل Streamable HTTP (إصدارات مواصفات MCP 2025-06-18 و2025-03-26) ويُصادق عليه إما عبر OAuth 2.0 أو رمز وصول شخصي.

• النسخة التجارية الأمريكية: https://mcp.smartsheet.com.
• أوروبا: https://mcp.smartsheet.eu.
• أستراليا: https://mcp.smartsheet.au.

كلا الخيارين يوفران نفس مجموعة أدوات Smartsheet. الاختيار الصحيح يعتمد على مكان إنجاز عملك:

اختر Amazon Quick إذا كنت بحاجة إلى حل مُدار بالكامل على مستوى المؤسسة يمكن لفريقك بأكمله استخدامه: بدون تسجيل تطبيق، مع OAuth جاهز مسبقًا فقط، ويتوسع عبر موظفي المعرفة في مؤسستك.

اختر Kiro إذا كنت مطورًا يريد شيئًا خفيفًا: بدون بنية تحتية، فقط ملف إعداد ورمز وصول شخصي، مُحصور على سير عملك الخاص.

تكامل Amazon Quick

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

يجعل Amazon Quick هذا التكامل متاحًا عبر المؤسسة بأكملها، من مديري المشاريع وفرق العمليات إلى مستخدمي الأعمال الذين يديرون أعمالهم في Smartsheet.

لإضافة تكامل Quick:

1. في وحدة تحكم Amazon Quick، انتقل إلى Connectors وابحث عن Smartsheet في الدليل.

الشكل 2: موصل Smartsheet في دليل Amazon Quick Connectors

1. حدد تجانب موصل Smartsheet .
2. أدخل تفاصيل التكامل التالية:
   1. Name – اسم وصفي لتكامل Smartsheet الخاص بك.
   2. احتفظ بإعدادات Connection type و Auth configuration كما هي.
   3. Base URL – https://mcp.smartsheet.com.
   4. Client ID – معرّف عميل التطبيق من تسجيل تطبيقك في Smartsheet Developer Tools.
   5. Client Secret – سر التطبيق من تسجيل تطبيقك في Smartsheet Developer Tools.
   6. Token URL – https://api.smartsheet.com/2.0/token.
   7. Auth URL – https://app.smartsheet.com/b/authorize.

الشكل 3: إدخال تفاصيل اتصال Smartsheet في Amazon Quick

1. اختر التالي.
2. في صفحة إدارة الأدوات والأذونات (Manage Tools & Permissions) سترى قائمة بالأدوات المتاحة. اختر التالي.

الشكل 4: صفحة إدارة الأدوات والأذونات الخاصة بموصل Smartsheet

1. في صفحة النشر (Publish) اختر من يمكنه الوصول إلى هذا الاتصال، ثم اختر نشر (Publish).

الشكل 5: اختيار من يمكنه الوصول إلى اتصال Smartsheet في صفحة النشر

1. اختر التالي.

بعد اتصالك، يمكن لوكيل المحادثة Amazon Quick العمل مع بيانات Smartsheet من خلال اللغة الطبيعية:

• "ما المشاريع في محفظتنا المصنفة حاليًا كمعرضة للخطر (At Risk)؟"
• "حدّث حالة مهمة المصادقة في ورقة Backend API إلى مكتملة (Complete)."
• "أنشئ ملخصًا لجميع العناصر المتأخرة عبر Q3 Roadmap وأرسله إلى الفريق."

الشكل 6: استجابة محادثة Amazon Quick تلخّص المهام المتأخرة من ورقة مشروع Smartsheet مع ملاحظات رئيسية وإجراءات موصى بها

التكامل مع Kiro

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

تم بناء Kiro حول التطوير القائم على المواصفات (spec-driven development). فهو يحوّل المطالبات عالية المستوى إلى مواصفات منظمة، ثم إلى شيفرة برمجية عاملة ووثائق واختبارات. خوادم MCP هي الوسيلة التي يحصل بها Kiro على السياق الواقعي من خلال الاتصال بالوثائق وقواعد البيانات وواجهات APIs والأنظمة المؤسسية، ليرسيخ وكيله في البيانات الحية بدلًا من المعرفة المكتسبة وقت التدريب.

ميزة في Kiro تسمى powers هي حزمة قابلة للتثبيت بنقرة واحدة تضم خادم MCP منسقًا مع ملفات توجيه (steering files) وخطافات (hooks). تمنح هذه الحزمة وكيل البرمجة في Kiro قدرة جديدة جاهزة للاستخدام. بالنسبة لـ Smartsheet، يستغرق إعداد الاتصال كتلة إعداد JSON واحدة، ومن تلك اللحظة يمكن لوكيل Kiro الإشارة إلى بيانات المشروع الحية كجزء من سير عمل التطوير.

لربط Smartsheet MCP Server بـ Kiro، أضفه إلى إعدادات MCP في Kiro (.kiro/settings/mcp.json لنطاق مساحة العمل). للحصول على شرح كامل، راجع البدء مع Kiro وخوادم MCP:

{
  "mcpServers": {
    "smartsheet-us": {
      "type": "http",
      "url": "https://mcp.smartsheet.com",
      "headers": {
        "Authorization": "Bearer <SMARTSHEET_API_TOKEN>"
      }
    }
  }
}

يستخدم هذا الإعداد أسلوب رمز الوصول الشخصي (مفتاح API). للنشر في بيئات الإنتاج، يُوصى باستخدام OAuth.

مجموعة SMARTSHEET_API_TOKEN إلى رمز الوصول الشخصي الخاص بك في Smartsheet (Personal Access Token) داخل بيئتك. يقوم Kiro بتحميل خوادم MCP كعمليات خلفية عند بدء التشغيل. وبعد اكتمال التهيئة، تصبح أدوات Smartsheet متاحة لوكيل Kiro في جميع الأوضاع: الدردشة، وتخطيط المواصفات، والأتمتة القائمة على الخطافات (hooks). التفاصيل الكاملة في ال وثائق خادم Smartsheet MCP.

من هناك، يمكن لـ Kiro الإشارة إلى بيانات Smartsheet كجزء من سير عمل التطوير:

• «راجع ورقة مشروع Backend API للتحقق من وجود أي أخطاء مفتوحة وقم بإنشاء قائمة إصلاحات مرتبة حسب الأولوية.»

الشكل 7: Kiro يُنشئ قائمة إصلاحات مرتبة حسب الأولوية من الأخطاء المفتوحة في ورقة مشروع Backend API

• «اسحب ورقة خارطة الطريق للربع الثالث (Q3) وأنشئ مواصفة للميزات المعلّمة بأنها قيد التنفيذ (In Progress).»

الشكل 8: Kiro ينشئ مواصفة (spec) من الميزات قيد التنفيذ في ورقة خارطة طريق الربع الثالث (Q3)

حوكمة المؤسسات

للمطوّرين الذين ينشرون في بيئات منظَّمة أو مؤسسية، يعتمد نموذج الأمان الخاص بـ Smartsheet MCP Server على البنية التحتية وطبقة الأذونات نفسها المستخدمة في واجهة Smartsheet REST API. وهو ليس حد ثقة جديداً:

• مصادقة OAuth 2.0 ورموز الوصول الشخصية: اختر طريقة المصادقة المدعومة من عميل MCP الخاص بك.
• فرض أذونات على مستوى المستخدم: لا يمكن للوكلاء الوصول إلا إلى البيانات التي يملك المستخدم المُصادق عليه صلاحية رؤيتها. لا توجد ترقية للامتيازات من خلال المطالبات اللغوية الطبيعية.
• ضوابط الذكاء الاصطناعي على مستوى المؤسسة: يمكن لمسؤولي النظام تشغيل ميزات الذكاء الاصطناعي أو إيقاف تشغيلها على مستوى النظام بأكمله. أما الوصول إلى أداة الكتابة فهو قابل للتهيئة حسب مجموعة المستخدمين.
• نقل Streamable HTTP: يتم تنفيذ إضافة عناوين السماح في جدار الحماية باستخدام اسم النطاق المؤهل بالكامل (FQDN)‏ (mcp.smartsheet.com)، وليس باستخدام عنوان IP.

بالنسبة لمهندسي الامتثال، لا يخزّن MCP Server المطالبات (prompts)، ويبقى محتوى المطالبة بين عميل الذكاء الاصطناعي والنموذج. لا يرى Smartsheet سوى استدعاءات الأدوات المنظمة ونتائجها.

التنظيف

إذا اتبعت هذا الدليل التطبيقي وترغب في إزالة التكامل لاحقًا، إليك كيفية التراجع عن كل مسار:

Amazon Quick

1. في وحدة تحكم Amazon Quick، انتقل إلى Connectors.
2. حدد موصل Smartsheet الخاص بك.
3. اختر Delete لإزالة الاتصال. يؤدي هذا إلى إلغاء رمز OAuth المميز وإيقاف وصول الوكيل إلى بيانات Smartsheet.

Kiro

1. افتح ملف إعداد MCP الخاص بك (.kiro/settings/mcp.json).
2. أزل الإدخال smartsheet-us من mcpServers object.
3. أعد تشغيل Kiro لإلغاء تحميل الخادم.

الخطوات التالية

للخلفية حول كيفية عمل الخادم، راجع كيف بنت Smartsheet خادم MCP بعيدًا على AWS. بعد ربط Smartsheet MCP Server بالنظام الذي تختاره، إليك أربعة إجراءات نوصي بتجربتها:

يمكنك أن تطلب من وكيل الدردشة مراقبة أوراق مشاريعك النشطة وتحديد الصفوف المُعلّمة بـ Blocked أو At Risk. يمكنك أيضًا أن تطلب إضافة تعليق مناقشة على المشاريع، وإرسال ملخص منظم لفريقك عبر القناة التي تفضلها. هذا مثال على سير عمل يربط get_sheet_summary, search، و create_discussion_on_row.

يمكن للوكيل أيضًا استرداد البيانات عبر Smartsheet MCP Server لمطابقة حالات المهام بين متتبع المشكلات وخطة مشروعك في Smartsheet. يمكنه تحديد الانحراف بين الاثنين، وتحديث الصفوف المتأثرة، باستخدام get_sheet_summary, get_columns, update_rows، و create_discussion_on_row بالتسلسل.

يمكنك أيضًا محاولة تجميع مؤشرات صحة المشروع عبر تقاريرك ولوحات المعلومات لديك. يمكنك استخدامه لإنتاج إحاطة منظمة دون جمع يدوي للبيانات، بالاستناد إلى list_reports, get_report, list_dashboards, get_dashboard، و search.

وأخيرًا، يمكنك استخدام الوكيل لمتابعة كل عملية كتابة بتعليق مناقشة يشرح ما الذي تغيّر ولماذا. هذا يُنشئ سجل تدقيق قابلًا للقراءة البشرية داخل Smartsheet من خلال الجمع بين update_rows و create_discussion_on_row.

تعمل جميع الأنماط الأربعة عبر المسارات السابقة: Amazon Quick لسير العمل الموجّه لمستخدمي الأعمال، و Kiro للإجراءات التي يبدئها المطورون.

هل تبني شيئًا باستخدام Smartsheet MCP وAWS؟ شارك ما تعمل عليه في التعليقات، أو تواصل معنا في مجتمع مطوري Smartsheet.

عن المؤلفين