git clone https://github.com/correaito/mcp_clerk.git
cd mcp_clerk

npm install

cp env.example .env.local

# Clerk API Keys
CLERK_SECRET_KEY=your_secret_key_here
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_publishable_key_here

# Server Configuration
PORT=5000

npm run build

{
  "mcpServers": {
    "Clerk": {
      "command": "node",
      "args": ["caminho/para/mcp_clerk/dist/server-stdio.js"],
      "env": {
        "CLERK_SECRET_KEY": "your_secret_key_here",
        "NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY": "your_publishable_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "Clerk": {
      "command": "node",
      "args": ["C:\\projetos\\mcp_clerk\\dist\\server-stdio.js"],
      "env": {
        "CLERK_SECRET_KEY": "your_secret_key_here",
        "NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY": "your_publishable_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "Clerk": {
      "command": "node",
      "args": ["caminho/para/mcp_clerk/dist/server-stdio.js"],
      "env": {
        "CLERK_SECRET_KEY": "your_secret_key_here",
        "NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY": "your_publishable_key_here"
      }
    }
  }
}

{
  "mcp.servers": {
    "Clerk": {
      "command": "node",
      "args": ["caminho/para/mcp_clerk/dist/server-stdio.js"],
      "env": {
        "CLERK_SECRET_KEY": "your_secret_key_here",
        "NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY": "your_publishable_key_here"
      }
    }
  }
}

npm start

npx @modelcontextprotocol/inspector

curl http://localhost:5000

curl -X POST http://localhost:5000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "list-users",
      "arguments": {
        "limit": 10,
        "offset": 0
      }
    },
    "id": 1
  }'

curl -X POST http://localhost:5000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "lock-user",
      "arguments": {
        "userId": "user_xxxxxxxxxxxxx"
      }
    },
    "id": 2
  }'

@Clerk list-users limit=5
@Clerk lock-user userId=user_2abc123def456
@Clerk unlock-user userId=user_2abc123def456

Use a ferramenta Clerk para listar os últimos 10 usuários cadastrados
Bloqueie o usuário com ID user_2abc123def456

# Desenvolvimento
npm run dev          # Servidor HTTP em modo dev
npm run dev:stdio    # Servidor STDIO em modo dev

# Produção
npm run build        # Compila o projeto
npm start           # Servidor HTTP (porta 5000)
npm run start:stdio  # Servidor STDIO

mcp_clerk/
├── src/
│   ├── server.ts           # Servidor HTTP (porta 5000)
│   ├── server-stdio.ts     # Servidor STDIO (para Cursor/VS Code)
│   └── clerk-tools.ts      # Implementação das ferramentas
├── dist/                   # Arquivos compilados
├── env.example            # Exemplo de configuração
├── .env.local             # Suas credenciais (NÃO commitado)
├── .gitignore             # Arquivos ignorados pelo Git
├── package.json           # Dependências e scripts
├── tsconfig.json          # Configuração TypeScript
└── README.md             # Este arquivo

PORT=3001