إضافة Claude Code

إضافة Hashee لـ Claude Code تتيح لـ Claude Code التفاعل مع محادثات Hashee عبر Model Context Protocol (MCP). يمكن لوكيل Claude Code إرسال رسائل ورفع ملفات وبث ردود وإرسال artifacts — كل ذلك من بيئة البرمجة.

ما هو MCP؟

Model Context Protocol (MCP) هو معيار Anthropic لربط أدوات الذكاء الاصطناعي بالخدمات الخارجية. يستخدم بروتوكول تواصل قائم على stdio حيث تُسجّل الأدوات كدوال قابلة للاستدعاء.

كيف يعمل

Claude Code ──stdio──> Hashee MCP Plugin ──Agent SDK (WS)──> Hashee API
                       │
                       ├── 7 Tools (send, receive, stream, upload...)
                       ├── Channel Push (incoming messages to Claude Code)
                       └── Permission Relay (approve/deny from Hashee app)

تتصل الإضافة بـ Hashee عبر Agent SDK على WebSocket وتعرض 7 أدوات لـ Claude Code عبر MCP.

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

الأداة	المعاملات	الوصف
`hashee_send_message`	`conversation_id`, `text`	إرسال رسالة نصية عبر Agent SDK
`hashee_get_messages`	`conversation_id`, `limit?`	جلب الرسائل الأخيرة (افتراضي 20، أقصى 50)
`hashee_list_conversations`	(لا شيء)	قائمة المحادثات النشطة للوكيل
`hashee_typing`	`conversation_id`	إرسال مؤشر كتابة
`hashee_send_artifact`	`conversation_id`, `artifact`, `title`, `summary?`	إرسال artifact A2H (نموذج، حالة، بطاقة خطأ)
`hashee_stream_reply`	`conversation_id`, `text`	بث رد (أجزاء 100 حرف، فاصل 30ms)
`hashee_send_file`	`conversation_id`, `file_path`, `content_type?`	رفع ملف محلي (أقصى 100MB، كشف MIME تلقائي)

الإعداد

1. تكوين `.mcp.json`

أضف خادم Hashee إلى تكوين MCP لمشروعك:

{
  "mcpServers": {
    "hashee": {
      "command": "npx",
      "args": ["tsx", "packages/public/claude-code-plugin/src/index.ts"],
      "env": {
        "HASHEE_AGENT_ID": "your-agent-uuid",
        "HASHEE_AGENT_TOKEN": "hsk_your-token",
        "HASHEE_SERVER_URL": "https://api.hashee.ai",
        "HASHEE_ALLOWED_USERS": "user-id-1,user-id-2"
      }
    }
  }
}

2. متغيرات البيئة

المتغير	مطلوب	الافتراضي	الوصف
`HASHEE_AGENT_ID`	نعم	—	معرّف الوكيل UUID
`HASHEE_AGENT_TOKEN`	نعم	—	رمز مصادقة الوكيل
`HASHEE_ALLOWED_USERS`	نعم	—	قائمة معرّفات المستخدمين المسموح بهم مفصولة بفواصل
`HASHEE_SERVER_URL`	لا	`https://api.hashee.ai`	عنوان API الأساسي
`HASHEE_CONNECTION_MODE`	لا	`websocket`	`websocket` أو `longpoll`

3. ابدأ Claude Code

سيكتشف Claude Code خادم MCP تلقائياً ويجعل أدوات Hashee متاحة.

دفع القناة

رسائل Hashee الواردة تُدفع إلى Claude Code كإشعارات قناة. فقط رسائل المستخدمين في قائمة HASHEE_ALLOWED_USERS تُمرر.

تُطهّر الإضافة المحتوى (XML-escape لمنع حقن القناة) وتقطع عند 10,000 حرف.

ترحيل الصلاحيات

تدعم الإضافة ترحيل صلاحيات ثنائي الاتجاه بين Claude Code وتطبيق Hashee:

Claude Code يطلب صلاحية (مثلاً لتنفيذ أمر)
ترسل الإضافة Artifact إلى تطبيق Hashee بأزرار موافقة/رفض
يرد المستخدم في تطبيق Hashee
يُرحّل القرار إلى Claude Code

تُرفض الطلبات تلقائياً بعد 60 ثانية.

الأمان

الطبقة	الآلية
قائمة المرسلين المسموح بهم	فقط `HASHEE_ALLOWED_USERS` يمكنهم الدفع للقناة
تطهير XML	يمنع هجمات حقن القناة
قطع المحتوى	حد 10,000 حرف
تقييد مسار الملف	`send_file` يسمح فقط بملفات ضمن دليل العمل
مهلة الصلاحية	رفض تلقائي بعد 60 ثانية
مصادقة الوكيل	رمز Bearer على جميع استدعاءات REST

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

إضافة Codex — تكامل OpenAI Codex
إضافة OpenClaw — تكامل OpenClaw
بدء استخدام SDK — ابنِ وكيلاً مستقلاً