CommandAGI Developers
احصل على مفتاح API
القائمة
احصل على مفتاح API

الوثائق · 04

SDK وMCP.

خادما MCP — واحد في السحابة وواحد على حاسوبك — وحزمتا SDK. اختر الأقرب إلى المكان الذي يعمل فيه وكيلك.

أيهما تحتاج؟

تريد أن يقوم الوكيل بـ…استخدم
العمل مع ملفاتك السحابية ومحادثاتك وحسابك من أي مكانخادم MCP المستضاف
تشغيل الآلات المتصلة بحاسوبك، ضمن تفويضات محليةمرحّل MCP المحلي، commandagi mcp
تشغيل CommandAGI من برنامجك الخاصSDK بلغة TypeScript أو SDK بلغة Python

تُصادق الثلاثة بوصفها مبدأً. ولا يستطيع أي منها إنشاء تفويض أو توسيعه — فذلك دائماً فعل شخص.

خادم MCP المستضاف

https://api.commandagi.com/mcp — Streamable HTTP، عديم الحالة، واستجابات JSON. صادق بمفتاح API (cagi_…)، يُنشأ في منضدة العمل من مفاتيح API في قائمة الحساب.

shell
claude mcp add --transport http commandagi https://api.commandagi.com/mcp \
  --header "Authorization: Bearer cagi_YOUR_KEY"

يعرض كتالوجاً كبيراً من الأدوات — أكثر من ثلاثمئة — تشمل المحادثات (list_threads وcreate_thread وsend_message وget_thread)، والملفات (list_drive وread_drive_file وwrite_drive_file)، وحسابك (whoami وget_credits وlist_models)، والشيفرة (run_code)، والمواقع المستضافة (create_site وdeploy_site)، والتداول (trade_venues وtrade_order وtrade_account وtrade_cancel)، والمضيفون المقترنون (list_hosts وhost_call). استخدم search_tools للعثور على الأداة التي تحتاجها.

مرحّل MCP المحلي

على حاسوب يعمل فيه المضيف، يعمل commandagi mcp كخادم MCP عبر stdio يحوّل الطلبات إلى نقطة النهاية الخاصة بالمضيف. أعطِه بيانات اعتماد المضيف الخاصة بالوكيل — في البيئة أو في ملف، وليس وسيطة في سطر الأوامر:

shell
claude mcp add commandagi -e COMMANDAGI_CREDENTIAL=cagp_… -- commandagi mcp
# or
claude mcp add commandagi -- commandagi mcp \
  --credential-file ~/.config/claude/commandagi.credential

من دون بيانات اعتماد، يستطيع العميل القراءة وعرض الأشياء، لكنه لا يستطيع التصرف. تُجيب نقطة نهاية المضيف على loopback فقط، وترفض الطلبات التي تحمل أصل صفحة ويب. وتجيب أدوات التحكم نفسها عبر HTTP العادي أيضاً عند POST /control/<tool> مع Authorization: Bearer <credential>.

الأدوات المحلية

المجموعةالأدوات
المشروع والعوالمget_project وproject_status وlist_worlds وget_world وsave_world وlist_devices وget_device
الملفاتread_file وwrite_file (ضمن تفويض ملفات)، وgraph_query وgraph_search
الشيفرة والمحاكاةevaluate_code (معزول، من دون شبكة)، وsim_trials
منضدة العمل المفتوحةlist_panes وopen_file وshow_world وthread_read وthread_say
التحكمlist_grants وlist_units وopen_channel وarm وrun_program وsend_command وread_channel وstop وclose_channel
مضيفون آخرونlist_hosts وhost_call
التواصل الخارجيoutreach_apps وoutreach_identify وoutreach_start وoutreach_send وoutreach_reply وoutreach_outcome وoutreach_due وoutreach_advance وoutreach_status
الأسواقmarket_venues وmarket_order وmarket_account وmarket_cancel

تتبع أدوات التحكم كل قاعدة في الوكلاء والتفويضات الدائمة: تحتاج كل أداة إلى الفعل المطابق في تفويض، ويحتاج stop إلى أي تفويض، ويُسجَّل كل إجراء قبل إرساله.

SDK بلغة TypeScript

shell
npm i commandagi        # Node 22 or later
typescript
import { CommandAGI } from "commandagi";

const cagi = new CommandAGI(); // reads COMMANDAGI_API_KEY
const { threadId } = (await cagi.threads.create({
  intent: "Summarise this week's robotics news",
})) as { threadId: string };
await cagi.threads.send(threadId, "Add a link for each one.");

الأمر commandagi حزمة أخرى، هي @commandagi/host (npm install -g @commandagi/host)، وهي أيضاً المضيف المحلي: commandagi whoami وcommandagi threads create --intent "…" وcommandagi call <tool> --json '{…}'، وطرفية تفاعلية عند تشغيلها وحدها. المصدر: github.com/CommandAGI/commandagi-sdk-typescript.

SDK بلغة Python

shell
pip install commandagi      # Python 3.9 or later
uv pip install commandagi   # an environment uv manages (in a uv project: uv add commandagi)
python
from commandagi import CommandAGI

cagi = CommandAGI()  # reads COMMANDAGI_API_KEY
with cagi.launch("simulation/warehouse") as world:
    world.sim.ik(target=[0.3, 0.0, 0.4])
    jpeg = world.observe(fresh=True)

المصدر: github.com/CommandAGI/commandagi-sdk-python.

البيئة

المتغيرالمعنى
COMMANDAGI_API_KEYمفتاح API الخاص بك، cagi_…
COMMANDAGI_BASE_URLأصل الواجهة البرمجية، والافتراضي https://api.commandagi.com
COMMANDAGI_CREDENTIALبيانات اعتماد أحد الأطراف لمرحّل MCP المحلي