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
01 / TỔNG QUAN
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.
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.
02 / 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
- 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 đó. - notifications/initialized: Client xác nhận việc đăng ký đã hoàn tất.
- tools/list: Máy chủ liệt kê tất cả công cụ, kèm mô tả và lược đồ đầu vào.
- 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ạileistungen_auflisten: tất cả các mảng dịch vụ, mỗi mảng kèm trang tương ứngpreise_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”.
03 / GIỚI HẠN
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 | Giá trị | Điều gì xảy ra khi vượt |
|---|---|---|
| Kích thước một yêu cầu | 900 KB | HTTP 413 |
| Số phiên MCP đang mở, tính chung mọi client | 500 | HTTP 503 kèm Retry-After: 30 |
| Phiên MCP không hoạt động | 30 phút | Phiê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ây | Dừng lại kèm thông báo lỗi của công cụ |
| Kiểm tra email | 30 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ết | mỗ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ếp | Phí chỉ được truy vấn lại tối đa một lần mỗi phút | Trả 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.
04 / A2A
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
ListTaskstrả 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.
05 / MARKDOWN
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.
06 / FILE MÔ TẢ
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.
07 / BẢO MẬT DỮ LIỆU
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)).
08 / CHO DOANH NGHIỆP CỦA ANH CHỊ
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