Claude Code

Setup

Claude Code discovers MCP servers automatically when you add them to your config. Run:

claude mcp add goodtake https://mcp.goodtake.ai/mcp

The first time you use a GoodTake tool, Claude Code opens your browser to complete the OAuth flow — you sign in to GoodTake and a gt_ API key is minted and stored locally.

Alternatively, add it manually to your Claude Code settings:

{
  "mcpServers": {
    "goodtake": {
      "url": "https://mcp.goodtake.ai/mcp"
    }
  }
}

How the OAuth flow works

Claude Code runs the Authorization Code + PKCE flow with loopback redirect:

1. Discovers /.well-known/oauth-authorization-server
2. Registers via POST /oauth/register — gets client_id: claude-code (pre-seeded)
3. Launches a local HTTP listener on a random port
4. Opens https://goodtake.ai/oauth/authorize?...&redirect_uri=http://localhost:<port>/callback
5. Your browser hits the page → Clerk authenticates you → the backend mints a one-use code
6. The browser redirects to http://localhost:<port>/callback?code=…
7. Claude Code exchanges the code at POST /oauth/token for a gt_ API key
8. Stores the token and uses it on every subsequent /mcp request

The resulting key appears in Settings → Developer Settings as Claude MCP – <Month Year>. Revoke it there to disconnect.

Usage

With GoodTake connected, ask Claude Code directly in your editor or terminal:

/goodtake:generate a 16:9 hero banner with abstract gradients

Or just describe what you want:

"Use GoodTake to create a product screenshot mockup for my README"

Re-authentication

If your key is revoked or expires, Claude Code will prompt you to re-authenticate the next time it calls a GoodTake tool. Run the OAuth flow again by triggering any GoodTake tool use.