Liveagent MCP Server

LiveAgent MCP服务器

MCP（模型上下文协议）服务器，提供对LiveAgent API功能的访问，使人工智能助手能够与您的LiveAgent帮助台系统交互。

LiveAgent MCP Server Demo

自定义MCP服务器开发

我们为客户开发MCP服务器。如果您需要类似于此MCP服务器的MCP服务器用于您自己的系统，请联系我们(https://www.flowhunt.io/contact/). 详细了解我们如何为客户开发MCP服务器：https://www.flowhunt.io/services/mcp-server-development/

特性

• 票务管理：列出、创建、更新和搜索票证
• 代理管理：列出代理并获取代理详细信息
• 联系人管理：列出、创建和管理客户联系人
• 部门支持：列出票务路线的部门
• 消息处理：向现有票证添加消息
• 完全检索：按查询搜索门票

安装

# Clone the repository
git clone https://github.com/yourusername/liveagent-mcp-server.git
cd liveagent-mcp-server

# Install dependencies
pip install -e .

配置

设置以下环境变量：

# Required
LIVEAGENT_BASE_URL=https://your-instance.liveagent.com
LIVEAGENT_V3_API_KEY=your_api_key_here

# Optional
LIVEAGENT_TIMEOUT=30  # Request timeout in seconds (default: 30)

您可以创建 .env 包含这些变量的项目根目录中的文件。

用法

使用克劳德桌面

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "liveagent": {
      "command": "python",
      "args": ["-m", "liveagent_mcp.server"],
      "env": {
        "LIVEAGENT_BASE_URL": "https://your-instance.liveagent.com",
        "LIVEAGENT_V3_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

票务管理

• list_tickets -列出带有过滤器的票证（状态、部门、代理）
• get_ticket -获取特定票证的详细信息
• create_ticket -创建新票证
• update_ticket -更新票证属性（状态、优先级、分配）
• add_ticket_message -向现有工单添加消息
• search_tickets -按查询搜索门票

代理管理

• list_agents -列出所有代理（带在线筛选选项）
• get_agent -获取特定代理的详细信息

联系人管理

• list_contacts -列出具有搜索功能的联系人
• get_contact -获取特定联系人的详细信息
• create_contact -创建新联系人

其他

• list_departments -列出所有部门

例子

列出未结门票

Use the list_tickets tool with status "open"

创建新票证

Use the create_ticket tool with:
- subject: "Need help with order"
- message: "Customer inquiry about order status"
- contact_email: "customer@example.com"
- priority: "high"

搜索门票

Use the search_tickets tool with query "refund"

状态代码

MCP服务器自动在人可读值和LiveAgent API代码之间进行转换。看 GetProCODES.md 获取LiveAgent API中使用的所有状态代码、通道类型和其他编码值的完整参考。

发展

贡献或修改：

1. 安装开发依赖项
2. 进行更改
3. 使用LiveAgent实例进行测试
4. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件