Quick Start

Configure o Karpos MCP em menos de 5 minutos e comece a gerenciar projetos e tarefas direto do terminal.

1. Gerar sua API Key

No Karpos, vá em Configurações > API Keys > Nova API Key. Copie a chave gerada — ela é exibida uma única vez.

Exemplo de API Key

kp_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0

Formato: prefixo kp_ + 40 caracteres aleatórios.

2. Adicionar o servidor MCP

O jeito mais rápido é pelo terminal. Se você usa o Claude Code, rode:

Terminal

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 chave do passo anterior.

Alternativa: arquivo de configuração

Se preferir configurar manualmente, crie o arquivo .claude/mcp.json na raiz do seu projeto:

.claude/mcp.json

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

Adicione .claude/mcp.json ao .gitignore para não versionar a chave.

Para outros clientes, veja os guias de Claude Desktop e Cursor.

3. Testar a conexão

Confirme que o servidor foi adicionado:

Terminal

claude mcp list

Você deve ver karpos na lista. Agora abra o Claude Code e peça:

Terminal

claude

Dentro do Claude Code, peça para ele usar a tool ping. Resposta esperada:

Você diz

"Use a tool ping do karpos"

Resposta

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

Se authenticated: true, está tudo certo.

4. Usar com linguagem natural

Agora é só pedir em linguagem natural. O Claude Code vai usar as tools do Karpos automaticamente.

Exemplos

"Lista meus projetos no Karpos"

"Cria uma tarefa 'Revisar landing page' no projeto Plataforma EAD"

"Mostra as tarefas abertas do projeto Website"

"Marca a tarefa 'Setup CI/CD' como concluída"

"Adiciona um comentário na tarefa X: 'Deploy feito com sucesso'"

Veja mais exemplos na página de Casos de Uso.