什么是 Portmate MCP

Portmate MCP 通过模型上下文协议（Model Context Protocol）将您的 AI Agent 与 Portmate 的物流工具相连接。它为获得授权的 Agent 提供了一种结构化方式，让您直接在 Agent 自身的操作界面中即可请求短驳运费报价、基于报价创建订舱并获取货件追踪信息。

您只需描述任务。您的 Agent 会确定调用哪些可用工具、收集所需信息并解释操作结果。Portmate 则负责验证业务请求并执行受支持的操作。

Portmate MCP 现已面向申请获批的客户提供预览版。如需商讨开通事宜，请联系 Portmate 团队，并说明您希望连接的 Agent 以及打算尝试的工作流。

对于进口商、货运代理或运营团队而言，其实际价值在于业务的连贯性。针对某条路线的运送请求可以在您常用的助手界面中发起，生成可供审查的报价，并顺畅推进至订舱和货件查询环节，而无需在不同对话之间反复复制粘贴各项结果。

本指南将介绍该连接的功能、审慎使用的方法，以及 Agent 互联物流在未来的发展方向。如果您对底层服务尚不熟悉，可先从了解短驳运输的含义开始。

MCP 为 AI Agent 带来什么

模型上下文协议（MCP）是一项用于将 AI 应用程序连接到外部系统的开放标准。MCP 官方介绍中详细说明了工具、数据源和工作流的连接机制。

这种连接之所以至关重要，是因为对话式问答与业务操作有着截然不同的要求。AI 助手可以根据通用知识解释短驳运输；但获取 Portmate 报价则需要调用受支持的定价操作；汇报货件最新记录的节点里程碑，则需要进行货件查询。

MCP 为承载您 Agent 的应用程序提供了一种通用的发现与调用此类操作的方法。每个开放的工具都配有描述和输入模式（input schema），告知 Agent 该操作接收哪些信息。执行结果会返回 Agent 可在其后续回复中利用的信息。MCP 服务端概念指南对这些基础构件进行了说明。

您的 Agent、连接与 Portmate

理清以下三个角色有助于清晰理解整个架构：

• 您的 Agent：解读您的请求、提出有针对性的跟进问题、选择工具并解释发生的情况。
• MCP 连接：在 Agent 应用程序与 Portmate 之间传输可用工具定义、结构化请求及返回的结果。
• Portmate 服务：应用业务规则、核查必要输入与授权，并执行受支持的操作。

承载 Agent 的应用程序通常称为 MCP Host（MCP 宿主）。它利用 MCP Client（客户端）与服务端进行通信。您通常会通过 Agent 应用程序提供的连接器、插件、集成设置或配置文件来使用它。官方架构概述对这些角色进行了更详细的描述。

因此，您的 Agent 可以在保持自身对话风格和工作上下文的同时，借助 Portmate 获取专有事实信息并执行相应操作。大语言模型本身并没有变成定价引擎，而在没有对应服务返回确切结果的情况下，仅凭一句“订舱成功”并不能算作订舱真正成功。

一项请求如何转化为一系列工具调用

一次实用的交互通常遵循以下流程：

1. 您提出期望的目标，例如获取某项指定集装箱运输的报价。
2. Agent 识别相关工具并检查这些工具所需的信息。
3. Agent 补充缺失细节或澄清模糊信息，包括您所指的码头或具体货件。
4. Portmate 验证并在已连接客户的权限范围内执行该请求。
5. Agent 解释返回的结果，包括所有假设条件、缺失信息或后续步骤。

一条消息可能需要多次工具调用。例如，识别码头与生成报价属于不同的操作。后续基于该报价进行订舱则是另一项操作，拥有其独立的输入项和后续影响。

通过 Portmate MCP 可以做什么

报价、订舱与追踪是核心工作流。Portmate 的工具层还涵盖了用于位置调研、附加费费率查询、路线限重指引、报价调取、文章知识库检索和人工复核的辅助操作。请以您预览版连接中开放的工具为准，了解当前 Agent 可以调用的具体功能。

