Sinch Engage / MessageMedia MCP server

chính thức

Máy chủ MCP Sinch Engage (Sinch MessageMedia tại Úc), cung cấp các API Sinch Engage dưới dạng công cụ MCP.

Tài liệu

Sinch Engage MCP Server

Kho lưu trữ này chứa mã nguồn cho máy chủ MCP Sinch Engage (Sinch MessageMedia tại Úc), cung cấp các API Sinch Engage dưới dạng công cụ MCP.

Tổng quan về Công cụ

Dưới đây là danh sách các công cụ có sẵn trong máy chủ MCP (tất cả số điện thoại phải được cung cấp theo định dạng E.164, ví dụ: +61400000000 cho Úc).

Nhắn tin

Công cụ	Mô tả	Danh mục	Chế độ
sendMessage	Gửi SMS đến một số điện thoại di động	nhắn tin	ghi

Báo cáo

Công cụ	Mô tả	Danh mục	Chế độ
getDetailedMessageReport	Tạo báo cáo chi tiết về các tin nhắn đã gửi và nhận trong một khoảng thời gian xác định, với các bộ lọc tùy chọn về hướng, tài khoản, siêu dữ liệu và nhóm.	báo cáo	đọc
getSummaryMessageReport	Tạo báo cáo tóm tắt về các tin nhắn đã gửi và nhận trong một khoảng thời gian xác định, với các bộ lọc tùy chọn về hướng, tài khoản và nhóm.	báo cáo	đọc
getSummaryInsightMessageReport	Lấy báo cáo tóm tắt được biên soạn sẵn về các tin nhắn đã gửi và nhận trong một khoảng thời gian xác định, với các bộ lọc tùy chọn về hướng, tài khoản và nhóm.	báo cáo	đọc
getAsyncReportStatus	Truy xuất trạng thái của một yêu cầu báo cáo bất đồng bộ theo report_id.	báo cáo	đọc
getAsyncReportFields	Truy xuất danh sách các trường có sẵn cho xuất báo cáo chi tiết bất đồng bộ.	báo cáo	đọc
requestAsyncDetailedMessageReport	Yêu cầu một báo cáo chi tiết bất đồng bộ về các tin nhắn đã gửi và nhận trong một khoảng thời gian xác định, với các tùy chọn phân phối về định dạng báo cáo và đích đến.	báo cáo	đọc

Danh bạ

Công cụ	Mô tả	Danh mục	Chế độ
getContactGroups	Truy xuất danh sách phân trang các nhóm danh bạ (danh sách) liên kết với tài khoản.	báo cáo	đọc
getContactGroupDetails	Truy xuất chi tiết cho một nhóm danh bạ (danh sách) cụ thể được xác định bởi group_id.	báo cáo	đọc
getContactWithSearch	Truy xuất danh sách danh bạ, có thể lọc theo nhóm, số điện thoại, tên và loại kênh.	báo cáo	đọc
createContactGroup	Tạo một nhóm danh bạ (danh sách) mới với tên được chỉ định và bí danh tùy chọn.	báo cáo	ghi
createContact	Tạo một danh bạ mới với các chi tiết được chỉ định.	báo cáo	ghi
updateContact	Cập nhật một danh bạ hiện có được xác định bởi contact_id với các chi tiết mới.	báo cáo	ghi
deleteContactGroup	Xóa một nhóm danh bạ (danh sách) cụ thể được xác định bởi group_id.	báo cáo	xóa

Bắt đầu

Điều kiện tiên quyết

Node.js >= 16.0
Một tài khoản Sinch Engage đã được cấp phép
Claude Desktop (hoặc bất kỳ máy khách MCP nào khác). README này tập trung vào Claude Desktop, nhưng máy chủ MCP có thể được sử dụng với bất kỳ máy khách MCP nào.

Thông tin xác thực API

Để sử dụng các API được dùng bởi các công cụ MCP, bạn sẽ cần các thông tin xác thực sau:

SINCH_ENGAGE_API_KEY và SINCH_ENGAGE_API_SECRET Thông tin xác thực Sinch Engage

Cấu hình Máy chủ MCP

Máy chủ MCP Sinch Engage có sẵn dưới dạng gói NPM để thực thi. Dưới đây là cách thiết lập nó trong tệp cấu hình Claude Desktop (claude_desktop_config.json). Hãy nhớ điền các biến môi trường với thông tin xác thực của riêng bạn và khu vực (hiện hỗ trợ EU & AU):

{
  "mcpServers": {
    "Sinch Engage": {
      "command": "npx",
      "args": [
        "-y",
        "@sinch-engage/mcp-server"
      ],
      "env": {
        "SINCH_ENGAGE_API_KEY": "<your-key>",
        "SINCH_ENGAGE_API_SECRET": "<your-secret>",
        "SINCH_ENGAGE_REGION": "<region>",
        "MCP_TOOL_CATEGORIES": "reporting, contacts, messaging",
        "MCP_TOOL_MODES": "read, write, delete"
      }
    }
  }
}

Chạy Máy chủ MCP cục bộ

Tùy chọn 1: Khởi động máy chủ MCP với stdio bằng Claude Desktop

Để chạy máy chủ MCP cục bộ với Claude Desktop, bạn sẽ cần sao chép kho lưu trữ và xây dựng máy chủ MCP. Tùy chọn này hữu ích cho phát triển và kiểm thử cục bộ.

Bước 1: Sao chép kho lưu trữ

git clone https://github.com/messagemedia/sinch-engage-mcp-server.git

Bước 2: Cài đặt các phụ thuộc

cd sinch-engage-mcp-server
npm install

Bước 3: Thiết lập cấu hình Claude Desktop

Dưới đây là một ví dụ về cách cấu hình máy chủ MCP trong tệp cấu hình Claude Desktop (claude_desktop_config.json) nơi bạn có thể cung cấp thông tin xác thực Sinch Engage và khu vực (EU hoặc AU):

{
  "mcpServers": {
    "Sinch Engage": {
      "command": "node",
      "args": ["/path/to/sinch-engage-mcp-server/src/index.js"],
      "env": {
        "SINCH_ENGAGE_API_KEY": "<your-key>",
        "SINCH_ENGAGE_API_SECRET": "<your-secret>",
        "SINCH_ENGAGE_REGION": "<region>",
        "MCP_TOOL_CATEGORIES": "reporting, contacts, messaging",
        "MCP_TOOL_MODES": "read, write, delete"
      }
    }
  }
}

Bước 4: (Tùy chọn) Lọc các công cụ có sẵn trong máy chủ MCP

Quá nhiều công cụ đồng nghĩa với ngữ cảnh lớn hơn, dẫn đến sử dụng nhiều token hơn và gây nhầm lẫn cho LLM khi chọn đúng công cụ để sử dụng.
Bạn có thể lọc các công cụ có sẵn trong máy chủ MCP bằng cách cung cấp MCP_TOOL_CATEGORIES trong các tùy chọn cấu hình Claude Desktop.

Nếu bạn muốn lọc công cụ theo quyền, bạn có thể sử dụng MCP_TOOL_MODES để chỉ chọn các công cụ có thể đọc, ghi hoặc xóa dữ liệu hoặc bất kỳ sự kết hợp nào của chúng