MCP 服务接入
返回首页 获取访问令牌

智收云 MCP 服务

把不良资产(NPA)债权转让与处置公告、债务企业及其债务概要数据,封装为 4 个只读 MCP 工具, 供 Claude、WorkBuddy、Cursor、Cherry Studio、扣子等 MCP 客户端直接调用; 一句话即可生成某家企业的公开公告债务画像(债务规模、关联方、公告时间线、担保线索)。

30 万+ 公告数据 MCP Streamable HTTP 4 个只读工具 企业公告债务画像 访问令牌(PAT)接入
1服务简介

智收云(debtop.com)沉淀 30 万+ 不良资产(NPA)债权转让与处置公告数据, 数据源覆盖报纸电子版、AMC 官网、产权交易所、阿里资产、京东法拍等。 服务以 MCP(Model Context Protocol)托管服务形式提供,无需本地部署,开箱即用。

服务端点 https://agent.debtop.com/mcp/debt/stream
传输方式 Streamable HTTP(支持 POST / GET / DELETE)
认证方式 访问令牌(PAT),请求头 Authorization: Bearer <PAT>
服务名称 debtop-debt(客户端配置中的 server 标识)
工具数量 4 个,均为只读查询(公告搜索 / 公告详情 / 企业搜索 / 企业债务概要)
支持场景 企业公告债务画像、债权公告检索、债务企业查询、担保线索(保证人 / 抵押物)、关联方延伸
数据覆盖 报纸电子版、AMC 官网、产权交易所、阿里资产、京东法拍等多源公告
索引维度 债务企业索引为债务人(融资方)维度——公告中 debtor 列出的企业可查到; 用 creditor(AMC / 银行等出让方)名称查询返回 0 命中属正常现象
权限范围 notice:read enterprise:read
2快速开始
1
获取访问令牌(PAT)

登录智收云后进入 控制台, 在「连接配置」中即可看到你的访问令牌。令牌默认以掩码显示, 点击「显示」查看明文,点击「复制」可直接复制含真实令牌的完整配置。

每个账号使用自己的令牌;令牌与账号权限、会员配额绑定,请妥善保管。
2
在 MCP 客户端中填写配置

将下面的配置粘贴到客户端的 MCP 配置文件中,并把 <你的 PAT> 替换为上一步复制的令牌:

{
  "mcpServers": {
    "debtop-debt": {
      "type": "streamableHttp",
      "url": "https://agent.debtop.com/mcp/debt/stream",
      "headers": {
        "Authorization": "Bearer <你的 PAT>"
      },
      "timeout": 30000
    }
  }
}

部分客户端只需填写服务地址与请求头,字段名可能略有差异(如 headers、auth), 按客户端说明对应填写即可。

3
验证连通

保存配置后在客户端中调用一次工具列表;也可以用下面的命令自测(把 <你的 PAT> 换成真实令牌):

curl -X POST https://agent.debtop.com/mcp/debt/stream \
  -H "Authorization: Bearer <你的 PAT>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
返回工具列表即表示连通成功;若返回 401,请检查令牌是否填写正确、是否已过期或在控制台被吊销。

在其他客户端中使用

任何支持 Streamable HTTP 的 MCP 客户端都可以接入,只需「服务地址 + 请求头」两项信息:

