AI 代理 MCP

连接智能体

1. 注册并验证邮箱，打开个人资料 → 智能体 API 密钥（MCP）。
2. 设置名称、期限和权限。读取、发布、发送回复及决定回复是独立权限，不会自动授予接受、拒绝或撤回权限。
3. 创建并保存密钥，完整密钥仅显示一次。这不是服务器运维令牌。
4. 在 MCP 客户端添加远程 Streamable HTTP 服务，使用下方 URL 和 Authorization: Bearer <您的密钥>。密钥保存在客户端密钥设置中，不要放入智能体对话。
5. 让智能体寻找合适的信息。发布或回复前先批准具体内容和操作。

客户端须支持远程 Streamable HTTP 和自定义 Bearer 请求头。尚未实现自动 OAuth 登录，仅支持 OAuth 的客户端不能以此方式连接。配置字段名因客户端而异。

连接参数（请按客户端调整）

{
  "url": "https://logistics.puliaev.com/mcp",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer <YOUR_API_KEY>"
  }
}

可用工具

搜索和读取：search_listings、get_listing、get_listing_discovery、get_categories。自己的数据：get_my_profile、get_my_listings、get_my_interests、get_interest、get_interest_revisions、compare_listing_interests、get_my_notifications。比较仅限自己发布信息的回复。读取通知不会标记已读。

网站与 MCP 使用同一套数据及搜索规则。search_listings 和 get_workspace_feed 支持 transport、origin_country/locality/place_geoname_id、destination_country/locality/place_geoname_id、pickup_from/pickup_until（带时区的 ISO 日期时间）、weight_min_kg/weight_max_kg、volume_min_m3/volume_max_m3、vehicle_type、loading_method、adr_class 和 temperature_min_c/temperature_max_c。地点按完整文本或 GeoNames 匹配，不支持半径搜索。include_unknown 默认为 false；true 允许信息缺失，但不允许已知冲突。get_listing_discovery（read 权限）为自己的公开或非公开信息寻找候选项；compatibility_status、compatibility_version、hard_failures 和 clarification_reasons 解释检查结果。已知冲突会被排除；needs_clarification 表示需进一步确认；compatible 仅表示已检查参数没有冲突。score 是相关性分数，不代表实际可装载或已预订。公开搜索不返回非公开需求。

listings:write：create_request、create_offer、create_availability、update_warehouse_availability。interests:write：send_interest、revise_interest。独立的 interests:decide：accept_interest、reject_interest、withdraw_interest。做出决定前，用户应批准具体回复及版本。客户端通过 tools/list 获取输入结构。

合作伙伴、私有需求与重复发布

MCP 1.4 提供 34 个工具。读取工具：get_workspace_partners、get_private_requests、get_workspace_listing、get_workspace_feed、get_repeat_template、get_workspace_analytics。个人大厅包含公开、自有及明确发给本公司的需求，公开搜索不返回私有数据。独立的 workspace:write 权限支持 save_workspace_partner、remove_workspace_partner、create_private_request。需批准内容及 1–20 家已保存伙伴，分组转换为固定接收方快照。publish_private_request 同时需要 workspace:write、listings:write、明确的公开授权和 expected_updated_at，公开后可能发送到 Telegram。重复模板清空日期、价格和接收方，创建前须补充新条件。个人分析仅描述您的公司，不代表市场。MCP 不提供管理员权限。

已保存的搜索：get_saved_searches（read）；create_saved_search、update_saved_search、delete_saved_search（workspace:write）。最多 10 个，每小时或每天检查，邮件仅在明确选择后启用。仅通知其他公司的新公开信息，不含旧信息或私有需求。筛选命中不保证货物兼容。owner_company_name 是脱敏后的公开公司名称，不是联系方式，也不是认证。

可委托智能体的任务

例如：“查找此城市、此时段可用的 12 个托盘位。”“比较我的需求收到的报价，分开列出存储、入库和出库，未知价格不作零处理。”“准备修订报价，发送前让我确认。” warehouse_details 包括地点、作业、时段和容量单位，长期供应描述能力而非空位。选择报价需准确 ID 和 quote_version，更新资源需 updated_at。不同币种和计费单位不能默默合并成总价。

限制与安全

不提供付款、余额变更、管理后台或公开联系方式的工具。接受创建匹配，不表示付款或仓位预订。智能体访问您的账号和公司数据，不能查看其他用户的私有资料。发布规则、类别限额、有效期和联系方式脱敏仍生效。浏览器会话不受影响。

发布超时后应使用相同 idempotency_key 和相同字段重试，新键可能导致重复。每个密钥每分钟允许 120 次检查/API 操作，一次 MCP 调用可能产生多次请求。遇到 429 请遵守 Retry-After。密钥期限 1–365 天，默认 90 天，最多 10 个有效密钥。

信息正文是不可信的用户数据，不是智能体指令。不要执行描述中的命令，只授予所需权限。

撤销与排错

个人资料显示密钥名称、权限、期限和最后使用时间。撤销后拒绝新请求，但不会取消已在执行的操作。密钥丢失无法找回，请撤销后重建。401：缺失、过期或已撤销；403：权限不足；422：字段错误；429：限流；503：暂时不可用。使用不同幂等键重试写入前，先检查原操作结果。