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à:
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:
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 ở dạng bản nháp (one-time, drip hoặc lifetime). 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 đồ
- Yêu cầu trợ lý gọi
search_map_leadsvới vị trí và từ khóa doanh nghiệp, chẳng hạn như một thành phố vàmarketing agency. - Các bộ lọc tùy chọn gồm
radiusKm(1–100),lat,lngvàemailOnlyđể chỉ giữ lại doanh nghiệp có công khai email. - Khi kết quả có
nextPageToken, hãy truyền giá trị đó dưới dạngpageTokenđể tải trang tiếp theo. - Yêu cầu trợ lý gọi
import_map_leadsvớ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.
Phê duyệt việc khởi chạy chiến dịch
- Yêu cầu trợ lý kiểm tra bản nháp bằng
get_campaign. - Yêu cầu trợ lý gọi
prepare_campaign_launchvớ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. - 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.
- Quay lại client để client gọi
launch_campaignvới cùng ID chiến dịch, thời gian vàapprovalId.
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.
Bán kính tìm kiếm và bổ sung thông tin
Tìm kiếm API và MCP mặc định 5 km, chấp nhận số nguyênradiusKm từ 1 đến 100 và không hiển thị hộp thoại xác nhận của bảng điều khiển. Giữ nguyên tham số khi truyền nextPageToken thành pageToken; một trang không có kết quả phù hợp vẫn có thể có trang tiếp theo.
Thông tin liên hệ có thể được bổ sung sau khi doanh nghiệp xuất hiện. enrichmentPending đánh dấu việc nghiên cứu website chưa hoàn tất. Xem businessSummary và businessSources khi có; ngữ cảnh doanh nghiệp được nhập có thể hỗ trợ lời mở đầu cá nhân hóa. Chưa có email có thể do nghiên cứu còn đang chờ.
Nếu có enrichmentRetryToken, gọi retry_map_leads_enrichment với token. Công cụ cần campaigns:read, gắn với không gian làm việc đã kết nối, hết hạn sau 15 phút và chỉ dùng một lần. Hợp nhất kết quả theo placeId trước khi nhập. emailOnly lọc phản hồi hiện tại; khách hàng đang chờ có thể xuất hiện sau khi thử lại.
Sửa bản nháp và phạm vi công cụ
Dùngupdate_campaign để sửa bản nháp hiện có và delete_campaign để xóa bản nháp. Cả hai yêu cầu campaigns:write; không công cụ nào gửi hoặc lên lịch email. Các nhóm chức năng mới yêu cầu quyền OAuth riêng. Kết nối lại và phê duyệt các quyền đó khi được yêu cầu.
Danh sách công cụ cung cấp các công cụ có sẵn và tham số tương ứng. Chuyển sang trình duyệt không tự thực hiện hành động: hãy hoàn tất thanh toán, cấp quyền nhà cung cấp, gửi lời mời, chuyển không gian làm việc và cài đặt chi trả nhạy cảm trong trình duyệt. Kết nối MCP vẫn gắn với không gian làm việc đã được cấp quyền. Các chức năng quản trị, thông tin xác thực, webhook, callback theo dõi và trợ lý nội bộ không được cung cấp.
Dùng get_api_capabilities để kiểm tra phạm vi API. Với email thử nghiệm, kích hoạt chiến dịch lifetime hoặc sự kiện lifetime, hãy yêu cầu phê duyệt trên trình duyệt bằng prepare_campaign_action, rồi gọi send_test_email, activate_lifetime_campaign hoặc trigger_lifetime_campaign với cùng tham số. Phê duyệt hết hạn sau mười phút và chỉ dùng một lần.