客户端 填写方式
Claude Desktop / Claude Code 在 MCP 配置中新增 server,type 选 http / streamableHttp,填入服务地址与 Authorization 请求头
WorkBuddy 连接器配置中填入服务地址与访问令牌(PAT)
Cursor Settings → MCP → Add new MCP server,URL 模式填服务地址,请求头填 Authorization: Bearer <PAT>
Cherry Studio 添加 MCP 服务器,类型选 Streamable HTTP,填服务地址与请求头
扣子 / 自研脚本 以 HTTP 请求调用服务地址,携带 Authorization 请求头即可
3通用约定
约定 说明
参数命名 入参统一 snake_case:page_size / notice_id / enterprise_id。 旧的驼峰写法(pageSize / noticeId / enterpriseId)仍可被接受, 但新代码请一律使用下划线(驼峰仅作过渡,后续可能移除)。
ID 为纯数字(int64) 公告 ID(notice_id)、企业 ID(enterprise_id)都是纯数字, 须从上一步搜索结果中取得,不要臆造或加前缀;ID 参数整数与字符串都可传,搜索结果里是整数,直接回传即可。
分页 列表类接口返回统一分页结构 { total, page, page_size, total_page, items }; page_size 默认 10,工具接受 1–100,但上游按 20 截断 (传更大值只会拿到 20 条,响应里 page_size 回显 20)。需要更多结果请翻页。
金额字段成对返回 每个金额都有两个字段:*_yuan(number,精确数值,用于比较、求和、换算)与 *_text(string,已格式化文本,如 "1.2万元")。 需要计算/排序时用 *_yuan,直接展示给用户时用 *_text,两者不要混用或自行换算。
返回包装 所有接口返回 { success, code, message, data }。 success=false 时 data 可能为 null,应读取 code / message 判断原因(见「6 错误处理」)。 注意:工具级错误仍以 HTTP 200 返回,需读取返回体内的 isError / code 才能发现。
条件字段可能整体缺失 guarantor(保证人)、collateral(抵押物)、original_creditor(原债权人) 仅在公告披露时才出现,可能整个 key 不存在(不是 null)。 取值前先判断字段是否存在;未披露时展示为「公告未披露」,不要编造。
debtor 是多主体串 一条公告常含多个债务人,debtor 以逗号分隔(如 甲公司,乙公司), debtor_num 即主体个数。做关联方延伸或按主体统计时,先按逗号拆分再逐个使用,不要把整串当作一个企业名。
关联方只返回前 3 related_creditors / related_debtors 各只返回前 3 个; 完整数量以 related_creditor_count / related_debtor_count 为准,不要以数组长度冒充总数。
详情链接 detail_url 为智收云站内详情页链接,形如 …/notice/<公告ID> 或 …/debtor/<企业ID>; 引用公告或企业时务必附上。全部按接口返回值原样使用,不要改写、缩短或猜测。
链接来源标识 source 输出链接时需追加查询参数 source=<客户端标识>(这是对 detail_url 唯一允许的改动): 无查询参数用 ?source=…、已有参数用 &source=…、已有 source 则覆盖其值,同一链接内不得出现两个 source。 取值为小写英文 + 短横线(如 workbuddy、qwen-office、cursor),判断不出时用 mcp。
调用节奏 按「企业搜索 → 债务概要 → 公告搜索 → 详情」顺序串行执行,相邻调用间隔至少 1 秒; 配额为共享资源,不要并发突发或压测。
4可用工具

共 4 个 MCP 工具,均可通过客户端暴露的名称(如 mcp__debtop-debt__*)调用。

search_debt_notice notice:read 债权公告搜索

按关键词分页搜索债权转让/处置/招商等公告,返回公告列表。

入参
参数 类型 必填 说明
keyword string 是 搜索关键词(企业名称、债权人、债务人均可);空值报 PARAM_INVALID: keyword 不能为空
page integer 否 页码,默认 1
page_size integer 否 每页数量,默认 10;工具接受 1–100,上游按 20 截断
返回 data.items[] 字段
字段 类型 说明
notice_idinteger公告 ID(详情查询用)
titlestring公告标题
notice_typestring公告类型代码,见下方枚举
notice_type_namestring公告类型中文名
sourcestring公告来源
notice_datestring公告日期,yyyy-MM-dd
creditorstring债权人(受让方)
original_creditorstring原债权人(转让方)。条件字段:转让类公告常见,可能整体缺失
debtorstring债务人,逗号分隔的多主体串(如 甲公司,乙公司),使用前先拆分
debtor_numinteger债务人主体个数(户数)
areastring归属地
principal_amount_yuan / principal_amount_textnumber / string公告债权本金(数值 / 展示文本)
total_amount_yuan / total_amount_textnumber / string公告债权总额(数值 / 展示文本)
detail_urlstring公告详情页链接(形如 …/notice/<公告ID>);引用时附上并带 source
notice_type 枚举
代码 含义
transfer转让公告
deal处置公告
market招商公告
collect催收公告
correct更正公告
trade处置挂牌
get_debt_notice_detail notice:read 债权公告详情

按公告 ID 查询单条公告的完整详情。

