Elfsight AI Chatbot

Elfsight AI Chatbot — MCP 服务

此代码库包含 Elfsight AI Chatbot MCP 服务的文档和注册表清单（server.json）。服务本身由 Elfsight 托管；此处无需构建或运行任何内容。如需帮助，请联系 Elfsight 帮助中心。

一个基于你的 Elfsight AI Chatbot 小组件数据的远程 Model Context Protocol 服务。将支持 MCP 的 AI Agent 指向此服务，它就可以读取你的对话、潜在客户、知识库和分析数据，还能向知识库添加答案，无需你将任何内容复制粘贴到聊天窗口中。

此服务仅限账户范围：登录后，Agent 可以访问你 Elfsight 账户中的所有 AI Chatbot 小组件，仅此而已（不包括其他 Elfsight 产品或数据）。

服务 URL：https://mcp.elfchatbot.com/mcp（Streamable HTTP）。

连接

通过 OAuth 登录。将服务 URL 添加到你的 MCP 客户端；客户端会打开浏览器窗口，你登录 Elfsight 并批准访问即可。无需复制密钥。

Claude（claude.ai、桌面版、移动版）

Elfsight AI Chatbot 已列入 Claude 连接器目录。在 Claude 中，打开 设置 → 连接器，找到 Elfsight AI Chatbot 并选择 连接，然后登录 Elfsight 并批准访问。对于 Team 和 Enterprise 计划，组织所有者可能需要先添加连接器。你也可以使用服务 URL https://mcp.elfchatbot.com/mcp 将其添加为自定义连接器。

Claude 将七个工具列为只读工具，并将 answer_knowledge_gap 列为写入工具；在连接器页面上，你可以分别选择 Claude 调用每组工具前是否需要征求确认。

Claude Code

claude mcp add --transport http elfsight-ai-chatbot https://mcp.elfchatbot.com/mcp

然后在 Claude Code 中运行 /mcp，并为 elfsight-ai-chatbot 选择 Authenticate。

Cursor

此代码库也是一个 Cursor 插件：清单位于 .cursor-plugin/plugin.json，服务连接配置位于 mcp.json，而 rules/ 中包含供 Agent 使用的说明规则。

若不使用插件进行连接，请将服务添加到 .cursor/mcp.json，并在 Cursor 提示时进行身份验证：

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "url": "https://mcp.elfchatbot.com/mcp"
    }
  }
}

Cline

在 Cline 中，打开 MCP Servers → Remote Servers 并添加：

• 服务名称：elfsight-ai-chatbot
• 服务 URL：https://mcp.elfchatbot.com/mcp
• 传输方式：Streamable HTTP

然后为该服务选择 Authenticate，并在浏览器中登录 Elfsight。

也可以在 Cline 自己的设置文件 cline_mcp_settings.json 中进行相同配置。较新版本将其放在 ~/.cline/data/settings/ 中，较旧版本则放在编辑器的 User/globalStorage/saoudrizwan.claude-dev/settings/ 中。请保留 type：没有它，Cline 会回退到旧版 SSE 传输方式。.vscode/mcp.json 属于 VS Code 内置的 MCP 支持；Cline 不会读取它。

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "type": "streamableHttp",
      "url": "https://mcp.elfchatbot.com/mcp"
    }
  }
}

其他客户端

任何支持通过 OAuth（动态客户端注册和 PKCE）连接远程 MCP 服务的客户端，只需服务 URL 即可连接。我们仅测试过 Claude、Claude Code、Cursor（通过插件）、Cline 和 VS Code；下方的 VS Code 代码片段已验证，Windsurf 代码片段则是其配置文件的常见格式。

VS Code： 或将其添加到 .vscode/mcp.json：

{
  "servers": {
    "elfsight-ai-chatbot": {
      "type": "http",
      "url": "https://mcp.elfchatbot.com/mcp"
    }
  }
}

Windsurf（mcp_config.json）：

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "serverUrl": "https://mcp.elfchatbot.com/mcp"
    }
  }
}

可以向它询问什么

• list_assistants — “我有哪些 AI 聊天机器人小组件？”
• get_analytics — “我的 AI 聊天机器人过去 30 天表现如何？”
• search_conversations — “显示上周关于配送的对话。”
• get_conversation — “对话 <id> 中发生了什么？”
• list_leads — “列出本周新增且我尚未查看的潜在客户。”
• search_knowledge — “我的知识库中有没有关于退款的内容？”
• list_knowledge_gaps — “访客会询问哪些我的助手无法回答的问题？”
• answer_knowledge_gap — “将此内容添加为知识库答案，并填补该知识缺口。”

answer_knowledge_gap 是唯一会写入数据的工具。三个现成提示词可端到端地完成常见工作流：weekly_report、knowledge_gaps_review、lead_followup。

隐私

工具返回的所有内容都可能作为你与 Agent 对话的一部分发送给你的 AI 提供商（Anthropic、OpenAI 等）。请牢记这一点：

• 潜在客户的联系信息字段始终会被遮蔽。 在 list_leads 和 get_conversation 中，潜在客户的姓名、电子邮件和电话号码都会以遮蔽形式返回（例如 j***@example.com、+7***4567）。完整联系信息仅在 Elfsight 控制面板中提供。
• 遮蔽仅适用于这些字段。 消息文本会按访客输入的原样返回。访客经常会在聊天中输入电子邮件或电话号码，因此即使潜在客户字段已被遮蔽，get_conversation 仍可能显示联系信息。请将工具返回的所有内容都视为可能包含个人数据。
• 附件仅返回类型和文件名。 不包含文件内容，也不提供文件链接。
• 页面 URL 返回时不含查询字符串或片段。

任何工具都不会过滤内部对话和测试对话——如果你使用自己的小组件进行测试，结果中也会包含这些流量。

限制和速率限制

• search_conversations、list_leads、search_knowledge 和 list_knowledge_gaps 默认返回 20 条，最多返回 100 条。结果被截断时会注明，并报告总数。search_conversations 和 list_leads 使用 cursor 分页；另外两个工具则需要缩小查询范围。
• get_conversation 默认返回最近的 100 条消息，最多返回 500 条。
• 时间段是以当前时间为结束点的滚动窗口——7d、30d 或 90d。不支持任意日期范围。list_leads 也可以不指定时间段，这表示查询全部历史记录。
• 请求会按账户和客户端进行速率限制。超出限制时会返回带有 Retry-After 标头的 429——请等待后重试。

支持

如有疑问或遇到问题，请联系 Elfsight 帮助中心 或你的客户经理。