请求并审查集卡短驳报价。 您的 Agent 可以汇总受支持的美国集装箱短驳运输详情并发起计价请求。有用的信息包括重箱交接地点、设施位置、进出口方向、集装箱类型、货物品名、货物净重以及任何要求的附加服务。

一个清晰的初始请求示例如下：

Get a quote for one 40HC import container from APM Elizabeth to Linden, NJ 07036. The cargo is dry, nonhazardous packaged goods with a net weight of 18,000 kg. Explain the price assumptions and accessorial conditions. Get a quote only.

返回的结果不应仅仅是一个总价。需审查计价地点、设备、货物依据、包含的服务以及适用条款。如果采用了某种预设前提，Agent 应当予以说明。如需更全面地了解报价范畴，请阅读全包集卡短驳报价的含义及获取方式。

调取报价并请求副本。 凭借已有的报价参考号，Agent 可以直接检索相关报价，而无需从之前的对话中重新推算价格。当该工具可用且您提出请求时，Agent 还可以安排发送报价副本。查询报价、生成新报价和发送副本是不同的请求；请明确告知 Agent 您需要哪种操作。

基于报价创建订舱。 在您选定某份报价后，订舱工作流需要提供必要的设施和集装箱信息。Agent 可以在获得您的授权后收集缺失的详细信息并提交受支持的订舱操作。返回的货件参考号为您提供了确凿的依据，便于留存并在后续跟进中使用。订舱指南对底层的“从报价到订舱”全流程进行了详细解析。

询问货件追踪信息。 可以通过 Portmate 货件参考号、报价编号或集装箱号来定位货件以进行追踪查询。您可以询问记录的进展情况、下一站以及下一站的预计到达时间（ETA）。一个实用的提示词示例为：Check the latest tracking information for this shipment. Separate completed milestones from planned events and estimates.

答复内容取决于系统中的可用记录。仅凭一个集装箱号并不能证明 Portmate 中存在匹配的货件。了解更多在对话中提出运营问题的方法，请参阅如何在聊天中追踪您的货件。

调研地点与操作要求。 辅助工具可帮助识别适用的码头或堆场、查找附近受支持的大都会区、检索附加费费率并评估路线重量支持能力。这些查询针对的是不同层面的问题：附近有地点并不代表设备一定可用；公布的附加费费率并不代表该费用必然产生；重量建议也不是通行许可证或最终路线审批。

地点调研请参阅距离设施最近码头指南，评估货物重量支持所需的信息请参阅路线限重指南。

获取解释或请求人工复核。 文章检索功能可以帮助 Agent 解释术语和产品工作流。在需要推进至人工处理环节时，受支持的人工复核工具可以提交明确的货件请求。检索到关于某项服务的文章，并不代表该服务支持自动报价或自动订舱。

即时报价操作主要针对重箱港口或铁路交接点与发货人或收货人设施之间受支持的美国集装箱短驳运输，并包含相关的空箱设备调运。其他运输或特种货物要求则需单独评估。请清楚说明完整的货运范围，以便 Agent 区分受支持的内陆操作与需要人工审查的额外服务。

全程演示：从计价到货件动态更新

以下示例演示了如何组织请求。这并不是一份实际生成的报价、订舱，也不构成对具体价格或运输时效的保证。

请求报价并理解其服务范畴

从上文提到的从 APM Elizabeth 到 Linden 的请求开始。Agent 需要识别目标码头与设施位置，保留所提供的设备及货物事实信息，并补充可用操作所需的任何其他信息。

如果您的货件有特殊操作要求，请在计价前一并提供。例如，计划中的过夜落箱（overnight container drop）与被报价的操作密切相关。如果在获得报价后再补充此类要求，可能会改变所需的操作及其实际费用。

收到报价后，您可以询问：

Explain which movements and services this quote covers, which quantities or conditions were assumed, and what could create an additional charge.

在继续下一步之前，请核对以下几点：

• 报价描述的进出口方向是否正确。
• 码头和设施是否为预期地点。
• 设备、货物净重及申报的服务是否符合您的要求。
• 总价的货币与计价单位是否明确。
• 空箱与车架（chassis）的调运情况是否清晰明确。
• 报价条款、有效期和尚未明确的条件是否已呈现。

