Instalação - WiseDesk Developers

Pré-requisitos

Node.js 20 ou superior
Uma API key com os escopos que o assistente deve usar

Baixe e compile o servidor

git clone https://github.com/DevJohnL/wisedesk-mcp.git
cd wisedesk-mcp
npm install
npm run build

Adicione ao seu cliente

Claude Code
Claude Desktop
Cursor
VS Code

claude mcp add wisedesk \
  --env WISEDESK_API_KEY=wd_live_xxx \
  -- node /caminho/para/wisedesk-mcp/build/main.js

Edite claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "wisedesk": {
      "command": "node",
      "args": ["/caminho/para/wisedesk-mcp/build/main.js"],
      "env": { "WISEDESK_API_KEY": "wd_live_xxx" }
    }
  }
}

Reinicie o Claude Desktop.

Em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "wisedesk": {
      "command": "node",
      "args": ["/caminho/para/wisedesk-mcp/build/main.js"],
      "env": { "WISEDESK_API_KEY": "wd_live_xxx" }
    }
  }
}

Em .vscode/mcp.json:

{
  "servers": {
    "wisedesk": {
      "type": "stdio",
      "command": "node",
      "args": ["/caminho/para/wisedesk-mcp/build/main.js"],
      "env": { "WISEDESK_API_KEY": "wd_live_xxx" }
    }
  }
}

Teste

Pergunte ao assistente: “Liste meus projetos no WiseDesk”.

Variáveis de ambiente

Variável	Obrigatória	Descrição
`WISEDESK_API_KEY`	Sim	API key `wd_live_...`
`WISEDESK_API_URL`	Não	Base da API. Padrão: `https://wisedesk-api.wiseapp360.com`

Solução de problemas

O servidor não aparece / encerra ao iniciar

Verifique os logs do cliente. As mensagens API key inválida… e Defina a variável WISEDESK_API_KEY… indicam problema na key.

Faltam tools

O servidor só registra tools permitidas pelos escopos da key, e as do Agile exigem o ambiente Agile na empresa. Confira com GET /v1/me.

Testar sem um assistente

Use o MCP Inspector (Node 22.19+):

npx @modelcontextprotocol/inspector --cli -e WISEDESK_API_KEY=wd_live_xxx \
  node build/main.js --protocol-era modern --method tools/list

⌘I

​Pré-requisitos

​Variáveis de ambiente

​Solução de problemas

Pré-requisitos

Variáveis de ambiente

Solução de problemas