← 返回博客
AI外呼

怎么让Claude或Cursor直接操作事半AI?MCP与Skill接入指南

墨子
墨子·2026年11月7日（今天）·阅读时间：6 分钟

让Claude、Cursor等支持MCP的AI Agent直接操作事半AI，需通过MCP协议配置接入，可选安装配套Skill提升调用准确率。

要点速览

  • 接入前需在事半AI后台API Key管理页创建API Key，作为Agent的身份与权限凭证。
  • Claude Desktop、Claude Code可通过编辑对应MCP配置文件，引入smartcall-agent-toolkit完成接入。
  • 安装Claude Skill可提升工具调用准确率，属于可选配置，非接入必要步骤。
  • Agent操作权限不超过API Key创建人的网页端权限，且受Key勾选的权限范围进一步收窄约束。

一、功能说明

该能力可让支持MCP协议的AI Agent（如Claude Desktop、Claude Code、Cursor）直接调用事半AI平台能力，无需手动编写接口代码，通过自然语言指令即可完成线索推送、数据查询、配置导出修改等操作。操作涉及事半AI后台API Key管理页、AI Agent客户端MCP配置文件，以及可选的Claude Skill目录。

二、准备API Key

核心结论：API Key是Agent接入事半AI的身份凭证，其可执行权限由创建人网页端权限与Key自身勾选的权限范围共同决定。 操作要点：

  1. 在后台API Key管理创建Key，并按需勾选权限范围。
  2. Agent以Key创建人身份操作，权限与其在网页端完全一致，包括可见的部门项目、企业是否开通协作项目、是否为只读角色等。
  3. Key的权限范围仅在创建人权限基础上进一步收窄，不会扩大；例如仅勾选只读时，即使创建人为企业主，Agent也只能查询、不能修改。

三、配置MCP接入

核心结论：通过在AI Agent客户端的MCP配置文件中添加smartcall-agent-toolkit服务，即可完成事半AI与Agent的连接。 操作要点：

  1. Claude Desktop编辑claude_desktop_config.json；Claude Code编辑项目中的.mcp.json或~/.claude/mcp.json，两者内容相同。
  2. 在配置文件中添加如下结构的MCP服务配置，将SMARTCALL_API_KEY替换为已创建的API Key：
{
  "mcpServers": {
    "smartcall": {
      "command": "npx",
      "args": ["-y", "smartcall-agent-toolkit"],
      "env": {
        "SMARTCALL_API_KEY": "sk_xxx"
      }
    }
  }
}
  1. 重启客户端后，让Agent执行一次verify_auth，返回Key所属企业与权限范围即表示接入成功。
  2. API地址默认为https://api.halfcall.cn，通常无需修改。

四、可选安装Claude Skill

核心结论：安装对应Skill可让Claude参考平台概念、常用流程与注意事项，提升工具调用的准确率。 操作要点：

  1. Skill是供Claude参考的使用说明，工具本身仍由MCP提供，因此需先完成MCP配置。
  2. 安装命令为：
git clone https://github.com/halfcall/agent-toolkit.git ~/.claude/skills/smartcall

五、权限规则与工具能力

权限规则

Agent操作遵循事半AI网页端权限规则，具体如下：

操作所需条件
查看数据已绑定账号（群内无需绑定）
启停项目、修改拨打时间与并发、导入导出、抓取线索、取消拨打队列、重拨、创建项目企业主、管理员、运营（外勤可重拨，不可导出）
开关意向推送与统计推送、修改推送时间、绑定推送群企业主、管理员、运营
充值企业主、管理员、运营、财务
修改提示词、开场白、音色、功能开关、提取字段、意向分级，修改项目设置企业已开通「协作项目」
更换线路、修改线路并发企业已开通「协作线路」

补充规则：

  • 非企业主、非管理员仅可操作本部门项目及未分配部门的项目。
  • 未开通协作项目或协作线路时，将提示联系管理员开通，或将修改内容转交管理员处理。

工具能力分类

Agent可调用的工具分为两类：

  • 内置工具（30个）：与接口文档中的能力一一对应，包括推送/上传/查询/撤销线索，创建项目、关联数字员工、启停、拨打配置，读写话术/音色/抽取配置，Webhook，AI呼入（开关、接听号码、来电预查），线路与音色列表，项目统计等。
  • 平台助手工具：与微信助手花花能力一致，启动时从平台自动加载。

六、FAQ

Q1：接入后如何验证配置是否成功？

重启AI Agent客户端后，让Agent执行一次verify_auth，返回Key所属企业与权限范围即表示接入成功。

Q2：Agent的操作权限可以超过创建人的网页端权限吗？

不可以。Agent的可执行范围由创建人网页端权限与Key的权限范围共同决定，Key的权限范围仅在创建人权限基础上进一步收窄，不会扩大。

Q3：安装Skill是接入的必要步骤吗？

不是。Skill是供Claude参考的使用说明，用于提升工具调用准确率，核心工具能力由MCP提供，完成MCP配置即可使用。

七、结论

通过MCP协议接入事半AI，可让支持MCP的AI Agent直接调用平台能力，简化操作流程。更多配置细节可查看事半AI官方文档站的相关说明。

其他文章