摘要
ShipStation 多承运商发货:订单(在 API v2 中称为 shipment)、面单、承运商及其服务、运费报价、物流跟踪、仓库、商品、库存、履约、批次、交接清单和上门取件。通过 API-Key 请求头使用 ShipStation API v2;包含购买和作废面单功能,但安装后默认关闭。
引导式设置
2 分钟将 ShipStation 连接到 Microsoft Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 ShipStation,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
ShipStation 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → ShipStation、粘贴凭证、生成 MCP API key — 完成。无 Docker、无
git clone、无本地服务器。
ShipStation + Microsoft Copilot
ShipStation 多承运商发货:订单(在 API v2 中称为 shipment)、面单、承运商及其服务、运费报价、物流跟踪、仓库、商品、库存、履约、批次、交接清单和上门取件。通过 API-Key 请求头使用 ShipStation API v2;包含购买和作废面单功能,但安装后默认关闭。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
SHIPSTATION_API_KEY
步骤 1 — 获取凭证
该连接器使用 ShipStation API v2,因此需要 V2 API 密钥。旧版 V1 的密钥和 secret 无法使用。
- 在 ShipStation 中打开 Settings → Account → API Settings。你的套餐必须包含 API 访问权限。
- 在 V2 部分点击 Generate API Key 并复制密钥;密钥只显示一次。同一时间只有一个 V2 密钥有效:生成新密钥会吊销旧密钥,在使用它的其他工具中也会失效。
- 将密钥粘贴到
SHIPSTATION_API_KEY,它会通过API-Key请求头发送。来自 api-portal.shipstation.com 的 ShipStation API(原 ShipEngine)密钥同样可用;以TEST_开头的密钥连接沙盒环境。 - 先调用
shipstation_list_carriers:查询运费和服务需要承运商 ID(se-...)。然后用shipment_status=pending调用shipstation_list_shipments,列出尚未发货的订单。
在 v2 中订单叫 shipment。 ShipStation 网页版中的订单在 API 中是 shipment,网页版中的发货在 API 中是 label。v1 订单 12345678 对应 se-12345678,订单号在 shipment_number 中。API v2 没有列出店铺的接口,请改用 store_id 筛选。
面单需要付费。 面单工具(shipstation_create_label_from_shipment、shipstation_create_label_from_rate、shipstation_void_label)安装后默认处于关闭状态。ShipStation 平台账户没有沙盒,购买的面单会从承运商账户扣费。只有在需要让 AI 购买面单时才开启它们。运费报价和地址校验不会更改任何数据。
速率限制:每个账户每分钟 200 次请求;429 响应带有 Retry-After 请求头,给出需要等待的秒数。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name(例如
AnythingMCP)、说明连接器用途的 Server description,以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key,把 Type 设为 Header,请求头名称填
X-API-Key,然后选择 Create。 - 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试:提出需要用到
ShipStation的工具的请求。 - 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
shipstation_list_carriers | List the carrier accounts connected to ShipStation with their carrier_id (se-...), carrier code, nickname, balance and, by default, their… |
shipstation_get_carrier | Get one connected carrier account by carrier_id: carrier code, account number, nickname, funding balance, services, packages and options |
shipstation_list_carrier_services | List the shipping services of one carrier (service_code such as usps_priority_mail or ups_ground, domestic or international, multi-package… |
shipstation_list_carrier_packages | List the package types one carrier accepts (package_code such as package, flat_rate_envelope, with dimensions where fixed) |
shipstation_list_shipments | List shipments, which are the orders of the ShipStation web app: recipient, items, status, store_id, order number and dates |
shipstation_get_shipment | Get one shipment (an order in the web app) by shipment_id: addresses, packages, weight, items, carrier and service, amounts paid, notes… |
shipstation_get_shipment_by_external_id | Get a shipment by its external_shipment_id, the key your own system or the sales channel gave the order (the v1 orderKey) |
shipstation_get_shipment_rates | Get the rates already calculated for a shipment, with carrier, service, price, delivery days and rate_id |
shipstation_calculate_rates | Quote shipping rates for an existing shipment across the given carriers |
shipstation_estimate_rates | Estimate shipping prices from origin, destination, weight and optional dimensions, without a shipment |
shipstation_list_labels | List purchased labels (the shipments of the web app) with tracking number, carrier, service, cost, status and download links |
shipstation_get_label | Get one label by label_id: tracking number, carrier, service, ship date, cost, status, voided flag and the label file as a URL or inline… |
shipstation_track_label | Get tracking for a label: current status, estimated delivery, carrier status description and the list of scan events |
shipstation_get_tracking | Get tracking by carrier code and tracking number, also for packages not labelled in ShipStation: status, estimated delivery and scan events |
shipstation_create_label_from_shipment | Buy a shipping label for an existing shipment, using the carrier and service set on it |
shipstation_create_label_from_rate | Buy a shipping label from a rate_id returned by shipstation_calculate_rates |
shipstation_void_label | Void a label that has not been used, so the carrier refunds the postage where it allows it |
shipstation_list_warehouses | List the ship-from locations (warehouses) with warehouse_id, name, origin address, return address and the default flag |
shipstation_get_warehouse | Get one ship-from warehouse by warehouse_id with its origin and return addresses and whether it is the default |
shipstation_list_products | List the products in ShipStation's product catalog with SKU, name, price, weight, dimensions, customs data and active flag |
shipstation_list_inventory | List stock levels per SKU from ShipStation inventory: on hand, allocated and available, optionally per inventory warehouse or location |
shipstation_list_fulfillments | List fulfillments, the shipping confirmations sent back to stores and marketplaces, with tracking number, carrier, ship date and… |
shipstation_list_batches | List label batches with batch number, status, label count, errors and download links for the combined labels |
shipstation_list_manifests | List end-of-day manifests (carrier scan forms) with carrier, warehouse, ship date, label ids and the form download link |
shipstation_list_pickups | List scheduled carrier pickups with pickup window, confirmation number, carrier, warehouse and the labels included |
shipstation_list_tags | List the tags defined in the ShipStation account with their names and colours |
shipstation_list_users | List the users of the ShipStation account with their user id, name and status |
shipstation_validate_address | Check a postal address against carrier data |
FAQ
这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?