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 的帮助内容作答。