MCP server của Tellnod

Endpoint và giao thức truyền tải#

• Địa chỉ: https://mcp.tellnod.com/mcp
• Giao thức truyền tải: Streamable HTTP. Bạn không cần cài đặt hay chạy gì trên máy.
• Client: Claude (custom connector) và ChatGPT (custom MCP server). Các bước thiết lập: Kết nối.
• Thẻ tương tác: trong các client hỗ trợ MCP Apps, công cụ đính kèm một thẻ ui://tellnod/…; các client khác nhận cùng kết quả dưới dạng văn bản.

Xác thực#

Đăng nhập dùng OAuth 2.1 với đăng ký client động, nên client tự đăng ký và bạn đăng nhập bằng Google trong trình duyệt. Access token được gắn với địa chỉ của MCP server và bị từ chối ở bất kỳ nơi nào khác.

Client đã kết nối có thể đọc và soạn bản nháp. Gửi không phải là một quyền OAuth. Muốn lên lịch một lần gửi, phải có người nhấn Xác nhận trên thẻ hoặc trên trang xác nhận trên web, nên chỉ một token thì không bao giờ gửi được email.

Công cụ#

Mỗi công cụ đều khai báo readOnlyHint, destructiveHint, idempotentHint và openWorldHint, để client có thể cho bạn biết lệnh gọi nào thay đổi dữ liệu.

Chỉ đọc

• get_workspace, get_overview: tài khoản, gói, giới hạn và việc cần làm tiếp theo.
• fetch_brand: đọc logo, màu sắc và phông chữ từ trang web của bạn.
• search_contacts, get_contact, list_segments, estimate_audience: tìm người và ước tính quy mô tệp người nhận trước khi lưu.
• render_preview, preview_inbox, preview_channels, list_templates: email thật, dòng hiển thị trong hộp thư và các mẫu để bắt đầu.
• check_domain: trạng thái DNS của tên miền gửi.
• get_send, list_sends, get_campaign_results, compare_campaigns: trạng thái và kết quả của lần gửi.

Ghi

• save_brand, confirm_brand: lưu thương hiệu dùng trong mọi email.
• import_contacts, tag_contacts, create_segment: liên hệ kèm trạng thái đồng ý, và tệp người nhận đã lưu.
• create_message_draft, update_message_draft, apply_template: viết và chỉnh sửa email.
• add_domain, remove_domain: gửi từ tên miền của bạn.
• send_test: gửi email thử cho chính bạn (tối đa 20 email mỗi ngày).
• prepare_send, prepare_resend: cố định danh sách người nhận và hiển thị thẻ xác nhận.
• cancel_send: hủy một lần gửi đã lên lịch.

confirm_send chỉ hiển thị với thẻ, không hiển thị với mô hình, nên trợ lý không thể tự hoàn tất một lần gửi.

Quy trình gửi hai bước#

1. prepare_send cố định danh sách người nhận và trả về một mã xác nhận gắn với không gian làm việc, người dùng, nội dung email và chính danh sách đó.
2. Thẻ xác nhận hiển thị số người nhận, ai bị loại trừ và lý do, giờ gửi và danh mục kiểm tra tuân thủ.
3. Nhấn Xác nhận sẽ lên lịch lần gửi. Mỗi lần xác nhận chỉ dùng được một lần và hết hạn sau 30 phút; chuẩn bị lại sẽ tạo một lần xác nhận mới.
4. “Gửi ngay” sẽ chờ 5 phút, và mọi lần gửi đã lên lịch đều có thể hủy cho đến khi được gửi đi.

Giới hạn và cơ chế bảo vệ#

• Tên miền gửi dùng chung (một địa chỉ như hello@yourshop.tellnodmail.com): tối đa 500 người nhận mỗi chiến dịch và 1.000 email mỗi tháng. Tên miền đã xác minh của riêng bạn sẽ gỡ bỏ các giới hạn này.
• Gói miễn phí (Free): 500 liên hệ và 2.000 email mỗi tháng.
• Việc gửi tự động tạm dừng khi tỷ lệ khiếu nại đạt 0,1% hoặc tỷ lệ email bị trả về đạt 2%.
• Mọi chiến dịch đều được thêm liên kết hủy đăng ký, header hủy đăng ký một chạm và địa chỉ bưu chính.

Công cụ cho WhatsApp và LINE#

Công cụ cho WhatsApp và LINE dùng cùng danh sách liên hệ, cùng bản xem trước và cùng quy trình gửi hai bước, và xuất hiện trong danh sách công cụ khi quyền truy cập từng kênh của bạn được bật. WhatsApp và LINE đang nhận đăng ký dùng sớm. Xem LINE MCP server.

Câu hỏi thường gặp#