Documentation

Connect Claude Code

Install WhatWins MCP from the terminal with an organization-scoped static key.

Claude Code supports remote HTTP MCP servers from the CLI. Use a dedicated static WhatWins key for this setup.

Create a key

Open Organization settings → WhatWins AI → MCP access → Claude Code, then select Create key. Copy the token immediately; WhatWins cannot show it again.

Add the server

Run the generated command in your terminal:

claude mcp add --transport http --scope user whatwins \
  https://whatwins.io/api/mcp \
  --header "Authorization: Bearer ww_mcp_your_token"

The user scope makes the server available across your Claude Code projects. Use a narrower project or local scope if you do not want that behavior.

Successful output looks like:

Added HTTP MCP server whatwins with URL: https://whatwins.io/api/mcp to user config
Headers: {
  "Authorization": "[REDACTED]"
}

Verify the installation

claude mcp list

Then start Claude Code and run:

/mcp

WhatWins should appear as connected with eight available tools.

Test from Claude Code

Use the WhatWins MCP to discover 5 skincare shops in the US with at least 20 live ads.

Remove or rotate the key

Remove the MCP entry from Claude Code, revoke its key in WhatWins, then create a replacement if needed. Never reuse a key that appeared in terminal history shared with another person.

Do not paste a live key into chat

The command belongs in your terminal. If a token was pasted into a conversation or committed to a repository, revoke it immediately.