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

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:

Hướng	Kết quả
Máy chủ MCP từ xa → tác nhân ThunderPhone	Tác nhân AI của bạn có thể gọi các công cụ của máy chủ từ xa.
ThunderPhone → ứng dụng MCP của bạn	Ứng dụng MCP của bạn có thể gọi các công cụ ThunderPhone dành cho tác nhân AI và cuộc gọi.

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.

Generic client configuration

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

Khóa sk_live_ có thể truy cập dữ liệu tổ chức và thực hiện cuộc gọi. Không đưa khóa này vào mã trình duyệt, kho lưu trữ, ảnh chụp màn hình và nhật ký trò chuyện. Sử dụng kho lưu trữ bí mật được ứng dụng MCP của bạn hỗ trợ và thu hồi khóa ngay lập tức nếu bị lộ.

Công cụ có sẵn

Công cụ	Đối số	Chức năng
`list_agents`	không có	Liệt kê các tác nhân AI của tổ chức kèm id, tên, sản phẩm và giọng nói.
`get_agent`	`agent_id`	Truy xuất một tác nhân AI.
`place_call`	`agent_id`, `from_number`, `to_number`	Thực hiện cuộc gọi đi với cùng quy tắc xác thực và kiểm tra thanh toán như endpoint gọi REST.
`get_call`	`call_id`	Truy xuất trạng thái, tóm tắt và điểm đánh giá của cuộc gọi.
`list_calls`	`limit` tùy chọn (1–100), `status` tùy chọn	Liệt kê các cuộc gọi gần đây.
`get_call_transcript`	`call_id`	Truy xuất bản ghi đầy đủ của một cuộc gọi.

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.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

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

Xác thực

Công cụ có sẵn

Phương thức giao thức

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

Tham chiếu wire đầy đủ

​Xác thực

​Công cụ có sẵn

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

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

​Tham chiếu wire đầy đủ

Xác thực

Công cụ có sẵn

Phương thức giao thức

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

Tham chiếu wire đầy đủ