ITGlue

Servidor MCP não oficial para a API do ITGlue

Documentação

itglue-mcp-server

Um servidor não oficial do Model Context Protocol (MCP) para a API do ITGlue. Permite que assistentes de IA gerenciem documentos, seções de documentos e organizações do ITGlue.

Nota: Este é um projeto não oficial, mantido pela comunidade, e não é afiliado ou endossado pela Kaseya/ITGlue.

Recursos

13 ferramentas cobrindo documentos, seções de documentos e organizações
Suporte completo a CRUD para documentos e seções de documentos
Publique documentos diretamente do seu assistente de IA
Busca de organizações para encontrar IDs de organizações
Suporte a paginação, filtragem e ordenação
Formatos de resposta em Markdown e JSON
Suporte a API regional (EUA, UE, Austrália)
Transportes Stdio e HTTP com streaming
Suporte a Docker para implantação em contêineres

Início Rápido

Claude Desktop

Abra o Claude Desktop e vá para Configurações > Desenvolvedor > Editar Config
Adicione o seguinte ao claude_desktop_config.json:

{
  "mcpServers": {
    "itglue": {
      "command": "npx",
      "args": ["-y", "itglue-mcp-server"],
      "env": {
        "ITGLUE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Salve o arquivo e reinicie o Claude Desktop

Locais do arquivo de configuração:

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

HTTP com Streaming

Inicie o servidor no modo HTTP:

ITGLUE_API_KEY=your-key npx itglue-mcp-server --transport http --port 3000

Em seguida, configure seu cliente MCP:

{
  "mcpServers": {
    "itglue": {
      "type": "streamable-http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Outros Clientes MCP (Cursor, Windsurf, Claude Code, etc.)

A maioria dos clientes MCP usa o mesmo formato de configuração stdio mostrado acima.

Regiões UE ou Austrália

Adicione --region eu ou --region au aos argumentos:

{
  "mcpServers": {
    "itglue": {
      "command": "npx",
      "args": ["-y", "itglue-mcp-server", "--region", "eu"],
      "env": {
        "ITGLUE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Variáveis de Ambiente

Variável	Descrição	Obrigatória	Padrão
`ITGLUE_API_KEY`	Chave da API ITGlue	Sim
`ITGLUE_BASE_URL`	URL base personalizada da API	Não	`https://api.itglue.com`
`TRANSPORT`	Modo de transporte: `stdio` ou `http`	Não	`stdio`
`PORT`	Porta do servidor HTTP	Não	`3000`

Opções de CLI

--api-key <key>         ITGlue API key (overrides env var)
--base-url <url>        Custom API base URL (overrides env var)
--region <region>       API region: us, eu, or au (default: us)
--transport <mode>      Transport mode: stdio or http (default: stdio)
--port <port>           HTTP server port (default: 3000)
--help                  Show help
--version               Show version

Ferramentas

Organizações

Ferramenta	Descrição
`itglue_list_organizations`	Pesquisar e listar organizações com filtragem e paginação
`itglue_get_organization`	Obter informações detalhadas sobre uma organização específica

Documentos

Ferramenta	Descrição
`itglue_list_documents`	Listar documentos globalmente ou dentro de uma organização
`itglue_get_document`	Obter um documento com todas as seções incorporadas
`itglue_create_document`	Criar um novo documento rascunho
`itglue_update_document`	Atualizar metadados do documento (nome)
`itglue_publish_document`	Publicar um documento rascunho
`itglue_delete_documents`	Excluir permanentemente um ou mais documentos

Seções de Documentos

Ferramenta	Descrição
`itglue_list_document_sections`	Listar todas as seções em um documento
`itglue_get_document_section`	Obter uma seção específica com conteúdo completo
`itglue_create_document_section`	Adicionar uma seção (Texto, Título, Galeria, Etapa)
`itglue_update_document_section`	Atualizar conteúdo, tipo ou posição da seção
`itglue_delete_document_section`	Excluir permanentemente uma seção

Configuração da Chave da API

Faça login no ITGlue como Administrador
Vá para Conta > Configurações > Chaves da API
Gere uma nova Chave de API Personalizada
Copie a chave e defina-a como ITGLUE_API_KEY

O ITGlue revoga automaticamente chaves de API não utilizadas por mais de 90 dias.

Regiões

Região	URL Base
EUA (padrão)	`https://api.itglue.com`
UE	`https://api.eu.itglue.com`
Austrália	`https://api.au.itglue.com`

Limite de Taxa

A API do ITGlue permite um máximo de 3.000 solicitações por janela de 5 minutos. O servidor retornará mensagens de erro claras se o limite de taxa for excedido.

Docker

Compilar e executar localmente

docker build -t itglue-mcp-server .
docker run --rm -p 3000:3000 -e ITGLUE_API_KEY=your-key itglue-mcp-server

A imagem Docker executa no modo de transporte HTTP por padrão na porta 3000.

Imagem pré-compilada

docker pull ghcr.io/junto-platforms/itglue-mcp-server:latest
docker run --rm -p 3000:3000 -e ITGLUE_API_KEY=your-key ghcr.io/junto-platforms/itglue-mcp-server:latest

Verificação de saúde

curl http://localhost:3000/health

Desenvolvimento

# Install dependencies
npm install

# Build
npm run build

# Run locally (stdio)
ITGLUE_API_KEY=your-key node dist/index.js

# Run locally (HTTP)
ITGLUE_API_KEY=your-key node dist/index.js --transport http

# Development with auto-reload
ITGLUE_API_KEY=your-key npm run dev

# Development with HTTP transport
ITGLUE_API_KEY=your-key npm run dev:http

# Run tests
npm test

Patrocinado por Junto

Acesso seguro ao cliente, resolução automatizada de tickets e operações de TI inteligentes. Descubra como a Junto está transformando a prestação de serviços de MSP em juntoai.com.

Licença

MIT