mcp-ucp — MCP-сервер для Claude Code: что делает и установка
MCP-сервер для покупок через UCP: поиск товаров, корзина, оформление и заказы. Сейчас пакет устарел и не подключается к рабочему endpoint.
claude mcp add mcp-ucp -e UCP_API_KEY=<UCP_API_KEY> -- npx -y @codespar/mcp-ucpЧто делает mcp-ucp
mcp-ucp задуман как интерфейс Google UCP для агентских покупок. Он предоставляет 20 инструментов: поиск товаров, получение сведений о цене и наличии, работу с корзиной, доставкой, оплатой, заказами, возвратами и профилем покупателя.
Пакет помечен как deprecated: текущего рабочего endpoint нет, поэтому инструменты не обращаются к сервису. Для подключения собственного рабочего провайдера предусмотрен UCP_BASE_URL; сервер передаёт UCP_API_KEY как Bearer-токен, а UCP_MERCHANT_ID — как заголовок магазина. Без рабочего UCP endpoint сервер не выполнит запросы к каталогу или заказам.
Какие задачи решает
- искать товары в каталоге продавца
- проверять наличие и доставку по адресу
- собирать корзину и получать расчёт доставки
- запускать оформление и подтверждать заказ
- отслеживать заказ или оформлять возврат
Примеры запросов агенту
- Найди товар по запросу и покажи цену, варианты и наличие.
- Создай корзину, добавь в неё выбранный товар и покажи варианты доставки.
- Проверь статус заказа и данные по отправлению.
Как установить mcp-ucp
Командой платформы
claude mcp add mcp-ucp -e UCP_API_KEY=<UCP_API_KEY> -- npx -y @codespar/mcp-ucpВместо <…> подставьте свои значения
Командой платформы
codex mcp add ucp --env UCP_API_KEY=<UCP_API_KEY> -- npx -y @codespar/mcp-ucpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"ucp": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-ucp"
],
"env": {
"UCP_API_KEY": "<UCP_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"ucp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-ucp"
],
"env": {
"UCP_API_KEY": "<UCP_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e UCP_API_KEY=<UCP_API_KEY> ucp npx -y @codespar/mcp-ucpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-ucp
Как установить mcp-ucp в Claude Code?
Выполните claude mcp add mcp-ucp -e UCP_API_KEY=<UCP_API_KEY> -- npx -y @codespar/mcp-ucp.
Что делает mcp-ucp?
Сервер добавляет инструменты UCP для поиска товаров, корзины, checkout, заказов, доставки и профиля покупателя. Сейчас он не обращается к рабочему сервису.
Что нужно для работы mcp-ucp?
Нужен UCP_API_KEY. Для рабочего подключения также потребуется endpoint провайдера через UCP_BASE_URL; UCP_MERCHANT_ID используется как необязательный идентификатор магазина.
