Zé Delivery MCP

Inoffiziell. Weder mit Zé Delivery noch mit Ambev verbunden, von diesen empfohlen oder unterstützt. Die Consumer-GraphQL-API unter api.ze.delivery/public-api kann sich ohne Vorankündigung ändern.

Zahlt standardmäßig nie. ze_place_order und ze_cancel_order tun nichts, außer ZE_ALLOW_MUTATIONS ist aktiviert und explicit_user_intent ist true. Gast-Tokens können keine Zahlungen auslösen. Straße, Telefon, E-Mail und GPS/latlng-Polylinien werden geschwärzt.

Einrichtung in 60 Sekunden

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

Das Token ist kein OAuth. Fangen Sie eine Consumer-Anfrage an api.ze.delivery ab → kopieren Sie den Authorization-Header. Katalog/Suche funktionieren weiterhin ohne Token; Zahlungs-Tools bleiben blockiert.

Stdio-Snippet (Claude Desktop, Cursor, Grok Bot). Setzen Sie keine Mutationen im Snippet:

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

Siehe examples/claude-desktop.json und examples/grok-bot.md.

Related MCP server: Texas Grocery MCP

Skill oder MCP

Dasselbe Paket, zwei Zugänge. MCP registriert Tools über stdio/HTTP. Der Skill ist der Workflow (suchen → vor der Bestellung stoppen) und kann über die CLI dieselben Tools steuern, wenn der Client kein MCP hat:

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

Die Zugangsbeschränkungen sind identisch. Kopieren Sie skill/SKILL.md in das Skills-Verzeichnis Ihres Agenten (~/.agents/skills/ze/ oder das entsprechende Claude/Grok-Verzeichnis).

Tools

HTTP (optional, Loopback)

Der Standardtransport ist stdio. Streamable HTTP bindet an 127.0.0.1 und prüft Origin gegen http://127.0.0.1:<port> (überschreibbar mit ZE_MCP_ALLOWED_ORIGIN). Dies dient dem Schutz vor DNS-Rebinding und ist kein öffentlicher Server.

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

Sicherheit

Tokens liegen in ~/.ze-mcp/tokens.json (0600). Sie sind nicht in git, im npm-Tarball oder in den Standardbeispielen enthalten. Ausführliche Hinweise: SECURITY.md. Für Agents: llms.txt.

Tests

npm test

Kein Live-Zé-Login erforderlich.