返回首页
MCP

文档

MCP 怎么接、怎么计费、出错了怎么办。

地址和认证

MCPhttps://agent.maixiaoya.com/mcpStreamable HTTP,无状态;2026-07-28 和 2025 两代协议都接
认证Authorization: Bearer myb_live_…在工作台的「应用接入」里为每个 AI 应用建一把,只显示一次
限速每把 Key 60 次/分钟,每个企业 300 次/分钟超了是工具错误 rate_limited,带 retry_after(秒)
各工具的数据来源见下表。每条结果都会注明来源和查询时间。

开通和点数

  1. 先申请内测,开通以后登录,进的就是工作台。
  2. 在工作台做企业认证:填企业全称、统一社会信用代码、法定代表人、联系人,上传营业执照。
  3. 审核通过后,企业自动开通试用点数,你成为企业的所有者,可以邀请同事。
  4. 在「应用接入」里选你在用的 AI 应用,照步骤接上。

接 MCP

在 AI 助手或智能体的 MCP 配置里加一条(不同客户端的写法略有差别,关键是地址和 Authorization 请求头):

{
  "mcpServers": {
    "maiyabang": {
      "url": "https://agent.maixiaoya.com/mcp",
      "headers": { "Authorization": "Bearer 你的 Key" }
    }
  }
}

Claude Code 用命令添加,Cherry Studio、Dify 在界面里逐项填,各家怎么填见接入方式。

连上以后,模型会看到下面的工具,以及一段使用规矩:先锚定是哪一家企业,要花钱的先问用户,只说「查到登记记录」,不说「没问题」。

工具清单

工具做什么点数试查参数
lookup_drug
查药品批准文号
按批准文号查药品的登记记录、品种状态和有效期
京源登记数据
10drugcode 国药准字Z43020255
lookup_device
查医疗器械注册证
按注册证编号或备案编号查医疗器械的注册记录
京源登记数据
10instrumentcode 国械注准20243010222
lookup_cosmetic
查化妆品注册备案
按注册证号或备案编号查化妆品的注册备案记录
京源登记数据
10cosmeticcode 国妆特字20259223
lookup_hospital
查医疗机构
按名称或机构编号查医疗机构的执业登记
京源登记数据
10name 中国医学科学院北京协和医院
lookup_enterprise_licenses
查企业许可证和备案
查药品、器械、化妆品生产经营企业的许可证或备案
京源登记数据
10entname 北京同仁堂股份有限公司
list_enterprise_certificates
查企业资质证书
列出企业名下的资质证书,可以按类型和是否有效筛
京源登记数据
10key 北京同仁堂股份有限公司
lookup_certificate
按编号查资质证书
按证书类型和编号查一张资质证书
京源登记数据
10cert_type 食品经营许可证cert_no JY31101012169813
lookup_internet_drug_cert
查互联网药品信息服务证书
查互联网药品信息服务资格证书和对应网站
京源登记数据
10certno (粤)—非经营性—2023—0165
lookup_device_online_sales
查医疗器械网络销售备案
查企业的医疗器械网络销售备案和网站
京源登记数据
10entname 阿里健康大药房医药连锁有限公司
lookup_icp
查网站 ICP 备案
按单位名称、统一社会信用代码或网站域名查 ICP 备案
京源登记数据
10key baidu.com
lookup_enterprise_basic
查企业登记信息
按企业名称或统一社会信用代码查工商登记信息
京源登记数据
20key 北京同仁堂股份有限公司
lookup_enterprise_abnormal
查企业经营异常(按次计费)
查企业是否在经营异常名录里,以及列入和移出记录;按次扣点,要先确认
京源登记数据
50先确认key 北京同仁堂股份有限公司
list_trademarks
查企业商标
列出企业名下的商标,可以按分类和状态筛
京源登记数据
20key 北京同仁堂股份有限公司
get_trademark
查商标详情
按商标查询号查商标的商品服务、专用权期限和流程
京源登记数据
20mark_key 85558609
list_patents
查企业专利
列出企业名下的专利,可以按类型和申请号筛
京源登记数据
20key 北京同仁堂股份有限公司
list_copyrights
查企业著作权
列出企业名下登记的软件著作权和作品著作权
京源登记数据
20key 北京同仁堂股份有限公司
list_time_honored_brands
查老字号
查企业名下的中华老字号和省级老字号
京源登记数据
20entname 中国北京同仁堂(集团)有限责任公司
verify_registration
核对证号和持有人
按证号核对登记记录、持有人是否一致和有效期
京源登记数据
10number 国药准字Z43020255
check_licence_fields
校验证照上读出的字段
按国标和证号写法校验从证照上读出的信用代码、证号和日期,不查记录、不扣点
固定规则校验
0creditcode 91110000MA00000A9Plicence_kind 药品经营许可证licence_no 京AA010000001
get_usage
查本企业的点数和用量
查本企业的点数余额和近几天的调用、扣点,不扣点
账户用量账本
0days 7

返回格式

「查没查到」(match)和「在不在有效期」(validity)分开写。同名多家时 status 是 candidates,只给候选,不扣点;让用户选定后用统一社会信用代码重查。工具的结果里,structuredContent 含数据来源(source)、原查询时间(queried_at)和演示标记(demo)。content 里是一句结论,后面跟着同样的 JSON。下面用一条演示记录展示格式。

{
  "status": "ok",
  "tool": "lookup_drug",
  "match": "matched",
  "record": { "批准文号": "国药准字H20990001", "品种状态": "正常", "有效期至": "2030-04-15", … },
  "validity": { "state": "valid", "basis": "有效期至 2030-04-15" },
  "source": "麦芽帮 · 非官方数据,以官网为准",
  "demo": true,
  "demo_notice": "演示数据,不代表真实查询结果",
  "queried_at": "2026-11-09T14:30:00.000+08:00",
  "cached": false,
  "notice": "这是登记记录的核对结果,不代表质量判断或用药建议。…",
  "usage": { "points": 10, "balance": 9990 },
  "trace_id": "6f1c…"
}

错误码

连接这一层出错(没带 Key、Key 不对、企业停用、认证失败太多次)回 HTTP 状态码,响应体是 {code, message, trace_id}。调工具时出的错是工具错误:结果里 isError 为真,structuredContent 是同样的 {code, message, trace_id};参数不合工具的 inputSchema 时,MCP 直接回工具错误,只有一段说明哪个参数不对的文字。点数不够、没开通、被限速都是工具错误,不会回 401/403,客户端不会反复去授权。

code怎么回什么时候
unauthorizedHTTP 401没带 Key,或 Key 无效、已作废、已过期
forbiddenHTTP 403所在企业的账号已停用
rate_limitedHTTP 429、工具错误认证失败太多次(HTTP 429),或调用太快(工具错误);看 retry_after(秒)
invalid_input工具错误参数不对,或 confirm_token 对不上、已过期
quota_exhausted工具错误企业的点数不够了
entitlement_required工具错误企业还没开通试用点数
source_unavailable工具错误数据源暂时不可用,没有扣点
confirmation_required不算错误按次计费的查询:第一次只回报价和 confirm_token(status 是 confirmation_required)

扣点规则

  • 有结论才扣:查到、没查到都算结论。
  • 同名多家只给候选,不扣;用户选定后重查的那一次扣。
  • 同一个企业、同样的参数,10 分钟内再查,返回缓存结果,不扣,并标出原来的查询时间。
  • 参数错、被限速、点数不够、数据源出错,都不扣。
  • 经营异常按次计费:第一次只报价,带 confirm_token 确认后才扣。令牌 10 分钟有效,只能用一次。