入参
参数 类型 必填 说明
notice_id integer | string 是 公告 ID,取自 search_debt_notice 返回的 notice_id(整数或字符串均可)
返回字段

等于列表项全部字段,额外增加下列条件字段——仅在公告披露时才出现,可能整体缺失(key 不存在,不是 null):

字段 类型 说明
guarantorstring保证人(催收类公告通常有)
collateralstring抵押物(催收类公告通常无,需判空)
original_creditorstring原债权人(转让类公告常见)

字段差异提示:催收类公告通常有 guarantor 而无 collateral; 转让类公告两者都可能缺失,但常多出 original_creditor。取值前先判断 key 是否存在。

search_debt_enterprise enterprise:read 债务企业搜索

按关键词分页搜索债务企业(企业画像的入口工具)。

入参
参数 类型 必填 说明
keyword string 是 单一企业名称(不要传逗号分隔的多主体串);过宽的词会被拒 (PARAM_INVALID: 搜索内容过于宽泛),请用企业全称或较完整的简称
page integer 否 页码,默认 1
page_size integer 否 每页数量,默认 10;工具接受 1–100,上游按 20 截断
返回 data.items[] 字段
字段 类型 说明
enterprise_idinteger债务企业 ID(概要查询用)
enterprise_namestring债务企业名称
detail_urlstring债务企业详情页链接(形如 …/debtor/<企业ID>);引用时附上并带 source
索引为债务人(融资方)维度:用 creditor(AMC / 银行等出让方)名称查询通常 0 命中,属正常现象,不是故障。
get_debt_enterprise_debt_summary enterprise:read 债务企业债务概要

按企业 ID 查询该债务企业的公告债务汇总(转让类 + 处置招商类分别统计)。

入参
参数 类型 必填 说明
enterprise_id integer | string 是 债务企业 ID,取自 search_debt_enterprise 返回的 enterprise_id(整数或字符串均可)
返回字段
字段 类型 说明
enterprise_idinteger债务企业 ID
enterprise_namestring债务企业名称
transfer_notice_countinteger转让公告数量
transfer_principal_total_yuan / _textnumber / string转让公告债务本金合计
transfer_interest_total_yuan / _textnumber / string转让公告债务利息合计
disposal_notice_countinteger处置招商公告数量
disposal_principal_total_yuan / _textnumber / string处置招商公告债务本金合计
disposal_interest_total_yuan / _textnumber / string处置招商公告债务利息合计
related_creditorsstring[]相关债权人,最多返回 3 个
related_creditor_countinteger相关债权人总数(可能大于数组长度)
related_debtorsstring[]相关债务人,最多返回 3 个
related_debtor_countinteger相关债务人总数(可能大于数组长度)
related_sourcesstring相关公告来源,最多展示 2 个,超出以「等」结尾
related_notice_periodstring相关公告时段,yyyy-MM-dd ~ yyyy-MM-dd
detail_urlstring债务企业详情链接
related_creditors / related_debtors 仅返回前 3 个; 若需完整数量请以 related_creditor_count / related_debtor_count 为准。
5典型场景与流程

5.1 企业公告债务画像

给定一家企业名称,用 4 个工具串起来输出其在公开公告口径下的债务画像:主体概览、债务规模、 公告时间线、担保线索、关联方延伸,每条引用都附详情页链接。

  1. 定位主体 — search_debt_enterprise(keyword=企业名):命中 1 条直接用其 enterprise_id;命中多条时列出候选让用户确认(同名企业未确认归属前不得合并);0 命中或报「搜索内容过于宽泛」时换更完整的全称重试一次,仍不行则按下方降级路径从公告切入
  2. 取规模数据 — get_debt_enterprise_debt_summary(enterprise_id=...):转让 / 处置两个口径的公告数、本金与利息合计、关联方、公告时段
  3. 拉时间线明细 — search_debt_notice(keyword=企业名, page_size=20),每条结果的 detail_url 都要保留;超过 20 条时翻页或改用关联债务人名收窄
  4. 补担保线索 — 对金额最大或最新的 1~3 条调用 get_debt_notice_detail(notice_id=...),取 guarantor / collateral
  5. 扩展关联方 — 从 related_debtors、debtor(逗号分隔,先拆分)、creditor 取名称,逐个再跑 search_debt_notice
