Ortto MCP Server

Truy cập ortto.com

Trang chủ Ortto MCP Ortto MCP

Ortto MCP

MCP là gì?

Model Context Protocol (MCP) là một tiêu chuẩn mở cho phép các tác nhân AI (như Claude hoặc ChatGPT) tương tác an toàn với các công cụ và nguồn dữ liệu bên ngoài.

Bạn kết nối tác nhân AI (máy khách MCP) trực tiếp với máy chủ MCP của Ortto. Điều này cho phép tác nhân của bạn hiểu và hành động dựa trên dữ liệu Ortto của bạn.

Sau đó, tác nhân của bạn có thể hỗ trợ nhiều tác vụ khác nhau bằng cách sử dụng lời nhắc ngôn ngữ tự nhiên. Ví dụ:

• "Cho tôi xem hiệu suất của các chiến dịch email trong 30 ngày qua."
• "Hành trình nào đang hoạt động tốt nhất về mặt chuyển đổi?"
• "Lấy cho tôi danh sách những liên hệ tương tác nhiều nhất trong tháng này."

---

Định cấu hình nguồn dữ liệu MCP

Để bắt đầu với tính năng MCP của chúng tôi, bạn cần tạo MCP làm nguồn dữ liệu trong tài khoản Ortto của mình. Làm theo các bước sau để thiết lập:

1. Trong tài khoản Ortto, điều hướng đến CDP > Nguồn dữ liệu.
2. Nhấp vào Nguồn dữ liệu mới và tìm kiếm MCP.
3. Nhập tên cho nguồn dữ liệu MCP của bạn và nhấp vào Kết nối.

4. Sau khi nguồn dữ liệu được tạo, bạn sẽ có quyền truy cập vào Khóa phạm vi. Bạn cần sử dụng khóa này để kết nối Ortto với tác nhân AI mà bạn chọn (Claude, ChatGPT, v.v.).

Bây giờ bạn đã sẵn sàng kết nối Ortto với tác nhân AI của mình. Tùy thuộc vào tác nhân AI bạn đang sử dụng, hãy xem bài viết phù hợp bên dưới:

• Sử dụng Ortto MCP với Claude
• Sử dụng Ortto MCP với ChatGPT

MẸO: Bạn có thể kết nối Ortto MCP với bất kỳ ứng dụng nào hỗ trợ trình kết nối tùy chỉnh. Nếu ứng dụng bạn đang sử dụng không được liệt kê ở trên, chỉ cần sử dụng URL máy chủ MCP từ xa phù hợp dựa trên nơi tài khoản Ortto của bạn được lưu trữ.

• Hoa Kỳ: https://mcp-api-us.ortto.app/mcp?jwt=your-scoped-key
• Châu Âu: https://mcp-api-eu.ortto.app/mcp?jwt=your-scoped-key
• Úc: https://mcp-api-au.ortto.app/mcp?jwt=your-scoped-key

Nếu bạn không chắc tài khoản của mình được lưu trữ ở đâu, bạn có thể tìm thấy thông tin này trong ứng dụng bằng cách điều hướng đến Cài đặt > Quyền riêng tư, Bảo mật và GDPR > Lưu trữ dữ liệu.

---

Các công cụ/hành động được hỗ trợ

Máy chủ Ortto MCP cho phép các tác nhân AI tương tác với dữ liệu Ortto của bạn thông qua các công cụ/hành động cụ thể. Các bảng sau được sắp xếp theo danh mục dữ liệu và nêu chi tiết các công cụ/hành động được hỗ trợ cùng với định nghĩa của chúng.

MẸO: Các công cụ/hành động được nêu trong bảng bên dưới chỉ là quy ước đặt tên được sử dụng bởi tính năng MCP của chúng tôi. Bạn không cần phải sử dụng rõ ràng những tên này trong công cụ tác nhân AI của mình. Tác nhân của bạn sẽ tự động chọn và sử dụng công cụ/hành động phù hợp dựa trên yêu cầu bằng ngôn ngữ tự nhiên của bạn.

Quản lý chiến dịch

Công cụ/Hành động	Mô tả
get_campaigns	Truy xuất danh sách các chiến dịch của bạn với các tùy chọn lọc và phân trang. Hỗ trợ lọc theo loại chiến dịch, trạng thái và truy vấn tìm kiếm.

Ví dụ:

• "Cho tôi xem tất cả các chiến dịch email từ tháng trước"
• "Lấy các chiến dịch hiện đang chạy"
• "Tìm các chiến dịch có 'mùa hè' trong tên"

Liên hệ và Đối tượng

Công cụ/Hành động	Mô tả
get_contacts	Truy xuất liên hệ với các tùy chọn lọc toàn diện bao gồm ID đối tượng, lựa chọn trường và khả năng tìm kiếm.
get_audiences	Liệt kê tất cả các đối tượng trong tài khoản của bạn với hỗ trợ tìm kiếm và phân trang.

Ví dụ:

