Gihîştina AI · Navrû (interface)REV. 2026-A
Alîkarên AI çawa digihîjin vê malperê
Ji xeynî rûpelên ji bo mirovan, vê malperê deriyên ji bo bernameyan jî hene. Bi wan alîkarekî AI dikare amûrên /tools bide xebitandin an bihayên me bipirse, li şûna ku di rûpelan de li hejmaran bigere. Li vir tê ravekirin ka meriv çawa girê dide û sînor li ku ne.
- bê qeydkirin
- tenê xwendin
- tiştekî bi domdarî tomar nake
Nûkirina dawî:
01 / NÊRÎNA GIŞTÎ
Sê derî, heman dane wek li ser rûpelan
Servera MCP
/mcp
Ji bo alîkarên ku bi Model Context Protocol diaxivin. 54 amûr, ji profîla şîrketê û bihayan heta hesabkerên /tools.
Xala girêdanê ya A2A
/a2a
Ji bo ajanên (agent) li gorî protokola A2A 1.0. 50 amûrên /tools dixebitîne, bi heman hesabê wek /mcp.
Markdown
Accept: text/markdown
Heke bernameyek bixwaze, rûpel nivîsa xwe wek Markdown dide. Gerok (browser) hê jî HTML distînin.
Her sê ji heman çavkaniyan dixwînin wek malperê. Daneyên bingehîn, lîsteya bihayan û hesabê amûran li tu deran du caran nayên nûkirin: Heke bihayê saetekê biguhere, piştî weşana din ew hem li ser /preise hem jî di bersiva servera MCP de xuya dibe.
02 / SERVERA MCP
Girêdana servera MCP
- Navnîşan
- https://aureum-tech.com/mcp
- Transport
- Streamable HTTP, JSON-RPC 2.0 bi POST
- Qeydkirin
- tune
- Gihîştin
- tenê xwendin
Klientekî MCP ku serveran bi navnîşanê li ser Streamable HTTP girê dide, tenê pêwîstiya wî bi vê navnîşanê heye. Navê rast ê qeydê di rêbera klientê we de ye. Gelek klient mîhengekî bi vî rengî dixwazin:
{
"mcpServers": {
"aureum-website": {
"url": "https://aureum-tech.com/mcp"
}
}
}
Hin klient dixwazin ku transport jî were nivîsandin, bi piranî wek "http" an "streamable-http". Mifte an token ne lazim e.
Di girêdanê de çi diqewime
- initialize: Klient bê nasnameya rûniştinê (session) xwe qeyd dike. Di serê bersivê de
Mcp-Session-Idheye, û klient vê nasnameyê bi her daxwaza din re dişîne. - notifications/initialized: Klient piştrast dike ku qeydkirin qediya.
- tools/list: Server hemû amûran bi danasîn û şemaya têketinê dibêje.
- tools/call: Klient amûrekê bi têketinên wê bang dike. Encam wek JSON di qada nivîsê ya bersivê de tê.
Qeydkirin bi dest wiha xuya dike, mînak ji bo ceribandinê di terminalê de:
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"}}}'
Bersiv wek herikîna bûyeran (text/event-stream) tê, nasname di rêza serê de ye: mcp-session-id. Bangkirina amûrekê bi vê nasnameyê; piştrastkirina gava duyem (notifications/initialized) li vir ji bo kurtiyê nehatiye nivîsandin, klient wê berê dişîne:
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"}}}'
Kesê ku /mcp di gerokê de veke, GET dişîne û peyama "Nur POST (JSON-RPC)" (tenê POST) distîne. Ev bersiva rast e, ne arîze ye. Ka server dixebite an na, /mcp/health nîşan dide.
Kîjan amûr hene
Çar amûr bersiva pirsên li ser me didin:
firma_und_kontakt: profîla şîrketê bi navnîşan, telefon, saetên kar û daneyên qeydêleistungen_auflisten: hemû beşên xizmetê, her yek bi rûpela xwepreise_abfragen: bihayê saetê, heqê hatinê û pereyên zêde (Zuschläge), ji heman çavkaniyê wek lîsteya bihayanwebsite_suchen: lêgerîn di hemû rûpelên aureum-tech.com de
Wekî din 50 ji 51 amûrên /tools jî hene (hemû ji bilî kontrola fatûreya elektronîk), her yek bi navekî wek werkzeug_email_check. Ew bi heman mantiqê wek rûpela di gerokê de hesab dikin, û her bersiv rûpela amûrê, rewşa daneyan û sînorên encamê dibêje. Amûrek kîjan têketinan dixwaze, li ser rûpela wê di beşa "Für KI-Assistenten" (Ji bo alîkarên AI) de ye.
03 / SÎNOR
Sînor, da ku xizmet ji bo herkesî bixebite
Server giştî ye û bikarhêneran nas nake. Ji ber vê yekê lêçûna her daxwazê sînorkirî ye, û frenên amûrên ku serverên din dipirsin ji bo hemû bangan bi hev re derbas dibin.
| Sînor | Nirx | Wê demê çi dibe |
|---|---|---|
| Mezinahiya daxwazekê | 900 KB | HTTP 413 |
| Rûniştinên MCP yên vekirî, hemû klient bi hev re | 500 | HTTP 503 bi Retry-After: 30 |
| Rûniştina MCP bê çalakî | 30 deqe | Rûniştin diqede, klient 404 distîne û ji nû ve xwe qeyd dike. |
| Dema bersivê ji bo her bangkirina amûrekê ji /tools bê daxwaza torê, bi dema li bendê re | 10 çirke | Rawestandin bi peyama xeletiyê ya amûrê |
| Kontrola e-mailê | Di deqeyekê de 30 kontrol, di saetekê de 300 kontrolên DNS yên nû | Amûr dixwaze ku hûn paşê dîsa biceribînin. |
| Kontrola aliyên sêyem, kontrola crawlerên AI û kontrola pêşdîtina lînkê | her yek 20 kontrol di deqeyekê de, her yek 150 kontrolên nû di saetekê de | wek di kontrola e-mailê de |
| Hesabkera gas bi nirxên zindî | Lêçûn herî zêde deqeyê carekê ji nû ve tên pirsîn | Bersiv bi nirxên deqeya dawî; bê nirxên zindî bi rewşa sabît a rûpelê û agahiyekê |
Encamek ku hê di bîra demkî (cache) de ye (pênc deqe ji bo her domain an navnîşanê), di sînorê saetê de nayê hesibandin. Heke amûrek bi xwe xeletiyekê ragihîne (fren, sînorê demê, têketina ne guncav), ew bi almanî di qada fehler ya bersivê de ye. Têketinên ku li şemayê nayên, /a2a bi xeletiya JSON-RPC -32602 red dike û /mcp bi bersiveke xeletiyê ya MCP-SDK.
04 / A2A
Bangkirina amûran bi protokola A2A
- Xala girêdanê (endpoint)
- https://aureum-tech.com/a2a
- Protokol
- A2A 1.0 bi JSON-RPC 2.0
- Rêza serê (header)
- A2A-Version: 1.0
- Rêbaz (method)
- SendMessage
Ajanên ku bi protokola A2A diaxivin, heman 50 amûran bi /a2a bang dikin. Peyamek bi beşeke daneyan {"werkzeug": "…", "eingabe": {…}} amûrekê dixebitîne, û bersiv heman encamê dide wek /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"
}]
}
}
}'
- Peyamek tenê bi nivîsê lîsteya amûran bi qadên têketinê dide. Heke nivîs navê amûrekê bibêje, hemû agahiyên wê bi pirsên mînak tên.
- Ajan li gorî rêgezên sabît dixebite û zimanê azad fêm nake.
- Ew karan (tasks) çênake û tiştekî tomar nake. Her bersiv peyameke rasterast e, ji ber vê yekê
ListTaskslîsteyeke vala dide. - Streaming û agahdariyên push pêşkêş nake, dosyayan qebûl nake.
- Heke rêza serê
A2A-Version: 1.0tune be, ew bi xeletiya -32009 bersiv dide: Taybetmendî (specification) nebûna wê wek guhertoya 0.3 dixwîne.
Çar amûrên li ser profîla şîrketê, xizmet, biha û lêgerînê tenê bi /mcp hene. Ji bo /a2a heman sînorê mezinahiyê, heman sînorê demê û heman fren derbas dibin. Danasîna ji bo bernameyan di Agent Card de ye.
05 / MARKDOWN
Rûpel wek Markdown
Kesê ku rûpelekê bi rêza serê Accept: text/markdown bixwaze, li şûna HTML nivîsa wê wek Markdown distîne, bê menû û skrîpt. Gerok vê daxwazê qet naşînin û rûpelê wek her car dibînin. Guherto di dema avakirina malperê de ji rûpelên amade çêdibin, ji ber vê yekê ew bi qasî wan nû ne.
curl -H "Accept: text/markdown" https://aureum-tech.com/preise
Bersiv Content-Type: text/markdown; charset=utf-8 û Vary: Accept bi xwe re tîne. Ev ji bo nêrîna giştî ya rêberan û gotarên pispor ên ji pergala edîtoriyê derbas nabe: Her du jî tenê di dema xwestinê de tên dagirtin, li wir hê jî HTML tê. Nivîsa van rûpelan di dosyayekê de /llms-full.txt dide.
06 / DOSYAYÊN DANASÎNÊ
Bername li ku dixwînin ka çi heye
Ev dosya deriyan bi formatên ku ajan û bernameyên kontrolê bi xwe lê digerin, diyar dikin. Rûpela destpêkê di serê girêdanê (Link header) ya bersiva xwe de nîşanî kataloga API, danasîna OpenAPI û vê rûpelê dide.
- /.well-known/api-catalogKataloga API li gorî RFC 9727. Ji bo /mcp û /a2a danasînê, vê rûpelê wek belgekirin û ji bo /mcp pirsîna rewşê dibêje.
- /openapi.jsonOpenAPI 3.1: navrûya HTTP ya xala girêdanê ya MCP.
- /.well-known/mcp/server-card.jsonMCP Server Card bi navnîşan, transport û lîsteya amûran a servera MCP.
- /.well-known/agent-card.jsonA2A Agent Card: xala girêdanê, guhertoya protokolê û şiyanên ajanê A2A.
- /.well-known/agent-skills/index.jsonLîsteya Agent Skills. Tê de du rêber ji bo ajanan hene: bikaranîna amûran bi MCP û amadekirina daxwaza xizmetê ji bo mirovekî.
- /llms.txtKurteya malperê ji bo modelên zimanî, bi rûpelên girîng.
- /llms-full.txtNivîsa rûpelan di dosyayekê de.
- /auth.mdRêbera qeydkirinê ji bo ajanan. Ew berî her tiştî dibêje ku li vir qeydkirin tune ye.
- /robots.txtRêgez ji bo crawleran. Destûr ji bo hemûyan heye; crawlerên AI yên naskirî yek bi yek tê de ne.
07 / PARASTINA DANEYAN
Bi têketinan çi dibe
Bangkirinek bi /mcp an /a2a têketinan dişîne serverê me, ku pê hesab dike û encamê vedigerîne, bêyî ku têketin an encamê bi domdarî tomar bike. Tenê encamên kontrolên torê bi domain an navnîşana kontrolkirî re herî zêde şeş deqe, bê girêdana bi bangker re, di bîra xebatê (RAM) de dimînin. Wek di her vekirina rûpelê de tenê daxwaz bê naveroka wê tê nivîsandin, û ka alîkar bi xwe bi agahiyên we çi dike, pêşkêşkerê wî diyar dike (hûrgilî di daxuyaniya parastina daneyan (Datenschutzerklärung) de).
08 / JI BO ŞÎRKETA WE
Gihîştineke wiha ji bo pergalên we
Tiştê ku ev malper ji bo daneyên xwe pêşkêş dike, em ji bo şîrketan jî çêdikin: serverekî MCP ku pê alîkarekî AI digihîje pergala depoyê an databasekê, bi mafên ku hûn berê diyar dikin. Em çawa dixebitin, li ser rûpela entegrasyonên MCP heye.
Entegrasyonên MCP bibînin