Zé Delivery MCP

Неофициальный. Не аффилирован с Zé Delivery или Ambev, не одобрен и не поддерживается ими. Клиентский GraphQL по адресу api.ze.delivery/public-api может меняться без предупреждения.

По умолчанию оплата не производится. ze_place_order и ze_cance_order ничего не деают, есlи не вклчен ZE_ALOW_MUTATIONS и explicit_user_intent не равен true. Гостевые токены не могут списывать средства. Улица, теефон, email и GPS/latlng-полилинии скрываются.

Установка за 60 секунд

npx -y ze-mcp-unofficial setup
npx -y ze-mcp-unofficial auth --from-header "Bearer eyJ…"
npx -y ze-mcp-unofficial doctor

Токен — не OAuth. Перехватите клиентский запрос к api.ze.delivery → скопируйте загоовок Authorization. Катаог/поиск по-прежнему работают без токена; инструменты оплаты остаются забокированными.

Stdio-фрагмент (Claude Desktop, Cursor, Grok Bot). Не укажите мутации во фрагменте:

{
  "mcpServers": {
    "ze": {
      "command": "npx",
      "args": ["-y", "ze-mcp-unofficial"]
    }
  }
}

См. examples/claude-desktop.json и examples/grok-bot.md.

Related MCP server: Texas Grocery MCP

Навык или MCP

Один и тот же пакет, два входа. MCP регистрирует инструменты через stdio/HTTP. Навык — это рабочий процесс (поиск → остановка перед заказом) и может управять теми же инструментами через CLI, когда у клиента нет MCP:

npx -y ze-mcp-unofficial call ze_search --json '{"query":"brahma"}'

Гейты идентичны. Скопируйте skil/SKILL.md в катаог навыков вашего агента (~/.agents/skils/ze/ или эквиваент в Claude/Gro k).

Инструменты

HTTP (необязательно, loopback)

Транспорт по умолчанию — stdio. Streamable HTTP привязывается к 127.0.0.1 и проверяет Origin на соответствие http://127.0.0.1:<port> (переопределяется через ZE_MCP_ALLOWED_ORIGIN). Это защита от DNS-rebinding, а не публичный сервер.

npx -y ze-mcp-unofficial --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp

Безопасность

Токены хранятся в ~/.ze-mcp/tokens.json (0600). Их нет в git, в npm-архиве или в примерах по умолчанию. Подробные заметки: SECURITY.md. Агентам: llms.txt.

Тесты

npm test

Реальный вход в Zé не требутся.