Что такое 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 работает так же. Это Ваша собственная программа, действующая как Вы, и заказ, который она отправляет, готовится, а не размещается: ответ — ссылка одобрения, а заказ размещается после того, как Вы одобрите его на сайте.
Мы также относимся к тексту из Ваших файлов как к данным. Имена файлов, текст внутри файлов проекта и описания спецификации возвращаются в полях ограниченной длины, никогда как инструкции. Описание каждого инструмента называет поля, которые несут такой текст, и говорит ассистенту не следовать ничему написанному там. Текст в файле не может изменить то, что агенту разрешено делать.
Инструменты
Это инструменты, которые предлагает сервер. Ассистент видит только те, которые он может использовать: без входа первые пять групп, а после подключения Вашего аккаунта — те, которые покрывают Ваши разрешения.
| Группа | Инструменты |
|---|---|
| Читать, что мы можем изготовить | 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-ассистентом.