@ozon-mcp/mcp-server

MCP server for Ozon Performance API tools.

Default usage

The published package starts on stdio by default:

npx @ozon-mcp/mcp-server

Install credentials and Claude Desktop config on macOS:

npx @ozon-mcp/mcp-server install

Initialize credentials only:

npx @ozon-mcp/mcp-server init
npx @ozon-mcp/mcp-server doctor

Add it to Codex:

codex mcp add ozon-mcp -- npx -y @ozon-mcp/mcp-server

Credential storage

The server uses one local .env file:

• macOS: ~/Library/Application Support/ozon-mcp/.env
• Windows: %APPDATA%/ozon-mcp/.env
• Linux: ${XDG_CONFIG_HOME:-~/.config}/ozon-mcp/.env

Manual file format:

OZON_CLIENT_ID=<your_client_id>
OZON_CLIENT_SECRET=<your_client_secret>

On macOS, install also updates:

• ~/Library/Application Support/Claude/claude_desktop_config.json

with:

{
  "mcpServers": {
    "ozon-mcp": {
      "command": "npx",
      "args": ["-y", "@ozon-mcp/mcp-server"]
    }
  }
}

Optional values in the same file:

MCP_PORT=3000
OZON_API_BASE_URL=https://api-performance.ozon.ru
OZON_TOKEN_PATH=/api/client/token
OZON_MCP_VERSION_HASH=<override_hash>
OZON_MCP_VERSION_HASH_SEED=<custom_seed>

Tool behavior

• handshake, init, and doctor are available without auth.
• Ozon tools remain visible even when auth is missing.
• Guarded Ozon tool calls return setup guidance instead of crashing the server.

HTTP mode

Use HTTP explicitly when self-hosting or developing locally:

npx @ozon-mcp/mcp-server --transport http

For repo development:

pnpm install
cp ../../.env.example ../../.env
pnpm dev