Connect tools & data

Sử dụng ThunderPhone làm máy chủ MCP

Kết nối bất kỳ ứng dụng khách MCP HTTP có thể truyền trực tuyến nào với ThunderPhone để liệt kê tác nhân AI, kiểm tra cuộc gọi và bản chép lời, đồng thời thực hiện cuộc gọi đi bằng khóa API của tổ chức.

ThunderPhone cung cấp máy chủ Model Context Protocol tại:

https://api.thunderphone.com/v1/mcp

Trỏ ứng dụng MCP đến endpoint Streamable HTTP đó để cung cấp các tác nhân AI và cuộc gọi của tổ chức bạn dưới dạng công cụ. Đây là hướng ngược lại với việc kết nối máy chủ MCP từ xa với tác nhân AI:

Xác thực#

Tạo khóa sk_live_ trong Tổ chức → Khóa và gửi khóa đó dưới dạng token Bearer. Endpoint MCP chấp nhận khóa API của tổ chức, không chấp nhận cookie phiên dashboard hoặc khóa widget có thể công khai.

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}

Công cụ có sẵn#

Mọi công cụ đều được giới hạn trong tổ chức liên kết với khóa API. Id từ tổ chức khác sẽ hoạt động như không khả dụng.

Phương thức giao thức#

Endpoint triển khai các phương thức MCP JSON-RPC cần thiết cho ứng dụng Streamable HTTP:

• initialize
• notifications/initialized
• tools/list
• tools/call

Bạn có thể kiểm tra trực tiếp danh mục công cụ:

curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Gọi một công cụ bằng tên và đối số của công cụ đó:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}

Kết quả công cụ là các mục nội dung văn bản MCP. Lỗi công cụ được trả về trong kết quả với isError: true; các phương thức JSON-RPC không xác định trả về lỗi giao thức.

Thực hiện cuộc gọi an toàn#

place_call tuân theo các quy tắc giống POST /v1/call: tác nhân AI và số điện thoại phải thuộc tổ chức của khóa, số điện thoại phải đủ điều kiện thực hiện cuộc gọi đi, tổ chức phải có số dư đủ và mọi xác nhận áp dụng cho cuộc gọi đi phải hoàn tất.

Hãy xem ứng dụng có quyền truy cập place_call như một bên gọi trong môi trường sản xuất. Hạn chế những người có thể sử dụng ứng dụng, nêu rõ tác nhân AI và số điện thoại dự kiến trong prompt riêng của ứng dụng, và xem lại các cuộc gọi trong Lịch sử cuộc gọi.

Tham chiếu wire đầy đủ#

Xem API Máy chủ MCP để biết ví dụ phản hồi, lỗi JSON-RPC và API quản lý máy chủ từ xa.