• "Truy xuất bất kỳ liên hệ nào có 'smith' trong tên của họ"
• "Tìm các đối tượng có ít hơn 1.000 thành viên"
• "Cho tôi xem địa chỉ email và tên của 10 liên hệ đã đăng ký gần đây nhất"

Báo cáo chiến dịch

Công cụ/Hành động	Mô tả
get_email_report	Tạo báo cáo hiệu suất chiến dịch email chi tiết bao gồm tỷ lệ mở, tỷ lệ nhấp và số liệu tương tác.
get_journey_report	Nhận phân tích hiệu suất hành trình toàn diện với khung thời gian có thể tùy chỉnh.
get_journey_shape_report	Phân tích các hình dạng hành trình cụ thể và số liệu của chúng.
get_sms_report	Truy xuất dữ liệu hiệu suất chiến dịch SMS và thống kê tương tác.
get_push_report	Truy cập phân tích chiến dịch thông báo đẩy và số liệu phân phối.

Ví dụ:

• "Tạo báo cáo email cho chiến dịch 'Holiday Sale'"
• "Hiệu suất tổng thể của hành trình 'Abandoned Cart' là gì?"

Báo cáo tùy chỉnh

Công cụ/Hành động	Mô tả
list_reports	Truy cập các báo cáo do người dùng tạo từ tài khoản Ortto của bạn với khả năng lọc theo loại biểu đồ và tìm kiếm.
get_report	Truy xuất dữ liệu báo cáo cụ thể với khung thời gian có thể tùy chỉnh và các tùy chọn làm mới.

Ví dụ:

• "Liệt kê tất cả các báo cáo biểu đồ tròn trong tài khoản của tôi"
• "Truy xuất dữ liệu cho báo cáo 'Q3 Revenue'"

Tài khoản và cấu hình

Công cụ/Hành động	Mô tả
get_schema	Truy xuất lược đồ dữ liệu hoàn chỉnh cho phiên bản Ortto của bạn, bao gồm các trường tùy chỉnh và cấu trúc dữ liệu.
get_brand_book	Truy cập cài đặt sổ tay thương hiệu của bạn bao gồm màu sắc, phông chữ và các yếu tố thương hiệu.

Ví dụ:

• "Màu sắc thương hiệu chính và phụ được xác định trong sổ tay thương hiệu của chúng tôi là gì?"
• "Truy xuất tất cả các trường tùy chỉnh trong tài khoản của tôi có 'example' trong tên của chúng"

Quản lý tài sản

Công cụ/Hành động	Mô tả
create_asset	Tạo tài sản mới, chủ yếu là email HTML, với nội dung và siêu dữ liệu có thể tùy chỉnh.
get_asset_html	Truy xuất nội dung HTML của các tài sản hiện có để xem xét hoặc sửa đổi.
update_asset_meta	Cập nhật siêu dữ liệu tài sản bao gồm tên, dòng tiêu đề và thông tin người gửi.

Ví dụ:

• "Tạo một tài sản email quảng cáo mới có tiêu đề 'Không thể bỏ lỡ ưu đãi' với nội dung giải thích lý do người dùng không nên bỏ lỡ đợt giảm giá sắp tới"
• "Truy xuất nội dung HTML của tài sản có tên 'Welcome Email v2'"

Cơ sở kiến thức

Công cụ/Hành động	Mô tả
get_index	Truy xuất cấu trúc cơ sở kiến thức bao gồm danh mục và phân cấp bài viết.
create_category	Tạo danh mục cơ sở kiến thức mới với các mối quan hệ cha-con tùy chọn.
create_article_from_html	Tạo bài viết cơ sở kiến thức từ nội dung HTML với phân loại.
move_article	Di chuyển bài viết giữa các danh mục trong cơ sở kiến thức của bạn.
modify_index	Cập nhật cấu trúc và tổ chức chỉ mục cơ sở kiến thức.

Ví dụ:

• "Tạo một bài viết cơ sở kiến thức từ HTML này và đặt tiêu đề là 'Tổng quan về MCP'"
• "Tạo một danh mục mới có tên 'Khắc phục sự cố'"
• "Cho tôi xem cấu trúc cơ sở kiến thức hiện tại"

---

Giới hạn yêu cầu

Khi bạn sử dụng tác nhân AI thông qua tính năng Ortto MCP, bạn sẽ gặp phải hai bộ giới hạn khác nhau. Trong khi các tác nhân AI (chẳng hạn như Claude hoặc ChatGPT) thực thi các giới hạn riêng của chúng về độ dài yêu cầu và kích thước phản hồi, tất cả các lệnh gọi API được định tuyến qua máy chủ Ortto MCP đều phải tuân theo giới hạn tốc độ API Ortto tiêu chuẩn của chúng tôi. Các giới hạn tốc độ này áp dụng dựa trên gói đăng ký của bạn và được triển khai để đảm bảo tính ổn định của hệ thống và sử dụng công bằng.

Tìm hiểu thêm về giới hạn tốc độ API của chúng tôi.