什么是 MCP
Model Context Protocol(MCP)是一项开放标准,让 AI 助手可以用统一的方式使用外部服务。服务会发布一份工具清单。每个工具都有名称、说明、它接收的输入,以及它返回结果的形式。助手阅读这份清单,在对话需要时挑选一个工具,并得到结构化的答复。
下图展示了我们的 MCP 服务器的形态。
- 助手阅读工具清单,在对话需要时挑选一个工具。
- **只读工具:**工艺能力、设计、检查报告、报价、订单和消息。
- **会写入的工具:**上传、报价和消息。
- 会产生订单的工具只能准备订单。订单由您在网站上批准。
- 网站以结构化的形式答复,并给出确切的数字。
对您来说,效果很简单。助手不必猜测网站如何工作,而是由网站确切地告诉助手它能做什么。这样,助手就可以确切且可重复地做例如“检查这个板文件”或“显示一个价格”这样的事。
为什么工厂提供工具,而不是网页表单
网页表单是做给人看的。助手使用网页表单时,不得不查看截图或抓取页面,页面一变化就会失效。
工具清单是做给软件用的。它说明每个步骤需要什么、会返回什么。对于电路板订单来说,这一点很重要,因为步骤都很精确:上传文件、阅读检查报告、更改一个选项、阅读价格、确认。每一步都有必须确切的数字,例如以微米计的孔径,或以某种货币计的价格。结构化的答复能让这些数字保持确切。
工具也让安全更容易处理。工具可以明确说明它会花钱,助手也可以设计为在使用这类工具前先询问您。网页表单不提供这样的信号。
目前已有什么
**MCP 服务器。**其地址为 https://uliketechnology.com/api/mcp。无需登录,助手即可查看我们能生产的产品、开启游客会话、将电路板送至文件检查并获取价格,但受每日额度限制。如需让助手使用您的账户工作,请连接 https://uliketechnology.com/api/mcp/account:它会要求助手以您的身份登录。此后,助手还可以查看您的订单、准备订单供您批准,并读写您与工厂的消息。
**两种连接方式。**一种是助手以您的身份登录:它会在您的浏览器中打开本站的一个页面,页面上显示它的名称、地址和它请求执行的操作,在您按下允许之前,不允许任何操作。另一种是您在账户中创建 API 密钥,选择它可以执行的操作,并将密钥交给您自己的程序。两种方式都以您的身份、按您选择的权限行事,您可以随时结束其访问权限。面向开发者和助手中列出了地址和步骤。
**REST API。**它是不通过 MCP 的同一项服务:上传、文件检查、报价和下单。API 快速入门中列出了调用方法。
安全模型
它建立在四条规则之上。
- **智能体始终为已登录的人工作。**智能体没有自己的账户。您用自己的账户登录,并允许智能体以具名权限为您行事。您可以收回这项权限。
- **智能体可以准备订单。它不能下单,也不能付款。**当以您的身份登录的助手请求下单时,答复是“需要批准”和一个指向我们网站的链接。此时尚未下单。您打开链接,登录,查看确切的订单和总计,然后批准或拒绝。该链接只能使用一次,与您的账户绑定,24 小时后失效,如果报价或总计发生变化,就会失效。付款通过银行转账进行,由您亲自完成。
- **工程师确认每份订单。**无论由谁下单,工程师都会在生产开始前检查文件和订单。
- **每个工具都会标明自己的类别。**工具会标为只读、会写入记录,或会提交操作。会提交的两个工具——下单和取消订单——需要一个密钥,使重复调用只生效一次。
- 您用自己的账户登录,并允许智能体为您行事。
- 智能体准备订单。它不能下单,也不能付款。
- 网站在链接后面显示确切的订单和总计。
- 工程师在生产前确认每份订单。
- 琥珀色路径是批准链接。智能体将它交给您,它只对已登录的您有效。
我们刻意不提供付款、添加或更改地址,或创建 API 密钥的工具。这些只能在您所在的浏览器中完成。
API 密钥的工作方式相同。它是您自己的程序以您的身份行事,它发出的订单只是准备好,并未下单:答复是批准链接,订单在您在网站上批准后才下单。
我们也将您文件中的文字视为数据。文件名、设计文件内的文字和 BOM (物料清单) 说明会以长度受限的字段返回,绝不会作为指令。每个工具的说明都会指出哪些字段带有这类文字,并告知助手不要遵循其中写的内容。文件中的文字不能改变智能体被允许做的事情。
工具
以下是服务器提供的工具。助手只能看到它有权使用的工具:未登录时为前五组,连接您的账户后为您权限覆盖的那些工具。
| 分组 | 工具 |
|---|---|
| 查看我们能生产的产品 | get_capabilities |
| 无需账户工作 | start_guest_session |
| 上传并查看电路板 | create_upload_session, complete_upload, list_designs, get_design, set_layer_mapping |
| 检查 | validate_design, get_validation_report |
| 报价 | preview_quote, create_pcb_quote, list_quotes, get_quote, update_quote_options |
| 地址 | list_addresses |
| 订单 | place_order, list_orders, get_order, cancel_order, answer_engineering_query |
| 与工厂的消息 | list_threads, get_thread, create_thread, post_thread_message, mark_thread_read, close_thread |
place_order 返回上文所述的批准链接。cancel_order 仅在订单放行生产之前可用。工厂标记为私人的问题不能通过助手答复:工具会拒绝,并告知助手向您显示该问题。
服务器还将我们供助手使用的设计指南作为一项资源提供,即 ulike://guide/pcb-design,以及一个提示 check-and-quote-a-board,它会引导助手完成上传、检查和报价。
通过助手下单的流程
例如,您让助手订购二十块板。它查看工艺能力,将您的 zip 文件发送到上传地址,查看检查报告,并告诉您它发现了什么。它创建一份报价,并向您显示价格。当价格需要工程师确认时,报价要在工程师确认后才能下单。然后助手准备订单,并给您一个链接。您打开链接,登录,核对总计和地址,然后批准。订单页面会显示银行信息和您转账时使用的参考编号。工程师确认订单,在您的付款到账后开始生产。
助手在任何时候都不会持有付款信息。以您的身份登录的助手在任何时候都不能未经您的批准下单。如果它的答复看起来不对,您会在下单之前就在批准页面上看到。
MCP 不改变什么
MCP 是访问同一服务的一种方式。它不增加新的权限。使用 MCP 服务器的智能体,面对的是与使用网站的个人相同的文件检查、相同的限制、相同的价格和相同的工程师审核。您给智能体的权限绝不会比您自己的权限更宽。工具只能做其权限允许的事情,您可以随时移除这项权限。
您现在可以做什么
将 MCP 服务器的地址添加到支持 MCP 的助手中,或为您自己的程序创建 API 密钥。面向开发者和助手中说明了两种方法。如果您与助手协作,请将我们的 PCB 设计指南(供 AI 助手使用) 提供给它。如果您想了解如何与助手协作的一般方法,请阅读 使用 AI 助手订购电路板。