mcpField
J
jivosite-mcp

jivosite-mcp

本地服务
github.com/theYahia通信协作08 周前更新

关于 jivosite-mcp

jivosite-mcp 将 MCP 客户端连接到 JivoSite API,用于处理聊天、客服、联系人、消息和 Webhook。工具支持聊天操作和客服统计,可通过 stdio 或 Streamable HTTP 启动。

主要功能

  1. 01列出聊天和客服
  2. 02搜索并创建联系人
  3. 03读取和发送聊天消息
  4. 04创建、列出和删除 Webhook
  5. 05查看活跃聊天和客服状态

适用场景

  1. 01查看当前活跃的 JivoSite 聊天
  2. 02按姓名、邮箱或电话查找联系人
  3. 03读取或发送聊天消息
  4. 04查看哪些客服在线

MCP 相关

它通过 10 个工具向 MCP 客户端提供 JivoSite 聊天、联系人、客服、消息和 Webhook 操作。支持 stdio 和 Streamable HTTP。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"theyahia-jivosite": {
"command": "npx",
"args": [
"-y",
"@theyahia/jivosite-mcp"
],
"env": {
"JIVOSITE_TOKEN": "<JIVOSITE_TOKEN>"
}
}
}
}
启动命令npx -y @theyahia/jivosite-mcp
需要配置的环境变量
JIVOSITE_TOKEN密钥API key for the service

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@theyahia/jivosite-mcp1.0.1

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
limitinteger否聊天数量
offsetinteger否偏移量

README 原文English

来自项目 README

README 暂无中文译文,以下为英文原文;中文介绍见上方。

Jivo (JivoSite) MCP — онлайн-чат с клиентами под управлением нейросети

Если вы искали, как подключить чат Jivo к ИИ-ассистенту, разобрать переписку с клиентом, ответить в диалог или собрать сводку по операторам без ручного листания истории — это оно. 10 инструментов + 2 скилла поверх JivoSite API: чаты, агенты, контакты, сообщения и вебхуки.

npm License: MIT

Часть серии Russian API MCP (50 серверов) by @theYahia.

Установка

Claude Desktop
{
  "mcpServers": {
    "jivosite": {
      "command": "npx",
      "args": ["-y", "@theyahia/jivosite-mcp"],
      "env": { "JIVOSITE_TOKEN": "your-token" }
    }
  }
}
Claude Code
claude mcp add jivosite -e JIVOSITE_TOKEN=your-token -- npx -y @theyahia/jivosite-mcp
VS Code / Cursor
{
  "servers": {
    "jivosite": {
      "command": "npx",
      "args": ["-y", "@theyahia/jivosite-mcp"],
      "env": { "JIVOSITE_TOKEN": "your-token" }
    }
  }
}
Smithery
npx @smithery/cli install @theyahia/jivosite-mcp

Требуется JIVOSITE_TOKEN. Получите в панели JivoSite -> Управление -> API.

Режимы запуска

Stdio (по умолчанию)
npx -y @theyahia/jivosite-mcp
Streamable HTTP
npx -y @theyahia/jivosite-mcp --http --port=3000
  • MCP endpoint: http://localhost:3000/mcp
  • Health check: http://localhost:3000/health

Инструменты (10)

ИнструментОписание
get_chatsСписок чатов (фильтр по статусу)
get_agentsСписок агентов (операторов)
get_contactsСписок контактов (поиск по имени/email/телефону)
create_contactСоздать контакт
get_messagesСообщения из чата по chat_id
send_messageОтправить сообщение в чат
get_webhooksСписок вебхуков
create_webhookСоздать вебхук
delete_webhookУдалить вебхук

Скиллы (2)

СкиллОписание
skill_active_chatsАктивные чаты сейчас
skill_agent_statsСтатистика операторов (онлайн/оффлайн)

Примеры

Покажи последние чаты
Список агентов JivoSite
Найди контакт по email
Покажи сообщения из чата chat-123
Какие чаты сейчас активны?
Сколько операторов онлайн?
Создай вебхук для chat_accepted

Реферальная программа JivoSite

JivoSite предлагает партнёрскую программу с пожизненной комиссией 25-35% от оплат привлечённых клиентов.

  • 25% — базовая ставка
  • 30% — от 10 привлечённых клиентов
  • 35% — от 50 привлечённых клиентов
  • Выплаты ежемесячно, пожизненно
  • Регистрация: jivo.ru/partners

Подключите JivoSite и зарабатывайте на каждом клиенте.

Лицензия

MIT


Telegram: @vhodvai

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。