Truy cập cho AI · Giao diện kết nốiREV. 2026-A

Trợ lý AI truy cập website này như thế nào

Ngoài các trang dành cho người đọc, website này còn có cổng dành cho phần mềm. Qua đó, trợ lý AI có thể cho chạy các công cụ trong /tools hoặc hỏi giá của chúng tôi, thay vì phải lục từng trang để tìm con số. Trang này hướng dẫn cách kết nối và cho biết các giới hạn.

  • không cần đăng ký
  • chỉ đọc
  • không lưu gì lâu dài

Cập nhật

Ba cổng vào, cùng dữ liệu như trên các trang

Máy chủ MCP

/mcp

Dành cho trợ lý dùng Model Context Protocol. 54 công cụ, từ hồ sơ công ty và bảng giá đến các công cụ tính trong /tools.

Endpoint A2A

/a2a

Dành cho agent theo giao thức A2A 1.0. Chạy 50 công cụ trong /tools, với cách tính giống hệt /mcp.

Markdown

Accept: text/markdown

Khi một phần mềm yêu cầu, trang sẽ trả nội dung dưới dạng Markdown. Trình duyệt vẫn nhận HTML như bình thường.

GỌI CÔNG CỤTRỢ LÝ AI/mcp HOẶC /a2aTÍNH GIỐNGTRANG /toolsTRẢ LỜI KÈMNGUỒNĐỌC TRANGAGENTTRANGCHỮ DẠNG MARKDOWNGỌI CÔNG CỤTRỢ LÝ AI/mcp HOẶC /a2aTÍNH GIỐNG TRANG /toolsTRẢ LỜI KÈM NGUỒNĐỌC TRANGAGENTTRANGCHỮ DẠNG MARKDOWN
HÌNH 1 · HAI ĐƯỜNG ĐẾN CÙNG MỘT DỮ LIỆUVÀNG = CỔNG DÀNH CHO PHẦN MỀM

Cả ba đều đọc từ cùng nguồn với website. Thông tin công ty, bảng giá và cách tính của các công cụ không được duy trì hai nơi: khi giá theo giờ thay đổi, sau lần cập nhật kế tiếp, giá mới sẽ có cùng lúc trên /preise và trong câu trả lời của máy chủ MCP.

Kết nối máy chủ MCP

Địa chỉ
https://aureum-tech.com/mcp
Phương thức truyền
Streamable HTTP, JSON-RPC 2.0 qua POST
Xác thực
không có
Truy cập
chỉ đọc

Một MCP client có thể thêm máy chủ bằng địa chỉ qua Streamable HTTP chỉ cần đúng địa chỉ này. Mục cấu hình tên là gì thì xem hướng dẫn của client anh chị dùng. Nhiều client mong đợi một cấu hình như sau:

{
  "mcpServers": {
    "aureum-website": {
      "url": "https://aureum-tech.com/mcp"
    }
  }
}

Một số client yêu cầu khai báo thêm phương thức truyền, thường là “http” hoặc “streamable-http”. Không cần khóa hay token.

Điều gì xảy ra khi kết nối

  1. initialize: Client đăng ký kết nối mà chưa có mã phiên. Header của câu trả lời chứa Mcp-Session-Id, và client gửi kèm mã này trong mọi yêu cầu sau đó.
  2. notifications/initialized: Client xác nhận việc đăng ký đã hoàn tất.
  3. tools/list: Máy chủ liệt kê tất cả công cụ, kèm mô tả và lược đồ đầu vào.
  4. tools/call: Client gọi một công cụ cùng dữ liệu đầu vào. Kết quả trả về dạng JSON trong trường văn bản của câu trả lời.

Đăng ký kết nối làm bằng tay trông như sau, ví dụ để thử trong terminal:

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"}}}'

Câu trả lời đến dưới dạng luồng sự kiện (text/event-stream), mã phiên nằm trong header mcp-session-id. Một lần gọi công cụ kèm mã này; xác nhận ở bước 2 (notifications/initialized) được bỏ qua ở đây cho gọn, còn client thật sẽ gửi nó trước:

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"}}}'

