Zé Delivery MCP

비공식. Zé Delivery 또는 Ambev와 제휴하거나 보증하거나 지원하지 않습니다. api.ze.delivery/public-api의 소비자 GraphQL은 예고 없이 변경될 수 있습니다.

기본적으로 결제하지 않습니다. ze_place_order와 ze_cancel_order는 ZE_ALLOW_MUTATIONS가 활성화되어 있고 explicit_user_intent가 true인 경우에만 동작합니다. 게스트 토큰으로는 결제할 수 없습니다. 거리, 전화번호, 이메일 및 GPS/latlng 폴리라인은 삭제(redact)됩니다.

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). 스니펫에서 mutations를 설정하지 마세요:

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

examples/claude-desktop.json과 examples/grok-bot.md를 참조하세요.

Related MCP server: Texas Grocery MCP

Skill 또는 MCP

동일한 패키지, 두 개의 입구. MCP는 stdio/HTTP에 도구를 등록합니다. skill은 작업 흐름입나다 (검색 → 주문 전에 멈추기) 그리고 클라이언트에 MCP가 없을 때 CL를 통해 동일한 도구를 구동할 수 있습니다:

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

게이트는 동일합니다. skill/SKILL.md를 에이전트 스킬 디렉토리 (~/.agents/skills/ze/ 또는 Claude/Grok에 해당하는 곳)에 복사하세요.

도구

| 종류 | 도구 | | ------------------------------------------------------------ | | 읽기 · 카탈로그 | ze_list_categories, ze_list_groups, ze_search | | 읽기 · 계정 | ze_order_history, ze_track_order | | 메타 | ze_connection_status, ze_capabilities, ze_privacy_audit | | 게이트 결제 (mutations 및 intent) | ze_place_order, ze_cancel_order | | Intent 전용 | ze_logout |

HTTP (선택 사항, 루프백)

기본 전송은 stdio입니다. Streamable HTTP는 127.0.0.1에 바인딩하고 Origin을 http://127.0.0.1:<port>와 비교합니다 (ZE_MCP_ALLOWED_ORIGIN으로 재정의 가능). 이는 DNS 리바인딩 완화 조치이지 공개 서버가 아닙니다.

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 tarball 또는 기본 예제에 포함되지 않습니다. 전체 노트: SECURITY.md. 에이전트용: llms.txt.

테스트

npm test

실제 Zé 로그인은 필요하지 않습니다.