妥善保存报价参考号。如需再次查看该报价，请让 Agent 调取该参考号。如果货件实际信息发生变动，请指明变更内容并请求相应的修改后计价，切勿假设原先的金额依然适用。

审查订舱信息并授权运输

您可以要求 Agent 准备下一步信息，而暂不创建订舱：

Tell me what information is still needed to book this quote. Do not create the booking yet.

订舱所需的必要信息包括所选的报价编号、设施名称、街道地址、城市、州、邮编、设施联系人电子邮箱以及集装箱号。请提供运输的真实详情，并在提交前仔细核对。

准备就绪后，发出明确的指令：

Book the selected quote using the facility and container details I provided.

Agent 应当报告返回的订舱结果和货件参考号。请根据结果实际确立的状态来理解进展。已创建货件记录、已指派承运人、已预约码头时间与已发送电子邮件属于不同的事件。只有在相关结果或货件记录确切确认后，才能将每一项视为已确认。

如果响应中断，在要求再次提交之前，务必先核实订舱是否已经创建。在未核实执行结果的情况下盲目重复提交具有实际法律或财务后果的请求，即使系统存在防重控制，也可能导致混淆。

追踪进展并准备有效的进展通报

后续，您可以让 Agent 使用返回的参考号调取货件信息：

Check this shipment again. What is the latest completed milestone, what happens next, and what ETA is available for the next stop? Include the relevant observation times.

一份合格的运营答复应当让您能够明确区分以下内容：

• 记录的事件： 货件记录中显示已经发生的事件。
• 计划的事件： 预约时间或其他预定步骤。
• 预估信息： 系统给出的预计到达时间及对应的具体站点。
• 缺失的信息： 尚未记录或当前无法确定的信息。

例如，只有送货预约时间而没有实际到达时间戳，只能说明预约已成立，并不能证明卡车已经送达。同样地，刚生成的回复中描述的可能是稍早之前的车辆定位。如果信息时效性很关键，请询问该观测记录的时间戳。

在审查相关事实后，您可以要求：

Draft a short customer update from this tracking result. Include the next step and any uncertainty. Leave it here for review.

起草消息利用的是 Agent 的文本撰写能力。而通过电子邮件或其他系统发送该消息，则需要相应系统自身的可用工具和授权。如果问题涉及已记录的费用，附加费追踪指南介绍了如何核查具体金额、产生原因及佐证材料。

MCP 如何与 Portmate Chat 和 API 协同配合

不同的界面适用于不同的工作模式。MCP 为 Agent 提供了一种调用开放功能的标准方式，而底层的业务服务则一如既往地执行各项任务。

Agent 可以通过定制集成来调用 API，而 MCP 服务端也可以在其工具底层调用 API 或领域服务。两者的区别在于集成方式如何向 Agent 呈现这些能力。MCP 将工具发现和调用流程标准化；但它并没有消除对模式定义、权限控制、业务规则或软件维护的需求。

微软的集成指南探讨了与连接器或直接 API 调用相比何时适合使用 MCP。当多个 Agent 需要相同功能时，共享的工具界面大有裨益；而对于已有清晰集成路径的现有应用程序，直接调用 API 可能更为合适。

对于物流团队而言，选择应立足于实际需求。请选用最适合当前任务、契合现有运行系统并满足企业管控要求的界面。即便由 Agent 处理初始请求或解释说明，您依然可以随时使用产品原本的界面进行深入核查。

自带 Agent 并申请预览版访问权限

自带 Agent（Bring your own agent）意味着使用您自选的 Agent 应用程序与 Portmate 开放的工具进行交互。这既不需要将模型本身迁移到 Portmate 中，也不需要授予 Agent 访问您其他系统的无限权限。

检查承载您 Agent 的应用程序

MCP 支持取决于具体的应用程序及其配置。单凭模型名称或熟悉的助手图标，无法判断该应用程序能够使用哪些外部连接。

官方文档介绍了若干环境中的 MCP 连接能力：

• ChatGPT： 自定义 MCP 服务端可通过插件开放读写工具，受工作区权限和安全策略限制。
• Codex： 外部 MCP 连接可提供代码库外部系统的工具和信息。
• Claude： 远程 MCP 连接器将应用程序连接到托管在互联网上的工具与信息。
• Gemini CLI： 配置的 MCP 服务端使 CLI 能够发现并调用外部工具。

