Jitbit Helpdesk

Jitbit Helpdesk MCP Server

Um servidor MCP (Model Context Protocol) que permite que assistentes de IA pesquisem e leiam tickets de suporte do Jitbit Helpdesk. Funciona com instalações SaaS e on-premise.

⚠️ Use o endpoint HTTP hospedado quando possível. O Jitbit fornece um endpoint MCP HTTP integrado em /api/mcp em todas as instalações SaaS e on-premise com versão 11.21 ou posterior. Essa é a forma preferida de conectar assistentes de IA ao Jitbit — sem instalação local, sempre em sincronia com as versões do Jitbit. Veja a documentação do MCP do Jitbit. A partir da 2.x, este pacote npm é um proxy stdio leve para o mesmo endpoint, para clientes que ainda não suportam servidores MCP HTTP remotos. É necessário Jitbit 11.21 ou posterior. Se você estiver em uma versão on-premise mais antiga, permaneça na jitbit-helpdesk-mcp@1.x.

Configuração

Duas opções:

1. Endpoint HTTP hospedado (recomendado) — conecte seu cliente MCP diretamente ao /api/mcp do Jitbit. Use isso sempre que seu cliente suportar transporte MCP HTTP.
2. Pacote npm local (proxy stdio) — este repositório. Use-o quando seu cliente MCP suportar apenas transporte stdio. Ele encaminha cada solicitação para {JITBIT_URL}/api/mcp e não adiciona nada de próprio.

Opção 1: Endpoint HTTP hospedado

Claude Code

claude mcp add --transport http jitbit-helpdesk https://yourcompany.jitbit.com/api/mcp \
  --header "Authorization: Bearer your-api-token"

Claude Desktop, Cursor, Windsurf

{
  "mcpServers": {
    "jitbit-helpdesk": {
      "type": "http",
      "url": "https://yourcompany.jitbit.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}

Opção 2: Pacote npm local (proxy stdio)

Claude Code

claude mcp add jitbit-helpdesk \
  -e JITBIT_URL=https://yourcompany.jitbit.com \
  -e JITBIT_TOKEN=your-api-token \
  -- npx -y jitbit-helpdesk-mcp

Claude Desktop, Cursor, Windsurf

Adicione ao seu arquivo de configuração:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows)
• Cursor: Configurações > Servidores MCP
• Windsurf: Configurações > Servidores MCP

{
  "mcpServers": {
    "jitbit-helpdesk": {
      "command": "npx",
      "args": ["-y", "jitbit-helpdesk-mcp"],
      "env": {
        "JITBIT_URL": "https://yourcompany.jitbit.com",
        "JITBIT_TOKEN": "your-api-token"
      }
    }
  }
}

Variáveis de Ambiente

Variável	Obrigatório	Descrição
JITBIT_URL	Sim	URL base da sua instância Jitbit (SaaS: https://yourcompany.jitbit.com, on-prem: URL do seu servidor)
JITBIT_TOKEN	Sim	Token de API — veja abaixo

Obtendo seu token de API

1. Faça login no seu Jitbit Helpdesk
2. Vá para o seu Perfil de Usuário (clique no seu avatar no canto superior direito)
3. Clique no botão "API Token"
4. Copie o token e use-o como o valor de JITBIT_TOKEN

Ferramentas

O proxy expõe quaisquer ferramentas que a instância Jitbit conectada anuncia em /api/mcp — normalmente pesquisa, listagem e leitura de tickets, além de qualquer coisa que o Jitbit adicionar em versões futuras. Use a listagem de ferramentas do seu cliente MCP (ou a documentação do MCP do Jitbit) para o catálogo atualizado.

Desenvolvimento

npm install
npm run build

Licença

MIT