دسترسی هوش مصنوعی · رابطهاREV. 2026-A
دستیارهای هوش مصنوعی چطور به این ویبسایت دسترسی پیدا میکنند
این ویبسایت در کنار صفحههایی که برای انسانها ساخته شده، دروازههایی برای برنامهها هم دارد. از این راه یک دستیار هوش مصنوعی میتواند ابزارهای /tools را به کار بیندازد یا قیمتهای ما را بپرسد، به جای این که صفحهها را به دنبال عددها بپالد. اینجا نوشته شده که چطور وصل شوید و حدود آن کجاست.
- بدون ثبت نام
- فقط خواندنی
- هیچ چیزی را به طور دایمی ذخیره نمیکند
آخرین بازنگری:
01 / نمای کلی
سه دروازه، همان معلوماتی که در صفحهها است
سرور MCP
/mcp
برای دستیارهایی که با Model Context Protocol کار میکنند. 54 ابزار، از پروفایل شرکت و قیمتها تا حسابگرهای /tools.
نقطۀ پایانی A2A
/a2a
برای ایجنتها مطابق پروتوکول A2A نسخۀ 1.0. این نقطه 50 ابزار /tools را اجرا میکند، با همان محاسبهای که در /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». هیچ کلید یا توکنی لازم نیست.
وقتی وصل میشوید چه اتفاق میافتد
- initialize: کلاینت بدون شناسۀ جلسه خود را معرفی میکند. جواب در هدر خود
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 است. صدا زدن یک ابزار با این شناسه؛ تایید قدم 2 (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
به اینها 50 ابزار از 51 ابزار /tools اضافه میشود (همه به جز بررسی فاکتور الکترونیکی)، هر کدام زیر نامی مانند werkzeug_email_check. آنها با همان منطق صفحه در براوزر حساب میکنند و هر جواب صفحۀ ابزار، تاریخ معلومات و حدود نتیجه را میگوید. این که یک ابزار کدام ورودیها را میخواهد، در صفحۀ خودش در بخش «برای دستیارهای هوش مصنوعی» نوشته شده است.
03 / حدود
حدود، تا این خدمت برای همه کار کند
سرور عمومی است و کاربران را نمیشناسد. به همین خاطر هزینۀ هر درخواست محدود شده و محدودیت ابزارهایی که از سرورهای دیگر معلومات میپرسند، برای همۀ درخواستها با هم حساب میشود.
| حد | مقدار | بعد چه میشود |
|---|---|---|
| اندازۀ یک درخواست | 900 KB | HTTP 413 |
| جلسههای باز MCP، همۀ کلاینتها با هم | 500 | HTTP 503 با Retry-After: 30 |
| جلسۀ MCP بدون فعالیت | 30 دقیقه | جلسه باطل میشود، کلاینت 404 میگیرد و دوباره وصل میشود. |
| وقت جواب برای هر بار صدا زدن یک ابزار /tools بدون گرفتن معلومات از انترنت، با وقت انتظار | 10 ثانیه | قطع با پیام خطای ابزار |
| بررسی ایمیل | 30 بررسی در هر دقیقه، 300 بررسی نو DNS در هر ساعت | ابزار میخواهد که بعداً دوباره کوشش کنید. |
| بررسی خدمات شرکتهای دیگر، خزندههای هوش مصنوعی و پیشنمایش لینک | هر کدام 20 بررسی در هر دقیقه، هر کدام 150 بررسی نو در هر ساعت | مانند بررسی ایمیل |
| حسابگر Gas با مقدارهای زنده | فیسها حد اکثر یک بار در هر دقیقه دوباره پرسیده میشوند | جواب با مقدارهای دقیقۀ آخر؛ بدون مقدارهای زنده با معلومات ثابت صفحه و یک نکته |
نتیجهای که هنوز در حافظۀ موقت است (پنج دقیقه برای هر دومین یا آدرس)، در سقف بررسیهای هر ساعت حساب نمیشود. اگر خود ابزار خطایی بدهد (محدودیت، حد وقت، ورودی نادرست)، آن خطا به آلمانی در فیلد fehler جواب نوشته میشود. ورودیهایی را که با ساختار مطابقت ندارند، /a2a با خطای JSON-RPC -32602 رد میکند و /mcp با یک جواب خطا از MCP-SDK.
04 / A2A
صدا زدن ابزارها از راه پروتوکول A2A
- نقطۀ پایانی (Endpoint)
- https://aureum-tech.com/a2a
- پروتوکول
- A2A 1.0 از راه JSON-RPC 2.0
- هدر
- 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"
}]
}
}
}'
- پیامی که فقط متن دارد، لست ابزارها را با فیلدهای ورودی آنها میدهد. اگر متن نام یک ابزار را بگوید، معلومات کامل همان ابزار با سوالهای نمونه میآید.
- ایجنت طبق قاعدههای ثابت کار میکند و زبان آزاد را نمیفهمد.
- ایجنت هیچ کاری (Task) نمیسازد و چیزی ذخیره نمیکند. هر جواب یک پیام مستقیم است، به همین خاطر
ListTasksیک لست خالی میدهد. - Streaming و اطلاعیههای Push ندارد و فایل قبول نمیکند.
- اگر هدر
A2A-Version: 1.0نباشد، با خطای -32009 جواب میدهد: مشخصات پروتوکول نبودن این معلومات را نسخۀ 0.3 حساب میکند.
چهار ابزار پروفایل شرکت، خدمات، قیمتها و جستجو فقط از راه /mcp موجود است. برای /a2a همان حد اندازۀ درخواست، همان حد وقت و همان محدودیتها اعتبار دارد. توضیح برای برنامهها در 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 را دارد. فهرست رهنما و مقالههای تخصصی سیستم نشر از این قاعده بیرون هستند: هر دو تنها هنگام باز شدن پر میشوند و آنجا HTML میآید. متن این صفحهها را در یک فایل /llms-full.txt میدهد.
06 / فایلهای توضیحی
برنامهها کجا میخوانند که چه موجود است
این فایلها دروازهها را در شکلهایی توضیح میدهند که ایجنتها و برنامههای بررسی خودشان میپالند. صفحۀ اصلی در هدر Link جواب خود به فهرست API، توضیح OpenAPI و همین صفحه اشاره میکند.
- /.well-known/api-catalogفهرست API مطابق RFC 9727. برای /mcp و /a2a توضیح را، این صفحه را به عنوان مستندسازی و برای /mcp پرسش وضعیت را نام میبرد.
- /openapi.jsonOpenAPI 3.1: رابط HTTP نقطۀ پایانی MCP.
- /.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قاعدهها برای خزندهها (Crawler). همه اجازه دارند و خزندههای شناختهشدۀ هوش مصنوعی جدا جدا در آن نوشته شدهاند.
07 / محرمیت معلومات
با ورودیها چه میشود
صدا زدن از راه /mcp یا /a2a ورودیها را به سرور ما میفرستد. سرور با آنها حساب میکند و نتیجه را پس میدهد، بدون این که ورودیها یا نتیجه را به طور دایمی ذخیره کند. تنها نتیجههای بررسیهای انترنتی همراه با دومین یا آدرس بررسیشده حد اکثر شش دقیقه بدون ارتباط با کسی که درخواست داده در حافظۀ کاری میماند. مانند هر بار باز کردن صفحه، تنها خود درخواست بدون محتوای آن ثبت میشود. این که دستیار با معلومات شما چه میکند، به عهدۀ شرکت ارائهکنندۀ آن است (جزئیات در پالیسی محرمیت).
08 / برای شرکت شما
چنین دسترسی برای سیستمهای خود شما
آنچه این ویبسایت برای معلومات خودش پیشنهاد میکند، برای شرکتها هم میسازیم: یک سرور MCP که از راه آن یک دستیار هوش مصنوعی به سیستم مدیریت اجناس یا یک دیتابیس دسترسی دارد، با اجازههایی که شما پیش از آن تعیین میکنید. این که ما چطور کار میکنیم، در صفحۀ ادغام MCP نوشته شده است.
دیدن ادغام MCP