票点云 MCP 接入指南
在 AI 工具里对话式采集 / 开具数电发票

一、一次性配置（约 1 分钟）

TRAE

• 打开 TRAE → 右上角 设置 → MCP → 手动添加（JSON）
• 粘贴下面内容（只替换令牌，服务地址已是正式地址）：

{
  "mcpServers": {
    "piaodianyun-invoice-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.efapiaoapi.com/mcp",
      "headers": {
        "Authorization": "pdmcp_你的令牌",
        "X-Client-Version": "1.1.0"
      }
    }
  }
}

确认后状态显示 已连接 即配置成功。

Cursor

• Ctrl+Shift+J 打开 MCP 设置（或 设置 → MCP）
• Add Custom MCP → 粘贴同样的 JSON → 保存 → 状态为已连接。

其他工具

只要支持「远程 MCP / streamableHttp」：填 URL https://mcp.efapiaoapi.com/mcp，加请求头 Authorization: Bearer <令牌> 即可。

二、日常使用：像聊天一样采发票

第 1 步：提出需求

帮我采集下面这个公司 2026 年 9 月的进项发票：
纳税人识别号 9133xxxxxxxxxxxxxx
发票类型：数电专票和数电普票

AI 会先调「查询可采集发票」，发现税局未登录，会问你要账号密码。

第 2 步：提供税局账号密码

账号：13xxxxxxxxx
密码：xxxxxx

系统调用登录接口后，税局会向 办税员手机 发短信验证码，AI 会告诉你“验证码已发送到手机尾号 XXXX”。

第 3 步：回填验证码（2 分钟内）

验证码：353981

登录成功后 AI 自动继续：查询 → 发起采集 → 提示“采集任务已提交，完成后自动回传”。

第 4 步：采集完成后要明细和文件

把刚采集到的发票明细列出来
给我发票号码 23512000000032045093 的 PDF 下载地址

二·B、开数电发票（蓝票 / 红字）

蓝票开具流程

第 1 步：告诉 AI 开票信息

帮江苏xxxx信息科技有限公司 给 客户A 开一张数电专票：
货物：*生产生活服务*财税SaaS系统，数量1，单价1000，税率13%，含税
销方税号 9132xxxxxxxxxxxx，购方税号 9132yyyyyyyyyyyy
备注：2026年10月技术服务费

AI 会先确认是否已登录税局、是否需要人脸认证；需要就先走登录/人脸，再调用 tax_issue_invoice 开蓝票，返回 发票号码 + 开票日期 + 二维码。

第 2 步：拿版式文件

把刚开的这张票（发票号码 2351xxxxxxx）的 PDF 下载地址给我

（复用采集侧的 tax_invoice_file，side=xx）

红字 / 负数发票流程

这张蓝票开错了，要红冲：发票号码 2351xxxxxxx，原因 开票有误

AI 会依次：tax_issue_query（查蓝票信息核对）→ tax_red_apply（申请红字信息表，拿到 xxbbh 信息表编号）→ 若需购方确认则 tax_red_sync 同步 → tax_red_invoice（开负数发票，把 xxbbh 填到 tzdbh）。