Ai mở /mcp trong trình duyệt là gửi một yêu cầu GET và nhận thông báo “Nur POST (JSON-RPC)” (chỉ chấp nhận POST). Đó là câu trả lời đúng, không phải sự cố. Máy chủ có đang chạy hay không, xem tại /mcp/health.

Có những công cụ nào

Bốn công cụ trả lời các câu hỏi về chúng tôi:

  • firma_und_kontakt: hồ sơ công ty gồm địa chỉ, điện thoại, giờ liên lạc và thông tin đăng ký thương mại
  • leistungen_auflisten: tất cả các mảng dịch vụ, mỗi mảng kèm trang tương ứng
  • preise_abfragen: giá theo giờ, phí đi lại và phụ phí, lấy từ cùng nguồn với bảng giá
  • website_suchen: tìm kiếm trên mọi trang của aureum-tech.com

Thêm vào đó là 50 trong 51 công cụ của /tools (tất cả trừ công cụ kiểm tra hóa đơn điện tử), mỗi công cụ có một tên như werkzeug_email_check. Chúng tính theo cùng logic với trang trong trình duyệt, và mỗi câu trả lời ghi rõ trang của công cụ, ngày cập nhật của dữ liệu và giới hạn của kết quả. Công cụ cần nhập gì thì xem trên trang của nó, ở phần “Dành cho trợ lý AI”.

Giới hạn, để dịch vụ chạy ổn cho mọi người

Máy chủ công khai và không biết người dùng là ai. Vì vậy chi phí mỗi yêu cầu được đặt trần, và các giới hạn tốc độ của những công cụ truy vấn máy chủ bên ngoài áp dụng chung cho tất cả các lần gọi.

Giới hạn của /mcp và /a2a
Giới hạnGiá trịĐiều gì xảy ra khi vượt
Kích thước một yêu cầu900 KBHTTP 413
Số phiên MCP đang mở, tính chung mọi client500HTTP 503 kèm Retry-After: 30
Phiên MCP không hoạt động30 phútPhiên hết hạn, client nhận 404 và đăng ký kết nối lại.
Thời gian trả lời cho mỗi lần gọi một công cụ trong /tools không truy vấn mạng, tính cả thời gian chờ10 giâyDừng lại kèm thông báo lỗi của công cụ
Kiểm tra email30 lượt kiểm tra mỗi phút, 300 lượt kiểm tra DNS mới mỗi giờCông cụ đề nghị thử lại sau.
Kiểm tra bên thứ ba, trình thu thập AI và xem trước liên kếtmỗi loại 20 lượt kiểm tra mỗi phút, 150 lượt kiểm tra mới mỗi giờnhư công cụ kiểm tra email
Công cụ tính phí gas với số liệu trực tiếpPhí chỉ được truy vấn lại tối đa một lần mỗi phútTrả lời bằng số liệu của phút trước; khi không có số liệu trực tiếp thì dùng số liệu cố định của trang kèm một lưu ý

Kết quả đang nằm trong bộ nhớ đệm (năm phút cho mỗi tên miền hoặc địa chỉ) không tính vào mức trần theo giờ. Khi một công cụ tự báo lỗi (vượt giới hạn tốc độ, hết thời gian, dữ liệu nhập không dùng được), lỗi đó nằm trong trường fehler của câu trả lời, bằng tiếng Đức. Dữ liệu nhập không khớp lược đồ sẽ bị /a2a từ chối bằng lỗi JSON-RPC -32602 và /mcp từ chối bằng một câu trả lời lỗi của MCP SDK.

Gọi công cụ qua giao thức A2A

Endpoint
https://aureum-tech.com/a2a
Giao thức
A2A 1.0 qua JSON-RPC 2.0
Header
A2A-Version: 1.0
Phương thức
SendMessage