请克制调用次数(配额共享):一次画像建议控制在 15 次工具调用以内,避免不必要的翻页与重复查询;相邻调用间隔至少 1 秒。
画像输出骨架(可直接作为回答结构)
## {企业名称} 债务画像

> 数据来源:智收云公开债权公告({N} 条)|查询时间:{yyyy-MM-dd HH:mm}|口径:公开公告,非征信报告

1. 主体概览 —— 企业名称(链到企业详情页)、企业 ID、关联公告时段、
   相关债权人(共 N 家)、相关债务人(共 N 户)、数据来源渠道
2. 债务规模 —— 转让类 / 处置·招商类:公告数、本金合计、利息合计
3. 公告时间线(按日期倒序,最多 20 条)—— 日期、类型、标题、债权人、本金、链接
4. 担保与标的 —— 抵押物、保证人、公告详情链接(未披露的写「公告未披露」)
5. 关联方延伸 —— 名称:命中 X 条公告,涉及本金 Y
6. 提示 —— 公开公告口径;金额 _yuan / _text 口径说明;链接为接口返回值(已带 source)
企业维度取不到数据时(如关键词过宽或对具体全称仍 0 命中):改用 search_debt_notice(keyword=企业名, page_size=20) 从公告切入, 用 creditor / original_creditor / debtor / 金额 / notice_date 产出「债务规模 + 时间线 + 关联方」,并如实说明未取得企业维度概要,不得用公告数据反推企业概要结论。

5.2 定向检索与串联

  1. 搜索公告:用户给出企业/人名关键词 → search_debt_notice(keyword=...),从 items[].notice_id 取公告 ID
  2. 查详情:拿到公告 ID 后 → get_debt_notice_detail(notice_id=...),补充保证人、抵押物
  3. 搜企业:用户想找某债务企业 → search_debt_enterprise(keyword=...),从 items[].enterprise_id 取企业 ID
  4. 查债务概要:拿到企业 ID 后 → get_debt_enterprise_debt_summary(enterprise_id=...)
  5. 串联:企业链路搜到的相关债权人/债务人,可再作为 search_debt_notice 的 keyword 进一步检索

示例问法

场景 示例
企业债务画像 「XX 公司」欠了多少钱 / 有多少债务 / 债务情况怎么样
债务画像报告 帮我做个「XX 公司」的债务画像 / 风险画像
担保线索 「XX 公司」有哪些抵押物和保证人
公告搜索 帮我搜索关于「某某公司」的债权转让公告
企业债务概要 查一下这家债务企业的债务概要
近期公告 看看最近有哪些不良资产处置公告
6错误处理

所有接口返回统一为 { success, code, message, data }。success=false 时读取 code / message:

务必区分两类错误:工具级错误以 HTTP 200 返回(返回体内 isError=true,看 code / 文案), 只有鉴权、限流、网关类错误才表现为 4xx / 5xx。只看 HTTP 状态码会把工具级错误当成成功。
返回 含义 处理方式
401 / AUTH_REQUIRED / AUTH_INVALID / TOKEN_EXPIRED 无凭据或凭据失效——两者响应相同,无法区分 检查请求头中的 PAT 是否正确;在控制台重新复制令牌;已失效则重新生成并更新客户端配置
INSUFFICIENT_SCOPE / PERMISSION_DENIED 权限不足(工具级错误,HTTP 仍为 200) 说明需要对应权限(notice:read / enterprise:read)
PARAM_INVALID 参数错误 常见触发:keyword 为空、page_size 超过工具校验上限 100、 关键词过宽(搜索内容过于宽泛)。改用完整企业全称并检查参数后重试
RESOURCE_NOT_FOUND 企业 / 公告不存在 换 ID 或用全称重查,不要臆造 ID
429 / RATE_LIMITED 已触达限流(说明链路本身是通的) 指数退避后重试,降低并发,不要短时间内重复画像同一主体
GUEST_LIMITED 游客通道限流(工具级错误,HTTP 仍为 200) 退避 1 秒后重试;串联工具时保持串行(相邻调用间隔 ≥1 秒)
UPSTREAM_TIMEOUT / INTERNAL_ERROR 上游异常 稍后重试;连续 5xx / 超时时降级为「仅公告搜索」并提示用户稍后再试,不要反复重试放大故障