以上是具备记录的 MCP 支持能力的典型应用程序示例。在申请 Portmate 预览版访问权限时，请确认您打算使用的特定应用程序、传输协议（transport）和身份验证方式所对应的受支持配置。企业管理员也可能会对允许哪些连接与操作进行管控。

企业同样可以围绕 MCP 客户端构建自有的 Agent 应用程序。该协议的官方 SDK为开发团队提供了实现资源。

从单一明确的工作流开始

在整合多个系统或自动化执行具有实际影响的操作之前，请先利用预览版建立起一项实用且可重复的任务。

1. 申请访问权限。 发送邮件至 support@portmate.ai 或通过 Portmate 的联系渠道联系我们。请注明您的公司名称、打算使用的 Agent 应用程序，以及您希望先从报价、订舱、追踪还是其他具体工作流入手。同时索取最新的预览版连接指引与要求。

2. 按照提供的连接说明进行配置。 使用为您授予权限时提供的服务端详情和身份验证流程。不同 Agent 应用程序之间的配置方式存在差异，因此请务必使用适用于您实际环境的说明，切勿套用其他无关服务端的配置示例。

3. 查看可用工具。 明确该连接开放了哪些工具以及其操作需要哪些信息。建议先从查询您有权访问的货件开始，或者在尝试执行会创建记录的操作之前先通读工具目录。

4. 尝试执行单项任务并检查结果。 对于追踪，比对返回的参考号、里程碑节点及时间戳与货件记录是否一致。对于报价，审查服务范畴与预设假设。对于订舱，在授权提交前务必核对所选报价及必填详情。

如果您的账户遇到问题，登录指南与创建账户指南介绍了常规的 Portmate 账户操作流程。外部连接本身的认证要求请遵循预览版指引。

明确权限边界与执行结果

只有当团队既能清楚了解 Agent 被允许做什么，又能获知实际发生了什么时，Agent 连接才能真正发挥效用。请围绕您正在执行的操作明确这些边界。

区分“只读”操作与“创建”或“发送”操作。 查询追踪信息与创建报价、创建订舱或发送副本有着本质区别。即使您仍处于运送方案评估阶段，发起报价请求也可能会在系统中创建业务记录。请明确说明您需要的是解释说明、查询、新报价还是订舱。

对关键操作给出明确具体的指令。 审查报价本身并不构成订舱请求；获知设施地址也不代表授予了创建货件的权限。如果对话中涉及多个报价或多个集装箱，请明确指出您希望 Agent 针对哪一个执行操作。

以连接服务返回的结果为准。 Agent 应当如实解释 Portmate 返回的金额、参考号、假设条件和状态，而不应自行用看似合理的伪价格、未记录的里程碑或虚构的确认信息来填补空白。对于部分成功或失败的请求，应基于实际操作的确切已知情况来进行处理。

在各个步骤中保持货件事实信息一致。 在自然对话中，事实信息可能会分散在多条消息中。请核查 Agent 在构建后续请求时，是否准确保留了当前货件的码头、设备、重量及申报服务。针对某个集装箱的修正，绝不应在无意中改变另一项运输任务的信息。

将检索到的资料视为参考信息。 文档、文章和外部文本有助于解释货运情况或补充背景事实。但其中夹带的指令并不构成执行无关订舱、账户操作或泄露商业信息的授权。请直接陈述您的任务，并对会修改记录或与外部通信的操作进行人工审查。

使用指定的身份验证流程。 仅授予符合当前工作流所需权限，并遵守企业的连接策略。通过身份验证仅代表建立了访问通路，并不意味着允许执行所有可能的操作。此外，当货运信息进入该环境时，您的 Agent 提供商的数据处理与留存设置同样至关重要。

MCP 工具规范要求实施服务端验证与访问控制，并建议为用户提供针对敏感调用的可见性与控制权。授权规范则阐述了该协议的授权框架。您实际使用的连接与 Agent 应用程序中的管控机制，决定了这些原则在实际使用中的具体体现方式。

