LiveAgent MCP服务器
MCP（模型上下文协议）服务器，提供对LiveAgent API功能的访问，使人工智能助手能够与您的LiveAgent帮助台系统交互。
自定义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中使用的所有状态代码、通道类型和其他编码值的完整参考。
发展
贡献或修改：
- 安装开发依赖项
- 进行更改
- 使用LiveAgent实例进行测试
- 提交拉取请求
许可证
MIT许可证-有关详细信息，请参阅许可证文件