Claude Desktop

Configure o Karposs MCP no app desktop do Claude para macOS e Windows. Autenticação via OAuth — sem copiar chaves.

Pré-requisitos

Claude Desktop instalado (macOS ou Windows)
Uma conta no Karposs (o login é feito automaticamente na primeira vez)

Localizar o arquivo de configuração

O arquivo claude_desktop_config.json fica em locais diferentes por sistema operacional:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\\Claude\\claude_desktop_config.json

Atalho: Settings > Developer > Edit Config.

Configuração

Adicione o bloco karposs ao objeto mcpServers:

claude_desktop_config.json

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

Só isso. Na primeira vez que usar uma tool do Karposs, o Claude Desktop abre o navegador para login. Depois disso, funciona automaticamente.

Reiniciar o Claude Desktop

Após salvar o arquivo, feche e reabra o Claude Desktop. O servidor MCP será carregado na inicialização.

Para confirmar, verifique o ícone de ferramentas no chat. Você deve ver karposs listado entre os servidores MCP.

Começar a usar

Com o servidor ativo, peça em linguagem natural:

→“Quais projetos eu tenho no Karposs?”

→“Cria uma tarefa 'Revisar proposta' no projeto Marketing”

→“Quais tarefas estão atrasadas?”

→“Mostra quem faz parte do meu time”

Modo avançado

Configuração com API Key (para automações)

Se precisar autenticar sem login interativo, adicione a API Key no header:

claude_desktop_config.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.