API MCP và Tool

MCP là nguồn Tool toàn cục để Package lựa chọn. Chỉ Super Admin sử dụng nhóm API này.

Endpoint

Method	Path	Scope	Chức năng
GET	/api/v1/mcp	platform.company.mcp.manage	Danh sách MCP và Tool.
POST	/api/v1/mcp	platform.company.mcp.manage	Tạo MCP.
GET	/api/v1/mcp/{mcpId}	platform.company.mcp.manage	Chi tiết MCP.
PUT	/api/v1/mcp/{mcpId}	platform.company.mcp.manage	Thay cấu hình MCP.
DELETE	/api/v1/mcp/{mcpId}	platform.company.mcp.manage	Xóa MCP không hoạt động và chưa được Package dùng.
POST	/api/v1/mcp/{mcpId}/check	platform.company.mcp.manage	Kiểm tra kết nối, không ghi Tool.
POST	/api/v1/mcp/{mcpId}/sync	platform.company.mcp.manage	Đọc tools/list và đồng bộ Tool.
PUT	/api/v1/mcp/{mcpId}/tools/{toolId}	platform.company.mcp.manage	Bật hoặc tắt Tool.

curl --fail-with-body \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  "$NEXUS_URL/api/v1/mcp"

Tạo MCP

curl --fail-with-body -X POST \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "display_name": "CRM n8n",
    "description": "Tra cứu khách hàng và đơn hàng.",
    "endpoint_url": "https://example.com/mcp",
    "auth_type": "bearer",
    "token": "replace-with-downstream-token",
    "status": "active",
    "timeout_seconds": 10
  }' \
  "$NEXUS_URL/api/v1/mcp"

auth_type nhận none hoặc bearer; status nhận active, pending_configuration hoặc disabled. Token được mã hóa và không xuất lại trong response.

Kiểm tra và đồng bộ Tool

export MCP_ID="1"

curl --fail-with-body -X POST \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  "$NEXUS_URL/api/v1/mcp/$MCP_ID/check"

curl --fail-with-body -X POST \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  "$NEXUS_URL/api/v1/mcp/$MCP_ID/sync"

Bật hoặc tắt Tool

export TOOL_ID="1"

curl --fail-with-body -X PUT \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"status":"active"}' \
  "$NEXUS_URL/api/v1/mcp/$MCP_ID/tools/$TOOL_ID"

Tool mới đồng bộ mặc định không tự được Package cho phép; quyền sử dụng cuối cùng vẫn đi qua Role → Package → MCP → Tool.