install

Make your AI assistant your personal shopper.

AEKO Shop runs as an MCP server inside your AI client. One install, one consent, and your agent can browse brands, save preferences, and draft orders on your behalf. No accounts to manage on AEKO Shop itself.

One-time consentNo passwordPKCE-secured OAuth

Codex App + CLI

Paste this into ~/.codex/config.toml. Same config works for the Codex desktop app and the Codex CLI — restart Codex (or start a new Codex CLI session) after saving.

[mcp_servers.aeko-shop-personal]
command = "npx"
args = ["-y", "aeko-shop-mcp", "personal"]

Claude Desktop

Edit your claude_desktop_config.json and restart Claude. The first call opens a browser consent screen.

{
  "mcpServers": {
    "aeko-shop-personal": {
      "command": "npx",
      "args": ["-y", "aeko-shop-mcp", "personal"]
    }
  }
}

Claude Code

One command from your terminal. The next tool call opens a browser consent screen.

claude mcp add --transport stdio aeko-shop-personal \
  -- npx -y aeko-shop-mcp personal

Gemini CLI

Drop the same mcpServers block into ~/.gemini/settings.json and run /mcp reload.

{
  "mcpServers": {
    "aeko-shop-personal": {
      "command": "npx",
      "args": ["-y", "aeko-shop-mcp", "personal"]
    }
  }
}

early access

The aeko-shop-mcp package is built and being QA'd before its first npm release. Early testers can install from source — see the repo README for npm link and npm pack instructions. The configs above are the final shape — once published, paste and go.

Paste the config

Drop the snippet into your AI client's MCP config (Claude, Codex, Gemini, or any MCP-compatible agent).

Restart the client

The client picks up the new server and opens a one-time browser consent screen.

Approve once

AEKO shows a plain-language list of what your agent can do (browse, save preferences, draft orders). Click Approve.

Talk to your agent

That's it. Ask your assistant to find brands, build a cart, or draft an order. AEKO Shop only sees the agent — never you.

are you a brand?

Brands install a separate agent.

AEKO Brand Agent connects your verified brand page to Claude, Codex, Gemini, or any MCP-compatible agent for supported brand operations. It needs to verify you control your brand's website first.

Connect your brand