Claude Code

Pré-requisitos

• Node.js 18+ instalado
• Uma conta na Anthropic (para autenticar o Claude Code)
• Uma API Key do Karpos (gerada em Configurações > API Keys)

Instalar o Claude Code

Instale globalmente via npm:

npm install -g @anthropic-ai/claude-code

Verifique se instalou corretamente:

claude --version

Fazer login no Claude Code

Na primeira vez que rodar o Claude Code, ele vai pedir autenticação. Rode no terminal:

claude

Ele vai abrir uma janela no navegador para você fazer login com sua conta Anthropic. Após autorizar, volte ao terminal — ele vai confirmar que está autenticado.

claude login

Adicionar o servidor MCP via terminal

Com o Claude Code instalado e logado, adicione o servidor Karpos MCP:

claude mcp add karpos \
  --transport http \
  https://next-mcp-server.onrender.com/mcp \
  --header "Authorization: Bearer kp_sua_api_key_aqui"

Substitua kp_sua_api_key_aqui pela sua chave real do Karpos.

claude mcp add karpos \
  --transport http \
  https://next-mcp-server.onrender.com/mcp \
  --header "Authorization: Bearer kp_sua_api_key_aqui" \
  --scope user

{
  "mcpServers": {
    "karpos": {
      "type": "http",
      "url": "https://next-mcp-server.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer kp_sua_api_key_aqui"
      }
    }
  }
}

Verificar a conexão

Confirme que o servidor foi adicionado:

claude mcp list

Você deve ver karpos na lista. Agora abra o Claude Code e teste:

claude

Dentro do chat, peça:

"Usa a tool ping do karpos para testar a conexão"

{
  "status": "ok",
  "version": "1.0.0",
  "authenticated": true,
  "user": "Seu Nome"
}

Se authenticated: true, está tudo configurado.

Começar a usar

Com o servidor conectado, você usa linguagem natural. O Claude vai chamar as tools do Karpos automaticamente.

Comandos úteis