AI导哈

多通道通信服务器

OMICall MCP Server是一个为OMICall和OMICRM API提供多通道通信服务的服务器，支持认证、呼叫中心、票务、多通道（Zalo、Facebook、Telegram、LiveTalk）、代理、通知、Webhook、自动呼叫和AI等功能。

  • by VIHATTeam
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 VIHATTeam/OMICALL-MCP

使用说明

OMICall MCP服务器

MCP服务器 OMICall / 奥米克姆 API。

9组80多种工具： 认证, 呼叫中心, 票, 多通道 （Zalo、Facebook、Telegram、LiveTalk）， 代理人, 通知, 网络钩子, 自动呼叫，以及 人工智能.

需求

  • Node.js 18或更新版本 (node --version).不支持较旧的运行时，它将退出并显示一条明确的消息。

快速开始

npx omicall-mcp

按平台设置

Claude Code

全球（所有项目）：

# 1. Add MCP server
claude mcp add OMICall-mcp --scope user \
  -e OMICALL_USERNAME=admin@company.com \
  -e OMICALL_PASSWORD=your-password \
  -e OMICALL_DOMAIN=your-company \
  -- npx omicall-mcp

# 2. Auto-approve all tools (no permission prompts)
claude permissions allow "mcp__OMICall-mcp__*"

持久权限 --添加到 ~/.claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__OMICall-mcp__*"
    ]
  }
}

每个项目 --添加到 .mcp.json:

{
  "mcpServers": {
    "omicall": {
      "command": "npx",
      "args": ["omicall-mcp"],
      "env": {
        "OMICALL_USERNAME": "admin@company.com",
        "OMICALL_PASSWORD": "your-password",
        "OMICALL_DOMAIN": "your-company"
      }
    }
  }
}
Claude Desktop

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "omicall": {
      "command": "npx",
      "args": ["omicall-mcp"],
      "env": {
        "OMICALL_USERNAME": "admin@company.com",
        "OMICALL_PASSWORD": "your-password",
        "OMICALL_DOMAIN": "your-company"
      }
    }
  }
}
Cursor

设置>MCP服务器>添加：

{
  "omicall": {
    "command": "npx",
    "args": ["omicall-mcp"],
    "env": {
      "OMICALL_USERNAME": "admin@company.com",
      "OMICALL_PASSWORD": "your-password",
      "OMICALL_DOMAIN": "your-company"
    }
  }
}
Windsurf

增添 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "omicall": {
      "command": "npx",
      "args": ["omicall-mcp"],
      "env": {
        "OMICALL_USERNAME": "admin@company.com",
        "OMICALL_PASSWORD": "your-password",
        "OMICALL_DOMAIN": "your-company"
      }
    }
  }
}
VS Code (Copilot / Cline)

增添 .vscode/mcp.json:

{
  "servers": {
    "omicall": {
      "command": "npx",
      "args": ["omicall-mcp"],
      "env": {
        "OMICALL_USERNAME": "admin@company.com",
        "OMICALL_PASSWORD": "your-password",
        "OMICALL_DOMAIN": "your-company"
      }
    }
  }
}

工具（80+）

认证

工具 说明
login_omicall_mcp 身份验证（自动预认证→ 租户选择→ 登录）
select_tenant 如果有多个租户，请选择租户
logout 注销并清除令牌
get_balance 账户余额
get_service_package 启用的模块和使用限制

呼叫中心 switchboard

工具 说明
search_calls 使用筛选器搜索通话记录
get_call_detail 按交易ID列出的通话详情
update_call 添加标签/注释
evaluate_call / list_eval_criteria 通话评估
click_to_call 发起出站呼叫
list_extensions / get_extension / update_extension / update_extension_status PBX分机
list_hotlines / get_hotline / update_hotline 热线管理
list_groups / create_group / update_group / delete_group 戒指组
add_group_members / remove_group_members 小组成员
list_ivr / create_ivr / update_ivr / delete_ivr IVR菜单
list_scripts / create_script / update_script / delete_script 调用脚本
list_audio / generate_tts_audio / delete_audio 音频文件

票 ticket

工具 说明
search_tickets 使用日期范围、关键字搜索
get_ticket / create_ticket / update_ticket / delete_ticket 积垢
update_ticket_status 状态更改
create_ticket_note / update_ticket_note / delete_ticket_note 注意事项
list_ticket_interactions 互动历史
create_ticket_evaluation / get_ticket_eval_criteria 评价
get_ticket_categories / ticket_statistics / transfer_tickets 类别、统计数据、转移

多通道 integrated

6个频道： 扎洛OA / Zalo个人 / 聊天功能 / Facebook帖文 / 电报 / LiveTalk

工具 说明
search_conversations 跨所有渠道搜索（日期/关键字/代理过滤器）
get_conversation / get_all_channels 对话详情、频道列表
search_channel_messages 每个通道的消息（自动通道特定端点）
send_zalo_message 通过Zalo OA发送。
send_zalo_personal_message 发送Zalo个人聊天
send_facebook_message 通过Facebook Messenger发送
send_facebook_comment 回复Facebook帖子/评论
send_telegram_message 通过Telegram机器人发送
send_livetalk_message 发送LiveTalk小部件
mark_conversation_read / transfer_conversation 行动

代理和通知

工具 说明
list_agents / get_agent / invite_agent / get_agent_pbx_info 员工管理
list_notifications / count_unread_notifications 通知
mark_notification_read / mark_all_notifications_read 马克读

网络钩子

工具 说明
list_webhooks / register_webhook / destroy_webhook Webhook CRUD（强制HTTPS）

自动呼叫 switchboard

工具 说明
autocall_by_phone TTS/录音/IVR自动呼叫
autocall_by_extension 自动呼叫内部分机

人工智能 ai

工具 说明
text_to_speech TTS有4个越南声音
register_stt_webhook 注册STT webhook

服务包门

每个工具都会自动检查您的帐户是否启用了所需的模块：

工具组 所需模块 通道子门
身份验证、代理、webhook、通知 无 --
自动呼叫中心 switchboard —
车票 ticket —
多通道 integrated 每个频道： zalo, facebook, telegram, livetalk等等。
人工智能 ai —

禁用模块返回： “您的服务包中未启用模块X。”

故障排除

npm error code ETARGET /“找不到匹配的版本” --您的本地npm元数据已经过时（刚刚发布了一个版本）。清除npx缓存并重试：

rm -rf ~/.npm/_npx
npx omicall-mcp@latest

服务器启动时断开连接 --确保你使用的是Node.js 18+(node --version).看 需求.

贡献

有关开发设置和贡献指南，请联系 VIHAT团队.

许可证

麻省理工学院

相关 MCP