Các agent dùng giao thức A2A gọi cùng 50 công cụ đó qua /a2a. Một tin nhắn có phần dữ liệu {"werkzeug": "…", "eingabe": {…}} sẽ chạy một công cụ, và câu trả lời chứa cùng kết quả như với /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"
        }]
      }
    }
  }'
  • Một tin nhắn chỉ có chữ sẽ trả về danh sách công cụ cùng các trường nhập. Nếu chữ nêu tên một công cụ, agent trả về đầy đủ thông tin của công cụ đó cùng các câu hỏi mẫu.
  • Agent làm việc theo quy tắc cố định và không hiểu ngôn ngữ tự do.
  • Agent không tạo tác vụ (task) và không lưu gì. Mỗi câu trả lời là một tin nhắn trực tiếp, vì vậy ListTasks trả về danh sách rỗng.
  • Agent không hỗ trợ streaming và thông báo đẩy, cũng không nhận file.
  • Nếu thiếu header A2A-Version: 1.0, agent trả lỗi -32009: đặc tả coi việc thiếu thông tin này là phiên bản 0.3.

Bốn công cụ về hồ sơ công ty, dịch vụ, giá và tìm kiếm chỉ có qua /mcp. Với /a2a, cùng giới hạn kích thước yêu cầu, cùng thời gian chờ và cùng các giới hạn tốc độ được áp dụng. Phần mô tả dành cho phần mềm nằm trong Agent Card.

Các trang ở dạng Markdown

Ai gọi một trang kèm header Accept: text/markdown sẽ nhận nội dung chữ dạng Markdown thay vì HTML, không có thanh điều hướng và script. Trình duyệt không bao giờ gửi thông tin này nên vẫn thấy trang như thường. Các bản này được tạo khi dựng website từ các trang hoàn chỉnh, nên luôn mới như chính các trang đó.

curl -H "Accept: text/markdown" https://aureum-tech.com/preise

Câu trả lời mang Content-Type: text/markdown; charset=utf-8 và Vary: Accept. Ngoại lệ là trang tổng hợp cẩm nang và các bài chuyên môn từ hệ thống biên tập: cả hai chỉ được điền nội dung khi có yêu cầu, ở đó vẫn trả HTML. Nội dung chữ của các trang này trong một file có tại /llms-full.txt.

Nơi phần mềm tra xem có những gì

Các file này mô tả các cổng vào theo những định dạng mà agent và chương trình kiểm tra tự tìm. Trang chủ trỏ tới danh mục API, bản mô tả OpenAPI và trang này trong header Link của câu trả lời.

  • /.well-known/api-catalogDanh mục API theo RFC 9727. Với /mcp và /a2a, danh mục nêu bản mô tả, trang này làm tài liệu và, với /mcp, đường dẫn kiểm tra trạng thái.
  • /openapi.jsonOpenAPI 3.1: giao diện HTTP của endpoint MCP.
  • /.well-known/mcp/server-card.jsonMCP Server Card gồm địa chỉ, phương thức truyền và danh sách công cụ của máy chủ MCP.
  • /.well-known/agent-card.jsonA2A Agent Card: endpoint, phiên bản giao thức và khả năng của agent A2A.
  • /.well-known/agent-skills/index.jsonDanh mục các Agent Skill. Trong đó có hai hướng dẫn cho agent: dùng các công cụ qua MCP và chuẩn bị yêu cầu dịch vụ cho một người.
  • /llms.txtBản tóm tắt website cho mô hình ngôn ngữ, gồm các trang quan trọng.
  • /llms-full.txtNội dung chữ của các trang trong một file.
  • /auth.mdHướng dẫn đăng nhập cho agent. Chủ yếu nói rằng ở đây không có đăng nhập.
  • /robots.txtQuy tắc cho crawler. Tất cả đều được phép, các trình thu thập AI đã biết được liệt kê riêng từng cái.

Dữ liệu nhập được xử lý thế nào