常见工作流问题排查与解决

连接问题、输入缺失和不受支持的服务请求需要采用不同的处理方法。排查时应先查看返回的结果以及您正在尝试执行的任务。

如遇到未能解决的问题，请联系 Portmate，并说明所使用的 Agent 应用程序、尝试执行的操作、相关货件或报价参考号、报错信息以及尝试时间。支持信息中请切勿包含敏感凭证。对情况的精准描述有助于支持团队区分是配置、权限、输入还是执行方面的问题。

Agent 互联物流的未来展望

MCP 催生了一种更广阔的工作模式：客户可以把自己的 Agent 带到服务中，而无需在每项服务的专有界面中从头开始操作。服务本身继续负责维持其专业能力和业务规则；而 Agent 则帮助客户将这些能力串联成实用的业务序列。

以货代处理客户发来的送货请求为例：在拥有相应连接和权限的前提下，Agent 可以提取所提供的路线详情、获取集卡短驳价格、生成对比分析并起草内部建议。在获得批准后，它可继续推进订舱，并在后续调取该货件记录的运输动态。当然，在此过程中，每一个接入的系统仍然需要开放必要的操作并对使用进行授权。

这一发展方向在货运行业已有先例。Flexport 的 MCP 方案展示了面向客户 Agent 的费率查询、货件信息与订舱工作流。这证明了该模式正在物流领域崭露头角，但这并不代表如今所有服务商、货运类型或工作流都已实现互联互通。

未来的某些工作流还可能涉及不同公司之间的 Agent 跨边界协作。MCP 将 Agent 连接到开放的工具和信息，而 Agent 间协议（Agent-to-agent protocols）则解决 Agent 彼此之间的协同合作。官方 A2A 对比阐述了这两种方案如何优势互补。虽然 MCP 服务端可以开放高级行为，但仅凭 MCP 本身并不意味着独立的 Agent 之间能够自动磋商货运交易。

其实际落地机遇在于让客户授权的任务能够更轻松地跨系统流转。这需要精准的货件身份标识、详尽实用的工具描述、明确的权限、清晰的执行结果以及异常处理机制。此外，定时重复检查、后台运行或设置费用支出上限等功能，都需要 Agent 应用程序或自动化系统本身具备相应控制能力，光靠连接本身并不能提供这些功能。

首次集成前需要明确的问题

厘清以下决策有助于将有趣的演示转化为团队切实可用的日常工作流。

我们是否需要编写代码？ 如果 Agent 应用程序本身支持直连流程，终端用户可能无需自行开发集成即可配置访问权限。而企业自建的定制 Agent 则依然需要实现 MCP 客户端和应用逻辑。在评估开发工作量之前，请先确认您的 Portmate 预览版访问权限所支持的具体配置方式。

我们还能直接使用 Portmate 吗？ MCP 只是提供了一个补充界面。当您需要使用自带的聊天、追踪工作区或其他产品视图时，可以随时直接使用 Portmate。Agent 的答复也可以作为您深入核查底层货件记录的起点。

所有支持 MCP 的 Agent 表现都会一样吗？ 通用协议有助于应用程序之间的连接，但不同的模型和宿主程序在工具选择、澄清提问、审批机制、上下文管理和结果呈现方面各不相同。请结合您团队的实际任务需求来评估具体的 Agent 应用程序。

连接会产生哪些费用？ 请向 Portmate 咨询当前的预览版条款，并单独向您的 Agent 服务商核实其订阅或使用费用。MCP 是一项协议，仅凭协议名称本身并不能决定两项服务各自的商业计费条款。

我们可以先从追踪开始，后续再接入订舱吗？ 可以先从您当前连接中开放的工具和权限入手。范围较窄的初期任务更容易核查与复现。在拓展到订舱或跨系统操作之前，请先明确由谁来授权这些操作，以及团队将如何验证操作结果。

如需申请预览版访问权限，请向 Portmate 团队发送具体的初始申请信息：您希望连接的 Agent、期望其执行的工作流，以及负责审查其操作的人员。这将赋予首次连接清晰明确的目标，并让其效果评估变得更加简单直接。