Skip to main content

​
Tổng quan

Nudgen cung cấp máy chủ MCP tại điểm cuối /mcp trên miền ứng dụng của bạn. Máy chủ sử dụng MCP 2026-07-28 qua Streamable HTTP và yêu cầu OAuth 2.1. Hãy kết nối một client hỗ trợ phương thức truyền tải này. Đăng nhập Nudgen trong trình duyệt, chọn một workspace và phê duyệt các quyền mà client yêu cầu. Kết nối vẫn được liên kết với workspace đó, ngay cả khi sau này bạn chuyển workspace trong dashboard.

​
Tại sao điều này lại quan trọng

Trợ lý của bạn có thể đọc danh bạ và chiến dịch, tìm doanh nghiệp lân cận, soạn nội dung và chuẩn bị khởi chạy chiến dịch mà không cần xử lý phiên dashboard hoặc Mã thông báo truy cập cá nhân. Bạn sẽ xem xét từng lần gửi thực tế hoặc lịch gửi trong trình duyệt trước khi chiến dịch có thể tiếp tục.

​
Kết nối client

Điểm cuối production là:
Thêm điểm cuối này dưới dạng máy chủ MCP HTTP từ xa trong một client hỗ trợ OAuth. Client sẽ tìm máy chủ ủy quyền của Nudgen từ điểm cuối rồi mở quy trình đăng nhập và chấp thuận trong trình duyệt. Chọn workspace mà bạn muốn client truy cập và chỉ phê duyệt các phạm vi quyền cần thiết. Các tài liệu khám phá: Máy chủ ủy quyền sử dụng authorization code với PKCE S256, liên kết tài nguyên và xoay vòng refresh token. Máy chủ chấp nhận Client ID Metadata Documents và đăng ký client động. Với Codex CLI, hãy dùng:
Nếu một client có tên nudgen đã được cấu hình, hãy cập nhật mục đó bằng URL /mcp. Nếu chỉ cần kiểm tra dữ liệu, hãy yêu cầu campaigns:read. Thêm campaigns:write khi client cần thay đổi danh bạ, bản nháp, cài đặt thương hiệu hoặc khách hàng tiềm năng đã nhập. Chỉ thêm campaigns:send khi client cần yêu cầu phê duyệt khởi chạy.
Mã thông báo truy cập cá nhân xác thực API nhà phát triển, nhưng không xác thực /mcp. Client MCP phải hoàn tất quy trình đăng nhập OAuth.

​
Công cụ có sẵn

create_campaign lưu một chiến dịch một lần ở dạng bản nháp. Công cụ này không thể gửi hoặc lên lịch trực tiếp. get_campaign cho phép bạn kiểm tra tiêu đề, nội dung, liên kết, đối tượng và người gửi trước khi khởi chạy. Máy chủ cũng cung cấp các tài nguyên chỉ đọc trong phạm vi campaigns:read:

​
Tìm và nhập khách hàng tiềm năng trên bản đồ

  1. Yêu cầu trợ lý gọi search_map_leads với vị trí và từ khóa doanh nghiệp, chẳng hạn như một thành phố và marketing agency.
  2. Các bộ lọc tùy chọn gồm radiusKm (1–100), lat, lng và emailOnly để chỉ giữ lại doanh nghiệp có công khai email.
  3. Khi kết quả có nextPageToken, hãy truyền giá trị đó dưới dạng pageToken để tải trang tiếp theo.
  4. Yêu cầu trợ lý gọi import_map_leads với cùng vị trí và từ khóa, cùng các đối tượng khách hàng tiềm năng cần lưu. Mỗi lần gọi chấp nhận tối đa 200 khách hàng tiềm năng.
Thao tác nhập sẽ ghi liên hệ vào workspace đã kết nối. Khách hàng tiềm năng không có email sẽ bị bỏ qua. Khách hàng tiềm năng đã tồn tại sẽ được cập nhật.

​
Phê duyệt việc khởi chạy chiến dịch

  1. Yêu cầu trợ lý kiểm tra bản nháp bằng get_campaign.
  2. Yêu cầu trợ lý gọi prepare_campaign_launch với ID chiến dịch và thời điểm gửi ngay hoặc thời gian lên lịch chính xác mà bạn muốn. Công cụ trả về URL phê duyệt dùng một lần; chưa có email nào được gửi.
  3. Mở URL, xem lại workspace, số người nhận ước tính, nội dung, người gửi và thời gian, sau đó nhấp vào Phê duyệt khởi chạy.
  4. Quay lại client để client gọi launch_campaign với cùng ID chiến dịch, thời gian và approvalId.
Phê duyệt hết hạn sau 10 phút và chỉ có thể dùng một lần. Nếu chiến dịch hoặc người gửi thay đổi, hãy yêu cầu phê duyệt mới. Khi khởi chạy, Nudgen kiểm tra lại trạng thái sẵn sàng của người gửi, người nhận đủ điều kiện, gói đăng ký, hạn mức và tình trạng hàng đợi. Việc gửi chỉ bắt đầu sau khi worker chiến dịch xử lý lệnh khởi chạy.
Việc phê duyệt và hoàn tất launch_campaign có thể gửi email thực. Hãy dùng quy trình gửi thử trên dashboard để kiểm tra bản xem trước trong hộp thư trước khi phê duyệt gửi đến đối tượng thực.

​
Quản lý quyền truy cập

Mở Cài đặt → Khóa API → Ứng dụng MCP đã kết nối để xem workspace và phạm vi quyền của từng client đã kết nối. Thu hồi kết nối tại đây nếu client không còn cần quyền truy cập. Việc thu hồi sẽ vô hiệu hóa token và các phê duyệt khởi chạy đang chờ. Sau đó, bạn vẫn có thể kết nối lại qua OAuth. Quyền cấp OAuth có hiệu lực tối đa 90 ngày. Khi mất quyền truy cập một workspace, client cũng không thể sử dụng kết nối của workspace đó.

​
Khắc phục sự cố

Đối với tập lệnh dùng bearer token và các điểm cuối REST trực tiếp, hãy xem API nhà phát triển.