MCP server (AI agents)

透過 MCP 把 AskAIs 接到你的 AI 編程工具，在 Claude Code、Cursor 或 ChatGPT 裡一句話就搭好一個免費客服掛件。不用打開後台、不用填註冊表單，直接讓助手跑一次 singchat_setup，它會回傳一個能用的掛件和一條短期、單次使用的瀏覽器認領連結。信箱、密碼和長期 API Key 都不會回傳給模型。

伺服器走 streamable HTTP，端點是：

https://mcp.singchat.org

接入方式

MCP 只是一個 HTTPS 端點，所以它並不限於命令列工具。桌面 app（比如 Claude Desktop，Mac 和 Windows）和 ChatGPT 桌面版都支援它，claude.ai 網頁版和 ChatGPT 網頁版也支援（透過 connector 或開發者模式）。能不能加，取決於用戶端 app，而不是傳輸方式。

Claude Code

一條命令加上伺服器：

claude mcp add --transport http singchat https://mcp.singchat.org

在瀏覽器完成認領後，頁面會只顯示一次新的 MCP Key。把它帶上，工具就能繼續管理你的工作區：

claude mcp add --transport http singchat https://mcp.singchat.org \
  --header "Authorization: Bearer sl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Cursor

在 ~/.cursor/mcp.json（或專案裡的 .cursor/mcp.json）加一條：

{
  "mcpServers": {
    "singchat": {
      "url": "https://mcp.singchat.org"
    }
  }
}

有了 key 之後，放到 Authorization 標頭裡：

{
  "mcpServers": {
    "singchat": {
      "url": "https://mcp.singchat.org",
      "headers": {
        "Authorization": "Bearer sl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

ChatGPT / OpenAI

開發者模式（全部工具）。在付費的 ChatGPT 套餐（Plus、Pro、Business 或 Edu）下，打開 設定，Connectors（或 Apps），開啟 開發者模式（Developer mode），然後加一個遠端 MCP app，位址填：

https://mcp.singchat.org

接著讓 ChatGPT 跑一次 singchat_setup，它會開一個免費工作區並回傳掛件嵌入代碼及短期認領連結。請你本人開啟連結、設定登入資料，再把瀏覽器只顯示一次的 MCP Key 加入用戶端設定。

作為 connector（公司知識 / deep research）。AskAIs 同時提供 ChatGPT connector 需要的兩個唯讀工具 search 和 fetch，所以你也可以把同一個位址加為 ChatGPT connector。不帶 API key 時它會用 AskAIs 自己的說明內容回答；帶工作區 API key 時則搜尋並讀取該工作區的知識庫。

官方 OAuth 工作區連接器。ChatGPT、Codex 或 Claude 官方插件目錄請使用 https://connect.singchat.org/mcp。該端點透過 AskAIs OAuth 連接現有工作區，不會要求在聊天中貼上 API Key。

Gemini（Gemini CLI）

把同一個位址加到 Gemini CLI 的 settings.json 裡的 mcpServers 物件中：

{
  "mcpServers": {
    "singchat": {
      "url": "https://mcp.singchat.org"
    }
  }
}

消費版 Gemini app 目前還沒有簡單的「新增 MCP」按鈕，所以請走 Gemini CLI（或 API）這條路。

僅支援 stdio 的用戶端

對於只支援 stdio 的 MCP 用戶端，用 mcp-remote 橋接到遠端伺服器：

npx mcp-remote https://mcp.singchat.org

零註冊

你不用先註冊。第一次在沒帶 key 的情況下讓助手跑 singchat_setup，AskAIs 會自動幫你開一個免費工作區，並回傳：

• 一條 15 分鐘內有效、只能使用一次的瀏覽器認領連結
• 一段可直接貼到網站的 網頁嵌入代碼
• 新工作區的公開 App ID 和後台位址

請你本人開啟認領連結，在 AskAIs 瀏覽器頁面設定信箱和密碼。認領成功後，頁面會只顯示一次新的 MCP Key；把它填進 MCP 設定的 Authorization: Bearer 標頭。Key 不會透過 MCP 工具、URL 或模型對話回傳。

認領連結 15 分鐘後失效並且只能使用一次。若連結過期，已認證的臨時工作區可以執行 claim_account 重新簽發。

工具清單

每個工具都作用在與你 API key 綁定的工作區上，不接受任何租戶參數。

• singchat_setup：沒帶 key 時開一個免費工作區並回傳嵌入代碼和短期認領連結；帶 key 時回傳本工作區的嵌入代碼和連結。
• get_embed_snippet：拿到網站嵌入代碼（純 HTML、React、Next.js 三種）。
• claim_account：為已認證的臨時工作區重新簽發短期、單次使用的瀏覽器認領連結。
• list_conversations：列出最近的會話，帶最新一條訊息和狀態。
• get_conversation：取單個會話及其完整訊息歷史。
• reply_to_conversation：以客服身分往會話裡發回覆（訪客側即時看到）。
• resolve_conversation：把會話標記為已解決。
• add_knowledge：給 AI 添加知識，爬取一個網址，或存一條問答。
• list_knowledge：列出知識文件及其處理狀態。
• search_knowledge：對知識庫做語意搜尋，回傳命中的片段。
• configure_agent：設定 AI 客服（開關、模型、系統提示詞、歡迎語）。
• set_keywords：添加一條關鍵詞自動回覆規則。
• manage_faq：列出、新建、更新或刪除 FAQ 條目。
• get_analytics：讀取工作區數據統計（會話、訊息、解決率），按天數取。
• search 和 fetch：ChatGPT connector 用的兩個唯讀工具。帶 key 時搜尋並讀取你的知識庫；不帶 key 時用 AskAIs 的說明內容作答。