AI لاسرسی · انټرفېسونهنسخه 2026-A
AI مرستیالان دې وېب سایټ ته څنګه لاسرسی مومي
د خلکو لپاره له پاڼو سربېره، دا وېب سایټ د پروګرامونو لپاره هم دروازې لري. یو AI مرستیال له دې لارې کولای شي د /tools اوزار محاسبه وکړي یا زموږ بیې وپوښتي، پرته له دې چې په پاڼو کې د شمېرو پسې وګرځي. دلته لیکل شوي چې څنګه وصل شئ او حدود یې چېرته دي.
- له نوم لیکنې پرته
- یوازې لوستل
- هېڅ شی د تل لپاره نه ساتي
تازه حالت
01 / لنډه کتنه
درې دروازې، هماغه ډېټا چې په پاڼو کې ده
MCP سرور
/mcp
د هغو مرستیالانو لپاره چې Model Context Protocol کاروي. 54 اوزار، د شرکت له پروفایل او بیو نیولې د /tools تر محاسبو پورې.
A2A اېنډپواینټ
/a2a
د A2A 1.0 پروتوکول د اجنټانو لپاره. له /tools څخه 50 اوزار چلوي، د /mcp په څېر په هماغه محاسبه.
Markdown
Accept: text/markdown
که یو پروګرام یې وغواړي، پاڼه خپل متن د Markdown په بڼه ورکوي. براوزرونه لا هم HTML ترلاسه کوي.
درې واړه له هماغو سرچینو لولي چې وېب سایټ یې لولي. اساسي معلومات، د بیو پاڼه او د اوزارو محاسبه په هېڅ ځای دوه ځله نه ساتل کېږي: که د ساعت بیه بدله شي، له راتلونکې خپرونې وروسته په یو وخت په /preise او د MCP سرور په ځواب کې ښکاري.
02 / MCP سرور
MCP سرور وصل کړئ
- پته
- https://aureum-tech.com/mcp
- ټرانسپورټ
- Streamable HTTP، JSON-RPC 2.0 د POST له لارې
- نوم لیکنه
- هېڅ
- لاسرسی
- یوازې لوستل
هغه MCP کلاینټ چې سرورونه د پتې له مخې د Streamable HTTP له لارې نښلوي، یوازې همدې پتې ته اړتیا لري. دا تنظیم باید دقیقاً څنګه ولیکل شي، ستاسو د کلاینټ په لارښود کې راغلي. ډېری کلاینټونه د دې ډول تنظیم تمه لري:
{
"mcpServers": {
"aureum-website": {
"url": "https://aureum-tech.com/mcp"
}
}
}
ځینې کلاینټونه غواړي چې ټرانسپورټ هم ورته وښودل شي، معمولاً د «http» یا «streamable-http» په بڼه. کلي (key) یا ټوکن ته اړتیا نشته.
کله چې وصل شئ څه کېږي
- initialize: کلاینټ د ناستې له پېژند پرته نوم لیکنه کوي. ځواب په سرلیک (header) کې
Mcp-Session-Idلري، او کلاینټ دا پېژند له هرې بلې غوښتنې سره لېږي. - notifications/initialized: کلاینټ تاییدوي چې نوم لیکنه بشپړه شوه.
- tools/list: سرور ټول اوزار له تشریح او د ننوتنو له سکیما سره ښيي.
- tools/call: کلاینټ یوه وسیله له خپلو ننوتنو سره رابلي. پایله د ځواب په متني ساحه کې د JSON په بڼه راځي.
نوم لیکنه په لاس داسې ښکاري، د بېلګې په توګه په ټرمینل کې د ازمویلو لپاره:
curl -i https://aureum-tech.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"test","version":"1.0"}}}'
ځواب د پېښو د جریان (text/event-stream) په بڼه راځي، پېژند په سرلیک mcp-session-id کې دی. له دې پېژند سره د وسیلې رابلل؛ د دویم ګام تایید (notifications/initialized) دلته د لنډیز لپاره پرېښودل شوی، کلاینټ یې مخکې لېږي:
curl https://aureum-tech.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Session-Id: <Kennung aus der ersten Antwort>" \
-H "MCP-Protocol-Version: 2025-06-18" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
"name":"preise_abfragen","arguments":{"zielgruppe":"firma"}}}'
څوک چې /mcp په براوزر کې پرانیزي، GET لېږي او دا پیغام ترلاسه کوي: «Nur POST (JSON-RPC)». دا سم ځواب دی، خرابي نه ده. چې سرور چلېږي که نه، /mcp/health یې ښيي.
کوم اوزار شته
څلور اوزار زموږ په اړه پوښتنو ته ځواب ورکوي:
firma_und_kontakt: د شرکت پروفایل له پتې، ټلیفون، د اړیکې وخت او د ثبت معلوماتو سرهleistungen_auflisten: د خدمتونو ټولې برخې، هره یوه له خپلې پاڼې سرهpreise_abfragen: د ساعت بیې، راتګ او اضافي لګښتونه، له هماغې سرچینې چې د بیو پاڼه ترې جوړېږيwebsite_suchen: د aureum-tech.com په ټولو پاڼو کې لټون
سربېره پر دې، د /tools له 51 اوزارو څخه 50 هم شته (ټول پرته د برېښنايي بل (E-Rechnung) له چېک څخه)، او هر یو د werkzeug_email_check په څېر یو نوم لري. دوی د براوزر د پاڼې په څېر په هماغه منطق محاسبه کوي، او هر ځواب د وسیلې پاڼه، د ډېټا تازه حالت او د پایلې حدود ښيي. چې یوه وسیله کومې ننوتنې غواړي، د هغې په پاڼه کې د «د AI مرستیالانو لپاره» په برخه کې لیکل شوي.
03 / حدود
حدود، څو خدمت د ټولو لپاره وچلېږي
سرور عام دی او کاروونکي نه پېژني. له همدې امله د هرې غوښتنې لګښت محدود دی، او د هغو اوزارو د غوښتنو محدودیتونه چې بهرني سرورونه پوښتي، د ټولو رابللو لپاره ګډ پلي کېږي.
| حد | ارزښت | بیا څه کېږي |
|---|---|---|
| د یوې غوښتنې اندازه | 900 KB | HTTP 413 |
| خلاصې MCP ناستې، ټول کلاینټونه یوځای | 500 | HTTP 503 له Retry-After: 30 سره |
| بې فعالیته MCP ناسته | 30 دقیقې | ناسته پای ته رسېږي، کلاینټ 404 ترلاسه کوي او بیا نوم لیکنه کوي. |
| د /tools د یوې وسیلې د هر رابللو د ځواب وخت، له شبکې غوښتنې پرته، د انتظار وخت په شمول | 10 ثانیې | د وسیلې د تېروتنې له پیغام سره درېږي |
| د ایمېل چېک | په یوه دقیقه کې 30 ازموینې، په یوه ساعت کې 300 نوې DNS ازموینې | وسیله غوښتنه کوي چې وروسته بیا هڅه وکړئ. |
| د درېیمګړو خدمتونو، AI کرالرونو او د لینک مخکتنې چېک | هر یو په یوه دقیقه کې 20 ازموینې، هر یو په یوه ساعت کې 150 نوې ازموینې | لکه د ایمېل په چېک کې |
| د Gas محاسبه ګر له ژوندیو ارزښتونو سره | فیسونه په یوه دقیقه کې تر یو ځل زیات نه بیا پوښتل کېږي | ځواب د وروستۍ دقیقې له ارزښتونو سره؛ که ژوندي ارزښتونه نه وي، د پاڼې له ثابت حالت او یوې یادونې سره |
هغه پایله چې لا په لنډمهاله حافظه (cache) کې ده (د هر ډومېن یا پتې لپاره پنځه دقیقې)، د ساعت په حد کې نه شمېرل کېږي. که یوه وسیله پخپله تېروتنه وښيي (د غوښتنو محدودیت، د وخت حد، ناسمه ننوتنه)، دا د ځواب په fehler ساحه کې په جرمني ژبه لیکل کېږي. هغه ننوتنې چې له سکیما سره سمون نه خوري، /a2a یې د JSON-RPC د -32602 تېروتنې سره ردوي او /mcp یې د MCP-SDK د تېروتنې له ځواب سره.
04 / A2A
د A2A پروتوکول له لارې اوزار رابلل
- اېنډپواینټ
- https://aureum-tech.com/a2a
- پروتوکول
- A2A 1.0 د JSON-RPC 2.0 له لارې
- سرلیک (Header)
- A2A-Version: 1.0
- مېتود
- SendMessage
هغه اجنټان چې A2A پروتوکول کاروي، همدا 50 اوزار د /a2a له لارې رابلي. یو پیغام چې د ډېټا برخه {"werkzeug": "…", "eingabe": {…}} ولري یوه وسیله چلوي، او ځواب یې هماغه پایله لري لکه /mcp:
curl https://aureum-tech.com/a2a \
-H "Content-Type: application/json" \
-H "A2A-Version: 1.0" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "SendMessage",
"params": {
"message": {
"messageId": "9b2f6c1e-4d1a-4c3b-8e55-0a7d2f3b1c90",
"role": "ROLE_USER",
"parts": [{
"data": {
"werkzeug": "werkzeug_email_check",
"eingabe": { "domain": "ihre-firma.de" }
},
"mediaType": "application/json"
}]
}
}
}'
- یوازې متني پیغام د اوزارو لېست له ننوتنې ساحو سره ورکوي. که متن د یوې وسیلې نوم واخلي، د هغې بشپړ معلومات له بېلګه پوښتنو سره راځي.
- اجنټ د ثابتو قواعدو له مخې کار کوي او آزاده ژبه نه پوهېږي.
- هغه دندې (Tasks) نه جوړوي او هېڅ نه ساتي. هر ځواب مستقیم پیغام دی، له همدې امله
ListTasksتش لېست ورکوي. - Streaming او Push خبرتیاوې نه وړاندې کوي، او فایلونه نه مني.
- که سرلیک
A2A-Version: 1.0نه وي، د -32009 تېروتنې سره ځواب ورکوي: مشخصات نشتوالی د 0.3 نسخې په توګه لولي.
د شرکت پروفایل، خدمتونو، بیو او لټون څلور اوزار یوازې د /mcp له لارې شته. د /a2a لپاره هماغه د غوښتنې د بدن (body) حد، هماغه د وخت حد او هماغه د غوښتنو محدودیتونه پلي کېږي. د پروګرامونو لپاره تشریح په Agent Card کې ده.
05 / Markdown
پاڼې د Markdown په بڼه
څوک چې یوه پاڼه د Accept: text/markdown سرلیک سره وغواړي، د HTML پر ځای یې متن د Markdown په بڼه ترلاسه کوي، له مېنو او سکریپټونو پرته. براوزرونه دا سرلیک هېڅکله نه لېږي او پاڼه د تل په څېر ویني. دا نسخې د وېب سایټ د جوړولو پر مهال له بشپړو پاڼو جوړېږي، نو هومره تازه دي لکه پاڼې پخپله.
curl -H "Accept: text/markdown" https://aureum-tech.com/preise
ځواب Content-Type: text/markdown; charset=utf-8 او Vary: Accept لري. استثنا یې د لارښود لړلیک او د منځپانګې د مدیریت له سیستم (CMS) څخه مسلکي لیکنې دي: دواړه یوازې د غوښتنې پر مهال ډکېږي، هلته لا هم HTML راځي. د دې پاڼو متن په یوه فایل کې /llms-full.txt ورکوي.
06 / د تشریح فایلونه
پروګرامونه چېرته ګوري چې څه شته
دا فایلونه دروازې په هغو بڼو تشریح کوي چې اجنټان او د ازموینې پروګرامونه یې پخپله لټوي. کورپاڼه د خپل ځواب په Link سرلیک کې API کتلاګ، OpenAPI تشریح او دې پاڼې ته اشاره کوي.
- /.well-known/api-catalogAPI کتلاګ د RFC 9727 له مخې. دا د /mcp او /a2a لپاره تشریح، دا پاڼه د اسنادو په توګه، او د /mcp لپاره د حالت پوښتنه ښيي.
- /openapi.jsonOpenAPI 3.1: د MCP اېنډپواینټ HTTP انټرفېس.
- /.well-known/mcp/server-card.jsonMCP Server Card د MCP سرور له پتې، ټرانسپورټ او د اوزارو له لېست سره.
- /.well-known/agent-card.jsonA2A Agent Card: د A2A اجنټ اېنډپواینټ، د پروتوکول نسخه او وړتیاوې.
- /.well-known/agent-skills/index.jsonد Agent Skills لړلیک. په کې د اجنټانو لپاره دوه لارښوونې دي: د MCP له لارې د اوزارو کارول، او د یو انسان لپاره د خدمت غوښتنې چمتو کول.
- /llms.txtد ژبې ماډلونو لپاره د وېب سایټ لنډیز، له مهمو پاڼو سره.
- /llms-full.txtد پاڼو متن په یوه فایل کې.
- /auth.mdد اجنټانو لپاره د نوم لیکنې لارښود. تر ټولو مهمه خبره یې دا ده چې دلته نوم لیکنه نشته.
- /robots.txtد کرالرونو لپاره قواعد. ټولو ته اجازه ده، پېژندل شوي AI کرالرونه په کې یو یو لیکل شوي.
07 / د ډېټا ساتنه
ستاسو په ننوتنو څه کېږي
د /mcp یا /a2a له لارې رابلل ننوتنې زموږ سرور ته لېږي، چې محاسبه پرې کوي او پایله بېرته ورکوي، پرته له دې چې ننوتنې یا پایله د تل لپاره وساتي. یوازې د شبکې د ازموینو پایلې، له ازمویل شوي ډومېن یا پتې سره، تر شپږو دقیقو پورې په کاري حافظه کې پاتې کېږي، له رابلونکي سره له تړاو پرته. لکه د هرې پاڼې د خلاصولو په څېر، یوازې غوښتنه له منځپانګې پرته ثبتېږي، او هغه څه چې مرستیال پخپله ستاسو له معلوماتو سره کوي، د هغه وړاندې کوونکی یې ټاکي (جزییات په د محرمیت تګلارې کې).
08 / ستاسو د کاروبار لپاره
همداسې لاسرسی ستاسو د خپلو سیستمونو لپاره
هغه څه چې دا وېب سایټ د خپلې ډېټا لپاره وړاندې کوي، موږ یې د کاروبارونو لپاره هم جوړوو: یو MCP سرور چې له لارې یې یو AI مرستیال د توکو مدیریت (Warenwirtschaft) سیستم یا ډېټابېس ته لاسرسی مومي، د هغو اجازو سره چې تاسو یې مخکې ټاکئ. چې موږ څنګه کار کوو، د MCP نښلونو په پاڼه کې لیکل شوي.
MCP نښلونې وګورئ