# MCP server của Tellnod

> Tellnod là một MCP server email marketing từ xa tại `https://mcp.tellnod.com/mcp`: dùng Streamable HTTP với OAuth 2.1, cung cấp công cụ cho thương hiệu, liên hệ, phân khúc, bản nháp, bản xem trước, lần gửi và kết quả, đồng thời hiển thị thẻ tương tác trong các client hỗ trợ MCP Apps.

Canonical: https://tellnod.com/vi/mcp-server  
Last updated: 2026-10-17  
Author: Tellnod team

## 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](https://tellnod.com/vi/connect).
- **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](https://tellnod.com/vi/line-mcp-server).

## FAQ

### MCP server của Tellnod có phải mã nguồn mở không?

Server là một dịch vụ được lưu trữ sẵn. Bộ hiển thị bản xem trước email, `preview-kit`, được dự kiến phát hành dưới dạng gói mã nguồn mở.

### Tôi có thể dùng từ MCP client của riêng mình không?

Bất kỳ client nào hỗ trợ MCP server từ xa qua Streamable HTTP với đăng nhập OAuth đều kết nối được. Thẻ chỉ hiển thị trong các client hỗ trợ MCP Apps.

### API key có thể gửi email qua MCP server không?

Không. Không có API key nào có quyền gửi; mọi lần gửi đều cần một người nhấn Xác nhận.