连接失败 / DNS 失败 / 超时 / 非 401 的 4xx(404、405 等): 说明服务不可达或路径不对,属「未接入」类问题,如实排查地址与网络即可,不要反复重试。

7合规与限流

本服务输出的是公开公告数据,结论可能被用于尽调、合作判断或对外材料,请遵守以下要求:

要求 说明
标注来源与时间 必须标注数据来源(智收云公开公告)与查询时间
口径声明 必须声明「公开公告口径,非征信报告」;不得用公告数据推断未披露债务、偿付能力或信用等级, 也不做超出数据的因果与法律结论
同名企业不合并 同名企业未确认归属前不得合并统计;命中多条时列出候选让用户确认
只读、禁止批量导出 4 个工具均为只读查询,禁止整库拉取、爬取或长期归档;分页实际按 20 截断,需要更多请翻页并控制节奏
限流为共享配额 超限返回 429 会影响其他用户,不要做压测或并发突发;同一主体的画像避免短时间重复执行
调用节奏 串行调用,相邻调用间隔至少 1 秒;一次完整画像建议控制在 15 次工具调用以内
异常优先降级 连续 5xx / 超时时先降级为「仅公告搜索」,并提示「企业维度数据暂不可用,请稍后重试」
令牌使用范围 访问令牌仅授权用于 agent.debtop.com,不得用于其它部署或域名
本页数据为公开公告口径,存在滞后与不全的可能,不构成征信报告或投资建议;使用前请自行核实。
8常见问题
Q1:接入需要申请应用、配置回调地址吗?
不需要。登录后在控制台复制访问令牌(PAT),填到客户端的 Authorization 请求头即可,无需注册应用或配置回调。
Q2:访问令牌(PAT)在哪里查看?
登录智收云后进入控制台,「连接配置」中的 Authorization 即你的令牌。令牌默认隐藏,点击「显示」查看明文,点击「复制」直接复制完整配置。
Q3:令牌会过期吗?
令牌默认有效期 90 天,且可随时吊销。若调用返回 AUTH_INVALID / TOKEN_EXPIRED,请在控制台重新生成并更新客户端配置。
Q4:令牌应该如何保管?
令牌等同于账号权限,请勿提交到公开代码仓库、前端页面或分享给他人。建议通过客户端的环境变量或本地密钥文件管理;一旦泄露请立即在控制台吊销并重新生成。
Q5:调用次数有限制吗?
调用计入你的会员配额,具体额度以官网配额说明为准;触发限流时接口返回 RATE_LIMITED,稍后重试即可。
Q6:支持哪些 MCP 客户端?
任何支持 Streamable HTTP 的客户端均可接入,包括 Claude、WorkBuddy、Cursor、Cherry Studio、扣子以及自研脚本。
Q7:为什么用债权人(AMC / 银行)名称查企业查不到?
债务企业索引是债务人(融资方)维度,只有公告中 debtor 列出的企业能查到;用 creditor(出让方)名称通常 0 命中,属正常现象。想按债权人检索请改用 search_debt_notice。
Q8:page_size 传 100,为什么只返回 20 条?
工具接受 1–100,但上游按 20 截断,响应里的 page_size 会回显 20。需要更多结果请递增 page 翻页,或收窄关键词。
Q9:金额字段该用 _yuan 还是 _text?
需要比较、求和、换算时用 *_yuan(number,精确值);直接展示给用户时用 *_text(已格式化文本,如「1.2万元」)。两者不要混用,也不要自行换算。
Q10:保证人 / 抵押物字段缺失是正常的吗?
是。guarantor / collateral / original_creditor 都是条件字段,仅公告披露时才出现(key 可能整体不存在)。取值前请判空,未披露时展示「公告未披露」,不要编造。
Q11:怎么做某家企业的债务画像?
直接用自然语言提问即可(如「XX 公司债务情况怎么样」),客户端会按 5.1 企业公告债务画像 的流程调用工具并输出六节结构。请注意结论为公开公告口径,非征信报告,引用会附详情页链接。
安全提示:访问令牌(PAT)仅在控制台中查看与复制,请勿硬编码到公开代码或客户端配置仓库;发现泄露请立即吊销并重新生成。