Một lần gọi qua /mcp hoặc /a2a gửi dữ liệu nhập tới máy chủ của chúng tôi, máy chủ tính toán và trả kết quả mà không lưu dữ liệu nhập hay kết quả lâu dài. Chỉ kết quả của các lượt kiểm tra mạng, cùng tên miền hoặc địa chỉ đã kiểm tra, được giữ trong bộ nhớ tối đa sáu phút, không gắn với người gọi. Hệ thống chỉ ghi nhật ký yêu cầu mà không ghi nội dung, như với mọi lần mở trang, còn trợ lý AI tự làm gì với thông tin của anh chị thì do nhà cung cấp của nó quy định (chi tiết trong chính sách bảo mật (Datenschutzerklärung)).

Một lối truy cập như vậy cho hệ thống riêng của anh chị

Những gì website này cung cấp cho dữ liệu của chính nó, chúng tôi cũng xây cho doanh nghiệp: một máy chủ MCP để trợ lý AI truy cập phần mềm quản lý hàng hóa hoặc một cơ sở dữ liệu, với quyền do anh chị quy định trước. Cách chúng tôi làm xem trên trang về tích hợp MCP.

Xem phần tích hợp MCP
+49 3744 4399760Thứ Hai–thứ Sáu, 8–17 giờ
Gọi điệnGọi lại cho tôi

BẢNG KÊ THÀNH PHẦN · TRANG 1/1

Trang này gồm những gì

Số liệu được đo lúc dựng trang. Nếu có JavaScript, trình duyệt của anh chị sẽ đo lại trực tiếp.

STTTHÀNH PHẦNLOẠIDUNG LƯỢNG
01index.htmlTài liệu≈ 29 kB
02styles.cssStylesheet≈ 20 kB
03scripts.jsScript≈ 13 kB
04archivo-variable.woff2Phông chữ≈ 58 kB
05ibm-plex-mono.woff2Phông chữ≈ 30 kB
06favicon.svgĐồ họa< 1 kB

Cookie quảng cáo hoặc cookie phân tích: không có. Khi chưa được anh chị đồng ý, trang này không tải gì từ máy chủ bên ngoài, ngoại trừ Cloudflare, dịch vụ phân phối nội dung mà chúng tôi dùng. Phông chữ, script và hình ảnh đều nằm trên máy chủ của chúng tôi. Hệ thống IT của anh chị, chúng tôi cũng xây dựng theo cách đó.

NGOÀI GIỜ LÀM VIỆC

Anh chị vẫn cứ gọi, không sao cả

Theo lịch bình thường, chúng tôi có mặt ở văn phòng từ thứ Hai đến thứ Sáu, 8–17 giờ.

Buổi tối và cuối tuần, số này vẫn được chuyển tiếp đến chúng tôi và thường có người nghe máy. Nhưng điều đó chúng tôi không dám hứa chắc.

Nếu không ai nghe máy, anh chị để lại lời nhắn ngắn trong hộp thư thoại: tên, số điện thoại và việc cần hỗ trợ. Chúng tôi sẽ gọi lại sớm nhất có thể, chậm nhất là ngày làm việc tiếp theo.

Cuộc gọi không mất tiền. Nếu ngoài giờ làm việc mà cần có người xử lý ngay thì áp dụng phụ phí ghi trong bảng giá.

Gọi ngay+49 3744 4399760

Anh chị muốn viết hơn? Anh chị dùng biểu mẫu liên hệ hoặc gửi email đến [email protected]. Chúng tôi sẽ đọc vào ngày làm việc tiếp theo.

CHẨN ĐOÁN · AT-K2

Anh chị đang gặp chuyện gì?

↵ CHỌNESC ĐÓNGGỌI ĐIỆN: +49 3744 4399760

Cài đặt riêng

Những dịch vụ nào được phép tải?

Cần thiết về mặt kỹ thuật

Lựa chọn của anh chị tại đây, cùng với cài đặt về giao diện màu và chuyển động. Những thông tin này được lưu thành các mục nhỏ trên thiết bị của anh chị và không bao giờ được gửi đến máy chủ nào. Trang web cần chúng để hoạt động nên không thể bỏ chọn.