Gọi thẳng qua HTTP

Cho đội kỹ thuật nối cổng vào hệ thống riêng: n8n, script, máy chủ nội bộ. Cổng chạy MCP Streamable HTTP tại https://mcp.admatrix.vn/mcp.

Xác thực

Key cho máy chủ

Tạo key ở trang tài khoản, gửi trong header Authorization: Bearer mos_…. Tạo key mới thì key cũ ngừng ngay.

OAuth cho ứng dụng

OAuth 2.1 với PKCE và đăng ký client động. Người dùng đăng nhập bằng email và mật khẩu; trình duyệt đã đăng nhập thì đi thẳng.

Luôn gửi kèm X-MOS-Device với một tên cố định cho mỗi máy, ví dụ n8n-vps. Đổi tên mỗi lần gọi là tốn thêm chỗ trong 3 thiết bị của tài khoản.

Hai bước gọi

Gửi initialize, lấy Mcp-Session-Id trong header trả về.
Gửi tools/call kèm session đó. Mỗi lần gọi tính một lượt.

KEY=mos_KEY_CUA_BAN URL=https://mcp.admatrix.vn/mcp H=(-H "Authorization: Bearer $KEY" -H "X-MOS-Device: server-noi-bo" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream") SID=$(curl -s -D - -o /dev/null "${H[@]}" "$URL" -d '{"jsonrpc":"2.0","id":1,"method":"initialize", "params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"noi-bo","version":"1"}}}' \ | awk 'tolower($1)=="mcp-session-id:"{print $2}' | tr -d '\r') curl -s "${H[@]}" -H "Mcp-Session-Id: $SID" "$URL" -d '{"jsonrpc":"2.0","id":2,"method":"tools/call", "params":{"name":"ads_audit","arguments":{"platform":"meta", "snapshot":{"spend":18500000,"cpa_or_cpl":412000,"currency":"VND", "date_from":"2026-10-12","date_to":"2026-10-18"}}}}'

Liệt kê công cụ và tham số bằng tools/list. Lệnh này không tính lượt.

Kết quả trả về

Công cụ	Trả về
Ba công cụ đo	`score` 0–100, `status` một câu tình trạng, `actions` danh sách việc cần làm. Thiếu số thì trả câu hỏi cần bổ sung.
`mentor`	Hướng đi và bước kế.
Bốn công cụ viết	Khung theo cấu trúc chuẩn để agent viết tiếp.
`company_suite`	Danh sách 16 quy trình và mã việc đã lưu.
`list_jobs`, `get_job`	Danh sách việc đã lưu, hoặc nội dung một việc.

Trường của bảng số xem ở Đưa số vào. Danh sách công cụ đầy đủ ở Công cụ.

Điểm cuối OAuth

Đường dẫn	Dùng để
`/.well-known/oauth-authorization-server`	Mô tả máy chủ cấp quyền. Ứng dụng tự đọc.
`/register`	Đăng ký client động.
`/oauth/authorize`	Trang đăng nhập bằng email và mật khẩu. Ứng dụng lạ thì hỏi thêm «Kết nối».
`/oauth/token`	Đổi mã lấy token.

Nối từ n8n

Dùng node MCP Client, chọn HTTP Streamable, URL https://mcp.admatrix.vn/mcp, xác thực bằng Header Auth với Authorization và key. Từng bước xem ở tab n8n trong Kết nối. Dùng chung một credential cho mọi workflow.