> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wiseapp360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalação

> Configure o servidor MCP do WiseDesk no seu assistente.

## Pré-requisitos

* Node.js 20 ou superior
* Uma [API key](/guias/autenticacao) com os escopos que o assistente deve usar

**1. Baixe e compile o servidor**

```bash theme={null}
git clone https://github.com/DevJohnL/wisedesk-mcp.git
cd wisedesk-mcp
npm install
npm run build
```

**2. Adicione ao seu cliente**

**Claude Code**

```bash theme={null}
claude mcp add wisedesk \
  --env WISEDESK_API_KEY=wd_live_xxx \
  -- node /caminho/para/wisedesk-mcp/build/main.js
```

**Claude Desktop**

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

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

Reinicie o Claude Desktop.

**Cursor**

Em `~/.cursor/mcp.json`:

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

**VS Code**

Em `.vscode/mcp.json`:

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

**3. 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+):
>
> ```bash theme={null}
> npx @modelcontextprotocol/inspector --cli -e WISEDESK_API_KEY=wd_live_xxx \
>   node build/main.js --protocol-era modern --method tools/list
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.