Claude Code

Conecte o Karposs ao Claude Code com um comando. OAuth cuida da autenticação automaticamente.

Pré-requisitos

Node.js 18+ instalado
Uma conta na Anthropic (para autenticar o Claude Code)
Uma conta no Karposs (o login é feito automaticamente na primeira vez)

Instalar o Claude Code

Se ainda não tem o Claude Code, instale via npm:

Terminal

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

Verifique se instalou corretamente:

Terminal

claude --version

Adicionar o Karposs

Rode este comando no terminal:

Terminal

claude mcp add karposs --transport http https://next-mcp-server.onrender.com/mcp

Pronto. Na primeira vez que usar uma tool do Karposs, o Claude Code abre o navegador para você fazer login. Depois disso, funciona automaticamente.

Escopo do servidor

Por padrão, o servidor é adicionado no escopo do projeto (pasta atual). Para adicionar globalmente (todos os projetos):

Terminal

claude mcp add karposs --transport http https://next-mcp-server.onrender.com/mcp --scope user

Verificar a conexão

Confirme que o servidor foi adicionado:

Terminal

claude mcp list

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

Terminal

claude

Dentro do chat, peça:

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

Resposta esperada

{
  "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, use linguagem natural. O Claude chama as tools do Karposs automaticamente.

Exemplos no terminal

you: Lista meus projetos no Karposs

you: Cria uma tarefa "Deploy v2" no projeto Website

you: Quais tarefas estão atrasadas?

you: Move todas tarefas "em review" para "done"

you: Adiciona um comentário na tarefa X: "Corrigido no PR #42"

Comandos úteis

Comando	O que faz
`claude`	Abre o Claude Code interativo
`claude mcp list`	Lista servidores MCP configurados
`claude mcp add`	Adiciona um servidor MCP
`claude mcp remove karposs`	Remove o servidor MCP

Modo avançado

Configuração manual com API Key

Para automações, scripts ou CI/CD onde login interativo não é possível, use uma API Key:

Terminal

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

Ou via arquivo JSON:

.claude/mcp.json

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

Gere sua API Key em Configurações > API Keys. Adicione ao .gitignore para não versionar a chave.