Elfsight AI Chatbot

Elfsight AI Chatbot — MCP サーバー

このリポジトリには、Elfsight AI Chatbot MCP サーバーのドキュメントとレジストリマニフェスト（server.json）が含まれています。 サーバー自体は Elfsight がホストしているため、ここでビルドや実行を行う必要はありません。サポートが必要な場合は、Elfsight ヘルプセンターにお問い合わせください。

Elfsight AI Chatbot ウィジェットのデータにアクセスする、リモートの Model Context Protocol サーバーです。MCP 対応の AI エージェントを接続すると、会話、リード、ナレッジベース、分析データを読み取れるほか、 ナレッジベースに回答を追加することもできます。チャットウィンドウに何かをコピーして貼り付ける必要はありません。

このサーバーはアカウント単位でアクセスします。サインインすると、エージェントは Elfsight アカウント内のすべての AI Chatbot ウィジェットにアクセスできます。それ以外のデータにはアクセスできません（他の Elfsight 製品やデータにはアクセスできません）。

サーバー URL：https://mcp.elfchatbot.com/mcp（Streamable HTTP）。

接続

サインインには OAuth を使用します。MCP クライアントにサーバー URL を追加すると、クライアントがブラウザーウィンドウを開きます。Elfsight にサインインして、アクセスを許可してください。コピーするキーはありません。

Claude（claude.ai、デスクトップ、モバイル）

Elfsight AI Chatbot は Claude のコネクター一覧に掲載されています。Claude で Settings → Connectors を開き、Elfsight AI Chatbot を見つけて Connect を選択し、Elfsight にサインインしてアクセスを許可してください。Team プランおよび Enterprise プランでは、組織の Owner が最初にコネクターを追加する必要がある場合があります。サーバー URL https://mcp.elfchatbot.com/mcp を使って、カスタムコネクターとして追加することもできます。

Claude では 7 つのツールが読み取り専用として表示され、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/ にあります。

プラグインを使わずに接続するには、サーバーを .cursor/mcp.json に追加し、Cursor のプロンプトが表示されたら認証します。

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

Cline

Cline で MCP Servers → Remote Servers を開き、次を追加します。

• Server Name：elfsight-ai-chatbot
• Server URL：https://mcp.elfchatbot.com/mcp
• Transport：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 Chatbot ウィジェットを利用できますか？」
• get_analytics — 「過去 30 日間の AI Chatbot のパフォーマンスはどうでしたか？」
• search_conversations — 「先週の、配送に関する会話を表示してください。」
• get_conversation — 「会話 <id> では何がありましたか？」
• list_leads — 「今週の新しいリードのうち、まだ確認していないものを一覧表示してください。」
• search_knowledge — 「ナレッジベースに返金についての情報はありますか？」
• list_knowledge_gaps — 「アシスタントが回答できない質問を訪問者は何と尋ねていますか？」
• answer_knowledge_gap — 「これをナレッジベースの回答として追加し、そのギャップを解消してください。」

answer_knowledge_gap は書き込みを行う唯一のツールです。一般的なワークフローを最初から最後まで実行する、すぐに使えるプロンプトが 3 つあります。weekly_report、knowledge_gaps_review、lead_followup です。

プライバシー

ツールが返す情報はすべて、エージェントとの会話の一部として 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 を使ってページ分割します。他の 2 つは、クエリを絞り込んでください。
• get_conversation は、デフォルトで直近 100 件、最大 500 件のメッセージを返します。
• 期間は、現在を終点とするローリングウィンドウで、7d、30d、90d のいずれかです。任意の日付範囲は指定できません。list_leads は期間を指定しないこともでき、その場合は全期間が対象になります。
• リクエストにはアカウントおよびクライアントごとのレート制限が適用されます。制限を超えると、Retry-After ヘッダーを含む 429 が返されます。しばらく待ってから再試行してください。

サポート

ご質問や問題がある場合は、Elfsight ヘルプセンター またはアカウントマネージャーにお問い合わせください。