إضافة ChatGPT وMCP
بيانات الشركات مباشرةً في ChatGPT وClaude ووكلاء الذكاء الاصطناعي الآخرين.
مع إضافة ChatGPT وخادم MCP يبحث وكيل الذكاء الاصطناعي الخاص بك عن بيانات الشركات الرسمية بنفسه. تطرح سؤالًا في المحادثة، فيختار الوكيل الأدوات المناسبة ويجيب ببيانات من السجل.
إضافة ChatGPT
إضافة ChatGPT هي أسرع طريقة. لا تحتاج إلى مفتاح API، لأنك تسجّل الدخول بحسابك في handelsregister.ai عند الربط.
- افتح إضافة ChatGPT وأضِفها في ChatGPT.
- سجّل الدخول بحسابك في handelsregister.ai وأكّد الوصول.
- اطرح سؤالك، مثلًا «من يدير Hetzner Online GmbH وكيف تطورت إيراداتها؟»
Claude وCursor وعملاء MCP الآخرون
MCP، أي Model Context Protocol، معيار مفتوح يستخدمه وكلاء الذكاء الاصطناعي للوصول إلى الأدوات ومصادر البيانات. يمكن لأي عميل يتصل بخادم MCP عبر URL استخدام خادمنا.
| ماذا | القيمة |
|---|---|
| عنوان URL للخادم |
https://mcp.handelsregister.ai/mcp |
| النقل | Streamable HTTP |
| تسجيل الدخول | OAuth بحسابك، أو مفتاح API في الـ Header x-api-key، أو Bearer token في الـ Header Authorization |
Claude
في Claude تضيف خادم MCP كموصِّل مخصص. في إعدادات الموصِّلات اختر «Add custom connector»، وأدخل اسمًا وعنوان URL للخادم، وسجّل الدخول بحسابك في handelsregister.ai. ثم فعّل الموصِّل في المحادثة عبر «+» › «Connectors».
في مساحات عمل Team وEnterprise يضيف المالك الموصِّل للجميع. ثم يربط كل عضو حسابه الخاص في handelsregister.ai.
Claude Code
في Claude Code تضيف الخادم بأمر واحد. ومع الـ Header يستخدم Claude Code مفتاح API الخاص بك.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: YOUR_API_KEY"
دون الـ Header تسجّل الدخول في المتصفح بدلًا من ذلك: ابدأ جلسة واختر الخادم تحت /mcp.
Cursor
يقرأ Cursor خوادم MCP من .cursor/mcp.json في المشروع أو من ~/.cursor/mcp.json لجميع المشاريع. وكثير من العملاء الآخرين يستخدمون الصيغة نفسها.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "YOUR_API_KEY" } } } }
عملاء MCP الآخرون
أدخل عنوان URL للخادم وأرسل مفتاح API في الـ Header x-api-key مع كل طلب. أو بدلًا من ذلك استخدم Bearer token في الـ Header Authorization؛ وتبيّن المصادقة كيف تنشئه.
الأدوات المتاحة
يقدّم خادم MCP أدوات لحسابك وملفات الشركات والأشخاص والمستندات والبحث وSignals. جميع الأدوات للقراءة فقط: لا تنشئ شيئًا ولا تغيّر أي إعدادات. وتكلّف من الأرصدة ما يكلّفه الطلب نفسه عبر الـ API.
تقبل أدوات الشركات entity_id أو اسم شركة أو محكمة السجل مع رقم السجل في المعامل q، مثل «Ansbach HRB 6089». الـ entity_id من البحث هو الأكثر موثوقية. في معظم أدوات الشركات يفعّل ai_search وضع الذكاء الاصطناعي ويفعّل realtime الوقت الفعلي.
الحساب
| الأداة | ما تُرجعه | الأرصدة |
|---|---|---|
| get_account_status | الخطة والرصيد وأقرب انتهاء لصلاحية الأرصدة والبيانات التي تفتحها خطتك. | مجانًا |
ملف الشركة
تكلّف كل أداة شركة السعر الأساسي لملف الشركة إضافةً إلى سعر ميزتها، تمامًا كما في fetch-organization. ولا تُحتسب الميزة إلا عندما تُرجع بيانات.
| الأداة | ما تُرجعه | الأرصدة |
|---|---|---|
| get_company_overview | البيانات الأساسية: الاسم والحالة والشكل القانوني والسجل والعنوان ورأس المال وغرض الشركة والقطاع. | 5 |
| get_company_snapshot | البيانات الأساسية والمؤشرات المالية الرئيسية والإدارة الحالية في استدعاء واحد. | 5 + 1 + 2 |
| get_financials | المؤشرات المالية الرئيسية لكل سنة مالية، مثل الإيرادات وصافي الدخل وعدد الموظفين. | 5 + 1 |
| get_balance_sheet | الميزانية العمومية بجميع بنودها. | 5 + 3 |
| get_profit_and_loss | قائمة الأرباح والخسائر. | 5 + 3 |
| get_annual_financial_statements | القوائم المالية السنوية بالنص الكامل بصيغة Markdown. | 5 + 5 |
| get_annual_financial_statements_html | القوائم المالية السنوية بالنص الكامل بصيغة HTML. | 5 + 5 |
| get_related_persons | الإدارة والأشخاص المسجلون الآخرون، والسابقون أيضًا إذا طلبتهم. | 5 + 2 |
| get_shareholders | الشركاء مع حصصهم. | 5 + 5 |
| get_ubos | المستفيدون الحقيقيون (UBO). | 5 + 10 |
| get_shareholdings | مشاركات الشركة في شركات أخرى. | 5 + 5 |
| get_mergers_and_acquisitions | الاندماج والاستحواذ (M&A) والاتفاقيات المؤسسية. | 5 + 20 |
| get_publications | تاريخ إعلانات السجل. | 5 + 1 |
| get_insolvency_publications | إعلانات الإعسار. | 5 + 5 |
| get_news | أخبار عن الشركة من الويب. | 5 + 10 |
| get_website_content | محتوى موقع الشركة بصيغة Markdown. تستخدم هذه الأداة وضع الذكاء الاصطناعي دائمًا. | 5 + 20 (وضع الذكاء الاصطناعي) |
| get_company_features | عدة ميزات في استدعاء واحد، بسعر أساسي واحد فقط. | 5 + الميزات |
الأشخاص والمستندات
| الأداة | ما تُرجعه | الأرصدة |
|---|---|---|
| fetch_person | ملف الشخص: مناصب الشخص ومشاركاته ومسيرته، يُبحث عنه بالاسم وبشركة مرتبطة. · بدءًا من Plus | 15، ومع المشاركات + 5 |
| fetch_document | مستند من السجل: Aktueller Abdruck (AD، المستخرج الحالي)، أو Chronologischer Abdruck (CD، المستخرج الزمني)، أو Strukturierter Registerinhalt (SI، محتوى السجل المنظّم)، أو Gesellschafterliste (قائمة الشركاء)، أو عقد التأسيس. | 15 |
البحث
تُرجع أدوات البحث حتى 30 نتيجة لكل صفحة، كلٌّ منها مع الـ entity_id الخاص بها. ثم يستخدمه وكيلك لجلب ملف الشركة.
| الأداة | ما تُرجعه | الأرصدة |
|---|---|---|
| search_organizations | اعثر على الشركات بالاسم أو بالفلاتر. | 1 لكل صفحة |
| search_organizations_advanced | البحث بجميع فلاتر الـ API والفرز، مثلًا حسب الإيرادات أو تاريخ التأسيس. | 1 لكل صفحة |
| find_companies_by_industry | الشركات في قطاع ما، موصوفًا بالكلمات أو كرمز WZ. | 1 لكل صفحة |
| find_companies_by_financials | الشركات حسب الإيرادات وعدد الموظفين وصافي الدخل وحقوق الملكية ومؤشرات أخرى. | 1 لكل صفحة |
| find_companies_near | الشركات حول موقع ما، الأقرب أولًا. | 1 لكل صفحة |
| find_newly_registered_companies | الشركات المسجلة حديثًا في فترة ما. | 1 لكل صفحة |
| find_recently_changed_companies | الشركات ذات التغييرات الحديثة، مثلًا في الإدارة أو المقر المسجل أو رأس المال. | 1 لكل صفحة |
| find_related_companies | الشركات المرتبطة عبر المشاركات أو المناصب أو الاندماجات أو الاتفاقيات المؤسسية. | 1 لكل صفحة |
| find_companies_by_person | الشركات التي يشغل فيها شخص منصبًا. البحث حسب الشريك متاح مع Pro وMax. | 1 لكل صفحة |
| find_companies_by_ownership | الشركات حسب هيكل الملكية، مثل التي يديرها مالكها أو المملوكة لعائلة. · Pro وMax | 1 لكل صفحة |
| find_companies_by_management | الشركات حسب عمر الإدارة وحجمها. · Pro وMax | 1 لكل صفحة |
| find_companies_in_insolvency | الشركات في إجراءات الإعسار، حسب المرحلة والفترة. · Pro وMax | 1 لكل صفحة |
| get_search_filter_reference | القيم المسموح بها لفلاتر البحث. | مجانًا |
| find_industry_codes | رموز WZ لقطاع موصوف بالكلمات، مثل «تطوير البرمجيات». | مجانًا |
Signals
تُرجع أدوات Signals التغييرات في السجل عبر جميع الشركات، حتى 20 لكل صفحة. وتُحتسب الصفحة حتى عندما تكون فارغة.
| الأداة | ما تُرجعه | الأرصدة |
|---|---|---|
| get_recent_new_registrations | التسجيلات الجديدة. | 20 لكل صفحة |
| get_recent_management_changes | تغييرات الإدارة. | 20 لكل صفحة |
| get_recent_capital_changes | تغييرات رأس المال. | 20 لكل صفحة |
| get_recent_master_data_changes | تغييرات البيانات الأساسية مثل الاسم أو المقر المسجل أو العنوان. | 20 لكل صفحة |
| get_recent_company_closures | الإغلاقات والحلّ. | 20 لكل صفحة |
| get_recent_insolvency_events | الإعسارات. · Pro وMax | 20 لكل صفحة |
| get_recent_mergers_and_transformations | التحويلات والاندماج والاستحواذ. · Max | 20 لكل صفحة |
| get_recent_company_changes | جميع التغييرات لما يصل إلى خمس شركات محددة. | 20 لكل صفحة |
| get_signal_details | إشارة واحدة بجميع التفاصيل. | 20 |
التكاليف
يكلّف كل استدعاء أداة من الأرصدة ما يكلّفه الطلب نفسه عبر الـ API. ولا توجد رسوم منفصلة لـ MCP. تُخصم الأرصدة من الحساب الذي سجّلت الدخول به أو الذي ينتمي إليه مفتاح API.
تنطبق القواعد نفسها التي في الـ API: الميزات دون بيانات لا تكلّف شيئًا، والاستدعاء الفاشل لا يكلّف شيئًا. يُحتسب وضع الذكاء الاصطناعي حتى دون نتيجة مطابقة، والوقت الفعلي لكل جلب مباشر ناجح. تذكر كل نتيجة الأرصدة المحتسبة في meta.request_credit_cost ورصيدك في meta.credits_remaining.
الحدود أيضًا هي نفسها التي في الـ API، للمستندات مثلًا 5 طلب في الدقيقة. المزيد تحت الفوترة والحدود.