Como conectar o EuGestor ao Claude Desktop via MCP

Pre-requisitos

Plano Pro ou superior (o conector MCP nao esta disponivel no Free).
Claude Desktop instalado (macOS ou Windows).
Node.js 20+ na sua maquina.
Uma chave de API do EuGestor — gere em Configuracoes > Integracoes > Ver chaves de API.

Passo 1: Gerar uma chave de API

Acesse core.eugestor.net/dashboard/settings?tab=integrations.
Clique em "Ver chaves de API".
Clique em "Nova Chave", de um nome (ex: "Claude Desktop") e marque os modulos/permissoes.
Copie a chave imediatamente — ela aparece uma unica vez. Formato: eg_xxxxxxxx....

Passo 2: Configurar o Claude Desktop

Edite o arquivo de configuracao do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione (ou inclua na chave mcpServers):

{
  "mcpServers": {
    "eugestor": {
      "command": "npx",
      "args": ["-y", "tsx", "/caminho/para/eugestor-core/mcp/server.ts"],
      "env": {
        "EUGESTOR_API_KEY": "eg_sua_chave_aqui",
        "EUGESTOR_BASE_URL": "https://core.eugestor.net"
      }
    }
  }
}

Passo 3: Reiniciar o Claude Desktop

Feche e reabra o Claude Desktop. O icone de ferramentas (martelo) deve aparecer no canto inferior direito do chat — clique para ver as 15 ferramentas do EuGestor disponiveis.

Passo 4: Testar

No chat do Claude, digite:

"Liste minhas tarefas em andamento no EuGestor"

O Claude vai chamar get_tasks automaticamente e mostrar os resultados.

Solucao de problemas

"Servidor nao aparece": confira o caminho absoluto no args e se o tsx esta instalado (npm i -g tsx).
"401 Unauthorized": chave revogada ou plano nao e Pro+. Gere uma nova chave em Configuracoes.
"Tool not found": voce esta numa versao antiga; atualize o repo local com git pull.

Seguranca

A chave fica apenas no seu dispositivo local, nunca trafega para servidores da Anthropic. Toda chamada vai direto do Claude Desktop -> servidor MCP local -> API EuGestor.