以船讯网为例：用自己的 Key 接入 MCP 连接器，查询并加工船舶与港口数据

登录船讯网 API 控制台，在「应用管理」中创建一个应用，创建完成后复制该应用的 Key。具体操作以船讯网官方文档《如何获取应用 Key》为准，源宜的配置窗口里也放了这篇文档的链接，安装时可以随时打开。

需要留意两点。第一，这个 Key 能调用哪些接口、有多少调用额度，取决于它在船讯网开通的服务，与源宜的套餐无关；如果只开通过船讯网网页端的会员，请先在 API 控制台确认 Key 已开通所需的接口服务。第二，Key 相当于账号凭据，只填进源宜的配置窗口，不要发在对话、文档或群聊里。

在源宜左侧进入「智能体插件」，切换到「连接器」页签，官方连接器列表中有一行「船讯网船舶与港口」。这一行的四列说明了它的使用方式：运行方式为「云端托管」，由源宜云端连接船讯网的 MCP 服务，本机不需要安装任何运行环境；计费为「个人额度」，查询消耗的是你自己的 Key 在船讯网的接口额度，连接器调用不扣团队积分；授权为「个人令牌」，每位成员使用自己的 Key，彼此不可见。

点击行末的「一键安装」即可开始，不需要手动填写服务地址或复制配置文件。安装后，在下一步填好 Key 并通过校验，这一行的状态会从「未安装」变为「已连接」。

点击「一键安装」后会弹出「配置并授权」窗口。粘贴应用 Key，点击「配置并授权」，源宜会先用这个 Key 向船讯网实际查询一次港口信息。Key 无效、过期或没有接口权限时，窗口会直接提示校验失败，Key 不会被保存；校验通过后，Key 按当前用户加密保存，团队其他成员看不到，也无法使用。

之所以用一次真实查询来校验，是因为有些 Key 能连上服务、能列出工具，但调用时才返回无权限。把这一步放在安装时完成，比在对话中途才发现 Key 不可用更省时间。

连接器安装好以后，在对话输入框输入「@」，在「能力」分组中选择「船讯网船舶与港口」，再写出问题，例如「请帮我查询 MMSI 为 413961925 的船舶当前位置」。用 @ 指定连接器，等于告诉数字员工这次使用哪一个数据来源，它会直接调用船讯网，而不是去网页上搜索。

这次查询只用了一个步骤，不到一秒就拿到结果（见文首截图）：船名皖鸿远369，当前位于北纬 33.245633°、东经 119.295987° 的内河航道，对地航速 5.6 节，目的港 NIUTOUSHAN，位置更新时间为北京时间 18:06:02。数字员工把接口返回的字段整理成表格，对航首向 511° 这类表示「未回传」的特殊取值也做了说明，没有把它当成真实角度。

这类问题适合日常的船舶动态跟踪：货代确认货船是否已经离港，港口调度预估靠泊时间，贸易部门核对在途货物的位置。把 MMSI 换成你关注的船舶即可。

第二个问题是「张家港今日的到港船只数据」。数字员工先用港口检索确认张家港的港口代码为 CNZJG，再依次尝试靠港记录、靠泊船、锚地船、预抵船和港口水域范围内船舶五个接口，全部返回 permission_denied（船讯网状态码 21）。

回答开头就给出结论：查询本身没有出错，而是当前 Key 没有开通这几类接口的权限，所以拿不到任何一条到港记录，也不会编造数据。回答中的表格逐一列出尝试过的口径、对应接口和返回结果，便于你拿去和船讯网核对。

处理方法是在船讯网 API 控制台查看该 Key 已开通的服务，或联系船讯网开通港口靠泊、到港类接口的权限。开通后不需要在源宜重新安装或重新填写 Key，直接再问一次即可。港口检索、船位查询等基础接口不受影响，可以照常使用。

查询结果不只能在对话里看，也可以继续加工成文件。第三个问题是：@「船讯网船舶与港口」查询上海、宁波、张家港三个港口的基础信息（港口代码、经纬度、所属国家和时区），整理成一张对比表，并保存为 Excel 文件。

数字员工调用三次港口检索，把结果整理成对比表：上海 CNSHG、宁波 CNNBG、张家港 CNZJG，三港均属中国，时区均为 UTC+8。同时生成 Excel 文件「上海宁波张家港港口基础信息对比.xlsx」，包含标题行、表头、三行数据和来源说明，保存后还读回核对了一遍。文件出现在对话末尾的产物卡片和右侧「工作状态」的「产物」中，可以预览、下载，或存入资料库供团队查阅。

值得注意的是经纬度这一列。船讯网的港口检索接口不返回港口坐标，数字员工核对接口字段后，在表中如实标注「接口未提供」，没有凭记忆补写坐标，并给出了补齐的可选途径。对数据加工而言，这比一张看起来完整的表更有用：哪些数字来自接口、哪些缺失，一眼就能分清。

三次查询分别对应数据咨询、权限排查和数据加工三种常见情形。下表汇总了每次用到的接口与结果，可以作为在团队内推广时的参考。