🎫 MCP Movidesk Server

Servidor MCP (Model Context Protocol) para gerenciamento de tickets do Movidesk, construído em TypeScript + Node.js.

Permite que agentes de IA criem, consultem, pesquisem e gerenciem tickets diretamente no Movidesk, sem precisar acessar a plataforma manualmente.

📋 Ferramentas Disponíveis

Related MCP server: Xalantis MCP Server

🚀 Instalação

1. Instalar dependências

cd c:\Users\Usuario\Documents\Mcp_Eagle
npm install

2. Configurar token da API

Copie o arquivo de exemplo e insira seu token:

copy .env.example .env

Edite o arquivo .env e substitua seu_token_aqui pelo seu token real:

MOVIDESK_TOKEN=seu_token_real_aqui

Onde encontrar o token: Movidesk > Configuração > Conta > Parâmetros > Aba Ambiente

3. Compilar o projeto

npm run build

⚙️ Configuração no Antigravity

Adicione a seguinte configuração ao seu settings.json do Antigravity:

{
  "mcpServers": {
    "mcp-movidesk": {
      "command": "node",
      "args": ["c:\\Users\\Usuario\\Documents\\Mcp_Eagle\\dist\\index.js"],
      "env": {
        "MOVIDESK_TOKEN": "seu_token_aqui"
      }
    }
  }
}

🧪 Testes

Execute todos os testes:

npm test

Modo watch (re-executa ao salvar):

npm run test:watch

� Docker (Swarm & Portainer)

O projeto está configurado para ser implantado facilmente através de Portainer/Docker Swarm com suporte a Traefik e HTTPS nativo via pacote Express.

Build da Imagem

Para criar a imagem Docker otimizada:

docker build -t mcp-movidesk-eagle:latest .

Deploy no Portainer (Stacks)

1. Acesse seu Portainer.

2. Navegue até Swarm > Stacks e clique em Add stack.

3. Copie o conteúdo do arquivo docker-compose.yml e cole no Web Editor.

4. Na seção Environment variables, adicione MOVIDESK_TOKEN com o seu token real.

5. Clique em Deploy the stack.

A configuração utiliza o Traefik como proxy e vai publicar automaticamente em https://mcp.wizeflowsolutions.com/mcp.

🌐 Configuração Remota (via Domínio)

Para utilizar as ferramentas do MCP em clientes modernos ou em nuvem que suportam conexões via domínio (SSE - Server-Sent Events) como Dify, Flowise, Cursor ou LangChain, você informará que o tipo de conexão é remota.

O formato JSON para essas configurações:

{
  "mcpServers": {
    "mcp-movidesk-cloud": {
      "type": "sse",
      "url": "https://mcp.wizeflowsolutions.com/mcp"
    }
  }
}

Atenção: Em aplicativos puramente locais não adaptados para leitura web, utilize o método CLI fornecido na seção de "Configuração no Antigravity".

�📁 Estrutura do Projeto

src/
├── index.ts                     # Ponto de entrada (stdio transport)
├── servidor-mcp.ts              # Registra as 7 ferramentas
├── cliente-movidesk/
│   ├── api.ts                   # Cliente HTTP com rate-limiting
│   └── tipos.ts                 # Tipos TypeScript (interfaces/enums)
├── ferramentas/
│   ├── criar-ticket.ts          # Criar ticket com macro
│   ├── consultar-ticket.ts      # Consultar ticket por ID
│   ├── buscar-conhecimento.ts   # Base de conhecimento
│   ├── adicionar-interacao.ts   # Adicionar interação
│   ├── listar-tickets.ts        # Listar tickets do cliente
│   ├── alterar-status.ts        # Alterar status
│   └── atribuir-agente.ts       # Atribuir agente
└── utilidades/
    ├── formatador-html.ts       # Markdown → HTML
    ├── validacoes.ts            # Validações (CPF, CNPJ, email)
    └── macros-suporte.ts        # Templates HTML de macros
testes/
├── formatador-html.test.ts
├── validacoes.test.ts
├── api-cliente.test.ts
└── ferramentas.test.ts

🔧 Desenvolvimento

# Executar em modo desenvolvimento (com tsx)
npm run dev

# Compilar TypeScript
npm run build

# Executar versão compilada
npm start

📄 Licença

MIT