MCP / API 文件

透過 MCP 將 AI 代理連接到 AliceTears 工具

1. 建立 API 權杖

先登入，再建立個人 API 權杖。權杖只會顯示一次，請妥善複製保存。

建立權杖 →
2. 連接您的 MCP 用戶端

將支援 MCP 的用戶端（Claude Desktop、Claude Code 等）指向下方端點，並將您的權杖放入 Bearer 標頭。

claude_desktop_config.json
{
  "mcpServers": {
    "alicetears": {
      "url": "https://alicetears.com/api/mcp",
      "headers": {
        "Authorization": "Bearer selat_..."
      }
    }
  }
}
3. 可用工具
translate_text

在中文、英文、泰文、日文、韓文之間翻譯文字。免費，每帳號每日上限 20 次。

  • text · string — 要翻譯的文字
  • target · "th" | "en" | "zh-TW" | "ja" | "ko" — 目標語言代碼
generate_caption

依主題產生 3 個社群文案選項與標籤。每次呼叫需要代幣，從帳號餘額扣除。

  • topic · string — 貼文的主題
  • platform · "instagram" | "tiktok" | "twitter" | "youtube" — 選填
  • tone · "playful" | "professional" | "hype" | "heartfelt" — 選填
generate_stream_title

依主題/遊戲產生 5 個直播標題選項、標籤與簡短介紹。每次呼叫需要代幣，從帳號餘額扣除。

  • topic · string — 正在直播的遊戲或主題
  • platform · "twitch" | "youtube" — 選填
  • vibe · "hype" | "chill" | "funny" | "serious" — 選填
generate_greeting

為特定場合產生 5 個祝福語選項，可選擇加入收件人姓名。每次呼叫需支付代幣，從帳戶餘額扣除。

  • occasion · "birthday" | "newyear" | "wedding" | "songkran" | "graduation" | "thankyou" | "getwell" | "farewell" — 祝福語的場合
  • recipientName · string — 選填
  • tone · "warm" | "formal" | "funny" | "poetic" — 選填
suggest_envelope_amount

根據場合與關係建議泰式紅包金額範圍。屬於社交禮儀建議，非財務建議。每次呼叫需支付代幣，從帳戶餘額扣除。

  • event · "wedding" | "ordination" | "funeral" | "newborn" | "housewarming" | "openingceremony" | "chinesenewyear" | "graduation" — 紅包的場合
  • relationship · "family" | "closefriend" | "friend" | "colleague" | "acquaintance" | "boss" — 與主人/當事人的關係
  • notes · string — 選填
detect_ai_text

檢查文字是否出自 AI：逐段標示人工、AI 生成、AI 翻譯或 AI 潤飾，並給出各類比例。每日免費 5 次（與網站共用），之後依文字 token 數計費。

  • text · string — 要檢查的文字（50–10,000 個字元）
  • locale · "th" | "en" | "zh-TW" — 選填

工具會持續增加 — 呼叫 tools/list 查看目前的清單。

4. 或直接以 curl 呼叫
curl
curl -X POST https://alicetears.com/api/mcp \
  -H "Authorization: Bearer selat_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "translate_text",
      "arguments": { "text": "สวัสดีค่ะ", "target": "en" }
    }
  }'