Máy chủ MCP

Speechdash cung cấp một máy chủ chính thức tuân theo Model Context Protocol (MCP) để công khai hóa thư viện và tổng hợp âm thanh dưới dạng công cụ. Sử dụng nó khi bạn muốn một trợ lý AI liệt kê các tài liệu (bao gồm bản dịch đã hoàn thành), tạo nhập liệu văn bản, dịch hoặc xuất, kiểm tra ví của bạn, hoặc tổng hợp âm thanh mà không cần viết các yêu cầu HTTP thủ công. Thư viện bao gồm các bản dịch đã hoàn thành (source=transcription). Không có công cụ dịch âm thanh: đọc các công việc này bằng công cụ tài liệu. MCP không khởi động các công việc ghi âm.

Bạn cũng có thể gọi trực tiếp API REST công cộng bằng curl hoặc khách hàng của riêng bạn. MCP và HTTP chia sẻ cùng các điểm cuối, tín dụng và giới hạn tốc độ khi cả hai giao diện tồn tại.

Trước khi bắt đầu

Tạo một khóa API dưới Cài đặt → API trong ứng dụng cho Cursor, Claude Desktop và các khách hàng khác chấp nhận khóa xác thực. MCP sử dụng các khóa sh_live_… giống như HTTP. Xem tổng quan API.

ChatGPT (OAuth)

ChatGPT yêu cầu OAuth 2.1 + PKCE, không phải là một khóa API được dán. Đừng nhập khóa API vào giao diện kết nối ChatGPT.

1. URL MCP: https://mcp.speechdash.com/mcp
2. Tài nguyên OAuth: https://mcp.speechdash.com
3. Thông tin tài nguyên bảo mật: https://mcp.speechdash.com/.well-known/oauth-protected-resource
4. Máy chủ xác thực (phát hiện): https://speechdash.com/.well-known/oauth-authorization-server

Đăng nhập bằng tài khoản Speechdash khi ChatGPT yêu cầu. Các token truy cập được tạo bởi ứng dụng và được chấp nhận bởi máy chủ MCP và API công cộng.

Hướng dẫn cài đặt: Agents hub.

Công cụ

Mỗi công cụ MCP tương ứng với một điểm cuối REST:

Máy chủ cũng công khai nguồn speechdash://openapi (JSON OpenAPI trực tiếp).

MCP so với REST

Tính toán phí

Tổng hợp âm thanh MCP tính phí cho ví tín dụng giống như REST và phát lại âm thanh trên đám mây trong ứng dụng. Tạo tài liệu qua MCP không tiêu tốn tín dụng, nhưng nó được tính vào giới hạn tài liệu hàng ngày giống như ứng dụng và API REST. Gọi speechdash_get_account trước khi tổng hợp để kiểm tra số dư của bạn.

speechdash_translate_document tính phí cho ví tín dụng giống như xuất MP3 (0.5 tín dụng cho mỗi 30 giây âm thanh ước tính được khởi động). speechdash_export_document có thể trả về byte file lớn: ưu tiên txt, csv, hoặc srt trong MCP. pdf và docx là nhị phân. speechdash_update_document chấp nhận visibility cho trang chia sẻ không được liệt kê và is_archived để lưu trữ hoặc khôi phục.

Cursor hoặc Claude Desktop

Sử dụng Streamable HTTP với máy chủ MCP được host bằng khóa API cá nhân của bạn. Ví dụ .cursor/mcp.json:

{
  "mcpServers": {
    "speechdash": {
      "url": "https://mcp.speechdash.com/mcp",
      "headers": {
        "Authorization": "Bearer sh_live_your_key_here"
      }
    }
  }
}

Tạo khóa này dưới Cài đặt → API trong ứng dụng.

Phát triển cục bộ (clone kho lưu trữ)

Nếu bạn làm việc từ một bản clone của kho lưu trữ Speechdash:

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp

Tùy chọn: chỉ định một API cục bộ bằng SPEECHDASH_API_BASE=http://localhost:3003/v1 trong khi bun dev:api đang chạy.

Streamable HTTP (cục bộ)

Đối với khách hàng MCP HTTP trong quá trình phát triển cục bộ:

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:http

Điểm cuối mặc định: http://127.0.0.1:3010/mcp

Tài liệu đọc được bởi Agent

Nội dung sản phẩm có thể đọc được bởi máy cho các crawler AI:

Liên quan