Kết nối các công cụ AI với MCP

Ody có một máy chủ MCP (Giao thức Ngữ cảnh Mô hình) tích hợp tại https://api.ody.co/v1/mcp — hãy thêm nó vào ChatGPT, Claude, Cursor hoặc bất kỳ máy khách MCP nào bằng khóa API, và trợ lý có thể quản lý danh bạ, xử lý các cuộc trò chuyện của bạn, tìm kiếm tin nhắn, gửi tin nhắn, mua số điện thoại, đăng ký tin nhắn 10DLC, thực hiện cuộc gọi AI đi và cấu hình tác nhân AI của bạn trong không gian làm việc của bạn.

Trước khi bạn bắt đầu

• Bạn cần một khóa API — xem Lấy khóa API Ody của bạn. Đối với trợ lý chỉ nên đọc, hãy tạo khóa chỉ với các phạm vi đọc — trợ lý sẽ chỉ được cung cấp các công cụ mà các phạm vi đó cho phép. Để thử nghiệm mà không gửi tin nhắn thật, hãy sử dụng khóa ody_test_… — xem Xây dựng an toàn với chế độ thử nghiệm.
• MCP được bao gồm trong mọi gói, bắt đầu từ gói Starter.

Từng bước

1. Nhấp vào Cài đặt trong thanh bên, sau đó chọn API nhà phát triển.

2. Cuộn đến thẻ Kết nối với ChatGPT & Claude. Thẻ này hiển thị điểm cuối MCP — https://api.ody.co/v1/mcp — cùng với nút Sao chép và cấu hình máy khách sẵn sàng để dán.

3. Trong cài đặt MCP/kết nối của công cụ AI của bạn, hãy thêm một máy chủ bằng cách sử dụng cấu hình này (với khóa thực của bạn):

{
  "mcpServers": {
    "ody": {
      "url": "https://api.ody.co/v1/mcp",
      "headers": { "Authorization": "Bearer ody_live_…" }
    }
  }
}

4. Hỏi trợ lý điều gì đó như "tóm tắt không gian làm việc Ody của tôi" để xác nhận kết nối.

Trợ lý có thể làm gì

Máy chủ MCP cung cấp hai mươi công cụ, mỗi công cụ được bảo vệ bởi cùng một phạm vi mà điểm cuối REST của nó sử dụng:

Công cụ	Chức năng	Phạm vi yêu cầu
list_contacts	Liệt kê hoặc tìm kiếm danh bạ của bạn	contacts:read
create_contact	Thêm một liên hệ	contacts:write
update_contact	Cập nhật tên, công ty, số điện thoại hoặc email của một liên hệ	contacts:write
delete_contact	Xóa vĩnh viễn một liên hệ	contacts:write
list_conversations	Liệt kê các cuộc trò chuyện đang mở/đã hoàn thành	conversations:read
get_conversation	Đọc toàn bộ chuỗi trò chuyện	conversations:read
set_conversation_status	Đánh dấu một cuộc trò chuyện là đang mở hoặc đã hoàn thành	conversations:write
search_messages	Tìm kiếm nội dung tin nhắn, bản ghi thư thoại và ghi chú cuộc gọi	conversations:read
workspace_summary	Tổng quan: số lượng liên hệ, số lượng cuộc trò chuyện đang mở/đã hoàn thành, tổng số chưa đọc, khối lượng 7 ngày	conversations:read
wait_for_message	Chờ (tối đa 25 giây) tin nhắn đến mới trong một cuộc trò chuyện	conversations:read
send_message	Gửi một tin nhắn SMS (đến một cuộc trò chuyện hoặc một số điện thoại)	messages:send
list_numbers	Liệt kê các số điện thoại trong không gian làm việc của bạn	numbers:read
search_numbers	Tìm kiếm các số điện thoại bạn có thể mua	numbers:manage
buy_number	Mua một số điện thoại — được tính phí như một giao dịch mua trong ứng dụng	numbers:manage
get_messaging_status	Kiểm tra trạng thái đăng ký tin nhắn 10DLC	numbers:manage
submit_10dlc_registration	Đăng ký doanh nghiệp + chiến dịch 10DLC của bạn (có tính phí)	numbers:manage
place_call	Yêu cầu tác nhân AI đã xuất bản của bạn thực hiện cuộc gọi đi	calls:place
get_agent	Đọc cấu hình và mức sử dụng tín dụng của tác nhân AI của bạn	agent:manage
configure_agent	Cập nhật cấu hình của tác nhân; truyền publish: true để kích hoạt	agent:manage
connect_agent_to_number	Chuyển hướng một trong các số điện thoại của bạn đến tác nhân AI	agent:manage

Nếu khóa thiếu một phạm vi, công cụ đó sẽ không được cung cấp cho trợ lý — vì vậy, một khóa chỉ đọc sẽ tạo ra một trợ lý thực sự chỉ đọc. Mọi thứ đều chạy với quyền hạn của thành viên đã tạo khóa, chỉ trong không gian làm việc đó.

Hai điều đáng biết:

• wait_for_message cho phép trợ lý duy trì một cuộc trò chuyện SMS trực tiếp: nó gửi một tin nhắn bằng send_message, chờ tối đa 25 giây để nhận phản hồi và trả lời — gọi lại công cụ nếu thời gian chờ hết.
• Các công cụ số điện thoại, 10DLC, cuộc gọi và tác nhân đều là cùng một giao diện "Điện thoại tác nhân" như API REST — cùng cách tính phí, cùng quy tắc và bạn có thể tiếp quản trong ứng dụng bất cứ lúc nào. Xem Mua số điện thoại và đăng ký tin nhắn qua API và Thực hiện cuộc gọi AI và quản lý Astra qua API.

Với khóa thử nghiệm, send_message ghi lại một tin nhắn mô phỏng, buy_number và place_call mô phỏng (không có gì được mua hoặc gọi), việc xuất bản tác nhân được mô phỏng và submit_10dlc_registration được gửi ở chế độ thử nghiệm — không mất phí, không gửi đến cơ quan đăng ký.

Bài viết liên quan

• Lấy khóa API Ody của bạn
• Xây dựng an toàn với chế độ thử nghiệm
• Tổng quan API và xác thực