Elfsight

Elfsight — MCP 服务

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

这是一个通过你的 Elfsight 工作区提供服务的远程 Model Context Protocol 服务。让支持 MCP 的 AI Agent 连接到它，即可浏览你的应用、项目和小组件，从模板创建小组件、更改其设置、发布小组件并获取安装代码，而无需你逐一点击控制面板。

此服务按工作区进行范围限定：登录时，你会选择一个 Elfsight 工作区，Agent 只能访问该工作区中的应用、项目和小组件。

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

连接

登录采用 OAuth。将服务 URL 添加到你的 MCP 客户端；客户端会打开浏览器窗口，你登录 Elfsight、选择工作区并批准访问。无需复制密钥。

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

在 Claude 中，打开 Settings → Connectors，选择 Add custom connector 并输入服务 URL https://mcp.elfsight.com/mcp，然后登录 Elfsight 并批准访问。在 Team 和 Enterprise 计划中，组织 Owner 可能需要先添加此连接器。

Claude 会将九个工具列为只读工具，将六个工具列为写入工具；在连接器页面中，你可以分别选择 Claude 在调用每组工具前是否先征求确认。

Claude Code

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

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

Cursor

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

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

{
  "mcpServers": {
    "elfsight": {
      "url": "https://mcp.elfsight.com/mcp"
    }
  }
}

Cline

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

• 服务名称：elfsight
• 服务 URL：https://mcp.elfsight.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": {
      "type": "streamableHttp",
      "url": "https://mcp.elfsight.com/mcp"
    }
  }
}

其他客户端

任何支持通过 OAuth（动态客户端注册和 PKCE）连接远程 MCP 服务的客户端，都应只需服务 URL 即可连接。

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

{
  "servers": {
    "elfsight": {
      "type": "http",
      "url": "https://mcp.elfsight.com/mcp"
    }
  }
}

Windsurf（mcp_config.json）：

{
  "mcpServers": {
    "elfsight": {
      "serverUrl": "https://mcp.elfsight.com/mcp"
    }
  }
}

可以向它提问什么

读取：

• list_app_catalog — “有哪些 Elfsight 应用？”
• list_account_apps — “我的工作区里有哪些应用？”
• list_projects — “列出我的项目。”
• list_widgets — “显示 Landing 项目中的 Instagram Feed 小组件。”
• get_widget — “小组件 <id> 当前的设置是什么？”
• get_widget_limit — “我还可以创建多少个 Google Reviews 小组件？”
• list_widget_templates — “Pricing Table 应用有哪些模板？”
• get_install_code — “给我这个小组件的嵌入代码。”
• get_widget_edit_links — “给我在 Dashboard 中编辑这个小组件的链接。”

写入：

• create_widget — “使用 Black Friday 模板创建一个 Countdown Timer。”
• duplicate_widget — “复制这个小组件。”
• rename_widget — “将它重命名为 Homepage reviews。”
• update_widget_settings — “更改标题文本和强调色。”
• publish_widget — “发布更改。”
• discard_widget_changes — “丢弃未发布的更改。”

小组件更改的工作方式

• 小组件基于模板创建。 create_widget 需要应用别名，以及该应用的一个有效模板（来自 list_widget_templates）。新小组件会立即发布；如果达到应用的小组件数量上限，则会保存为草稿（status: DRAFT）。
• 设置更改在发布前都是草稿。 update_widget_settings 会将 JSON Merge Patch 应用于未发布的修订版本：对象会合并，null 会移除键，数组会整体替换。调用 publish_widget 前，网站仍会显示已发布的版本；discard_widget_changes 会丢弃草稿。此草稿与 Dashboard 编辑器共享，因此发布或丢弃也会涵盖你在其中所做的任何未发布编辑。
• 打开发布链接即会发布。 get_widget_edit_links 会返回 editUrl 和 publishUrl；在已登录 Elfsight 的浏览器中打开 publishUrl，即可立即发布草稿。
• 敏感设置受到保护。 每个应用都会声明受限设置（机密信息、已连接的账户等）。对这些设置的更改会被拒绝；请在 Dashboard 中编辑。
• 不会删除任何内容。 服务不提供删除小组件或项目的工具。

隐私

工具返回的所有内容都可能作为你与 Agent 对话的一部分发送给 AI 服务提供商（Anthropic、OpenAI 等）。小组件设置包含你填入小组件的任何内容——文本、链接、图片，以及某些应用中的联系方式。请妥善处理工具结果。

限制与速率限制

• list_widgets 和 list_widget_templates 会分页返回，每页最多 100 项（page、itemsPerPage）。
• 请求按客户端进行速率限制：每分钟 60 次工具调用。超过限制会返回带有 Retry-After 标头的 429 响应——请等待后重试。

支持

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