Elfsight AI Chatbot

npx add-mcp 'https://widget-data.service.elfsight.com/mcp/ai_chat'

Elfsight AI Chatbot — Servidor MCP

Este repositório contém a documentação e o manifesto de registro (server.json) do servidor MCP do Elfsight AI Chatbot. O servidor em si é hospedado pela Elfsight; não há nada para compilar ou executar aqui. Para ajuda, entre em contato com a Central de Ajuda da Elfsight.

Um servidor remoto Model Context Protocol sobre os dados do seu widget Elfsight AI Chatbot. Aponte um agente de IA compatível com MCP para ele e o agente poderá ler suas conversas, leads, base de conhecimento e análises — e adicionar respostas à sua base de conhecimento — sem que você precise copiar e colar nada em uma janela de chat.

O servidor é limitado à conta: depois de fazer login, o agente pode acessar todos os widgets do AI Chatbot na sua conta Elfsight, e nada mais (nenhum outro produto ou dado da Elfsight).

URL do servidor: https://widget-data.service.elfsight.com/mcp/ai_chat (HTTP Streamable).

Conectar

O login é via OAuth. Adicione a URL do servidor ao seu cliente MCP; o cliente abre uma janela do navegador, você faz login na Elfsight e aprova o acesso. Não há chave para copiar.

Claude Code

claude mcp add --transport http elfsight-ai-chatbot https://widget-data.service.elfsight.com/mcp/ai_chat

Depois execute /mcp dentro do Claude Code e escolha Authenticate para elfsight-ai-chatbot.

Cursor

Este repositório também é um plugin do Cursor: o manifesto está em .cursor-plugin/plugin.json, a conexão do servidor em mcp.json, e uma regra com notas de uso para o agente em rules/.

Para conectar sem o plugin, adicione o servidor ao .cursor/mcp.json e autentique-o quando o Cursor solicitar:

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "url": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

Cline

No Cline, abra MCP Servers → Remote Servers e adicione:

• Nome do servidor: elfsight-ai-chatbot
• URL do servidor: https://widget-data.service.elfsight.com/mcp/ai_chat
• Transporte: Streamable HTTP

Depois escolha Authenticate para o servidor e faça login na Elfsight no navegador.

O mesmo no arquivo de configurações do Cline, cline_mcp_settings.json. Versões recentes o mantêm em ~/.cline/data/settings/, versões mais antigas no User/globalStorage/saoudrizwan.claude-dev/settings/ do editor. Mantenha type: sem ele, o Cline volta ao transporte SSE legado. .vscode/mcp.json pertence ao suporte MCP integrado do VS Code; o Cline não o lê.

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "type": "streamableHttp",
      "url": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

Outros clientes

Qualquer cliente que suporte servidores MCP remotos com OAuth (registro dinâmico de cliente e PKCE) deve conectar apenas com a URL do servidor. Testamos apenas Claude Code, Cursor (através do plugin), Cline e VS Code; o trecho do VS Code abaixo é verificado, o do Windsurf é o formato usual da configuração dele.

VS Code (.vscode/mcp.json):

{
  "servers": {
    "elfsight-ai-chatbot": {
      "type": "http",
      "url": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

Windsurf (mcp_config.json):

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "serverUrl": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

O que você pode perguntar

• list_assistants — "Quais widgets do AI Chatbot eu tenho?"
• get_analytics — "Como meu AI Chatbot se saiu nos últimos 30 dias?"
• search_conversations — "Mostre-me conversas da semana passada sobre envio."
• get_conversation — "O que aconteceu na conversa <id>?"
• list_leads — "Liste os novos leads desta semana que ainda não revisei."
• search_knowledge — "Minha base de conhecimento diz algo sobre reembolsos?"
• list_knowledge_gaps — "O que os visitantes perguntam que meu assistente não consegue responder?"
• answer_knowledge_gap — "Adicione isso como uma resposta da base de conhecimento e feche essa lacuna."

answer_knowledge_gap é a única ferramenta que escreve. Três prompts prontos envolvem fluxos de trabalho comuns de ponta a ponta: weekly_report, knowledge_gaps_review, lead_followup.

Privacidade

Tudo o que uma ferramenta retorna pode ser enviado ao seu provedor de IA (Anthropic, OpenAI, etc.) como parte da sua conversa com o agente. Tenha isso em mente:

• Os campos de contato do lead são mascarados por padrão. Nome, e-mail e telefone de um lead voltam mascarados (ex.: j***@example.com, +7***4567). Passe contacts: "full" em get_conversation ou list_leads para obter os valores reais nessa chamada.
• O mascaramento cobre apenas esses campos. Texto de mensagens, URLs de páginas e links de anexos são retornados como estão. Os visitantes costumam digitar e-mail ou telefone no chat, então get_conversation pode mostrar dados de contato mesmo quando os campos do lead estão mascarados. Trate tudo o que uma ferramenta retorna como possivelmente contendo dados pessoais.
• Anexos são links, não conteúdo. Anexos de arquivos voltam como URLs, então uma chamada de ferramenta nunca coloca o conteúdo de um arquivo no contexto do modelo.

Conversas internas e de teste não são filtradas de nenhuma ferramenta — se você usar seu próprio widget para testes, espere ver esse tráfego também nos resultados.

Limites e limitação de taxa

• search_conversations, list_leads, search_knowledge e list_knowledge_gaps retornam 20 itens por padrão, no máximo 100. Um resultado truncado informa isso e reporta o total. search_conversations e list_leads paginam com cursor; para os outros dois, restrinja a consulta.
• get_conversation retorna as 100 mensagens mais recentes por padrão, no máximo 500.
• Períodos são janelas contínuas que terminam agora — 7d, 30d ou 90d. Intervalos de datas arbitrários não são suportados. list_leads também aceita nenhum período, o que significa todo o histórico.
• As solicitações são limitadas por conta e cliente. Exceder o limite retorna um 429 com um cabeçalho Retry-After — aguarde e tente novamente.

Suporte

Dúvidas ou problemas — entre em contato com a Central de Ajuda da Elfsight ou com seu gerente de conta.