دسترسی هوش مصنوعی · رابطها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: سرور همه ابزارها را با توضیح و ساختار ورودی (schema) فهرست میکند.
- 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 پاسخ میآید. ورودیهایی را که با schema جور نیستند، /a2a با خطای JSON-RPC -32602 رد میکند و /mcp با پاسخ خطای MCP-SDK.
04 / A2A
فراخوانی ابزارها از طریق پروتکل A2A
- نقطه اتصال
- 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فهرست خالی برمیگرداند. - استریم و اعلان 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قواعد برای خزندهها. همه مجازند و خزندههای شناختهشده هوش مصنوعی تکتک در آن آمدهاند.
07 / حریم خصوصی
با ورودیها چه میشود
فراخوانی از طریق /mcp یا /a2a ورودیها را به سرور ما میفرستد. سرور با آنها محاسبه میکند و نتیجه را برمیگرداند، بیآنکه ورودی یا نتیجه را برای همیشه ذخیره کند. فقط نتیجه بررسیهای شبکه، همراه با دامنه یا آدرس بررسیشده، حداکثر شش دقیقه و بدون ارتباط با فراخوانکننده در حافظه میماند. مثل هر بازدید صفحه، فقط خود درخواست بدون محتوایش ثبت میشود، و اینکه دستیار با اطلاعات شما چه میکند را ارائهدهنده آن تعیین میکند (جزئیات در سیاست حریم خصوصی).
08 / برای کسبوکار شما
چنین دسترسیای برای سیستمهای خودتان
همان چیزی که این سایت برای دادههای خودش ارائه میدهد، برای کسبوکارها هم میسازیم: یک سرور MCP که دستیار هوش مصنوعی از طریق آن به نرمافزار انبار و فروش یا یک پایگاه داده دسترسی پیدا میکند، با دسترسیهایی که شما از قبل تعیین میکنید. روش کار ما در صفحه یکپارچهسازی با MCP آمده است.
دیدن یکپارچهسازی با MCP