ITGlue

Servidor MCP no oficial para la API de ITGlue

Documentación

itglue-mcp-server

Un servidor no oficial del Model Context Protocol (MCP) para la API de ITGlue. Permite a los asistentes de IA gestionar documentos, secciones de documentos y organizaciones de ITGlue.

Nota: Este es un proyecto no oficial mantenido por la comunidad y no está afiliado ni respaldado por Kaseya/ITGlue.

Características

13 herramientas que cubren documentos, secciones de documentos y organizaciones
Soporte completo de CRUD para documentos y secciones de documentos
Publica documentos directamente desde tu asistente de IA
Búsqueda de organizaciones para encontrar IDs de organizaciones
Soporte de paginación, filtrado y ordenación
Formatos de respuesta en Markdown y JSON
Soporte de API regional (EE. UU., UE, Australia)
Transportes Stdio y HTTP de streaming
Soporte de Docker para despliegue en contenedores

Inicio Rápido

Claude Desktop

Abre Claude Desktop y ve a Configuración > Desarrollador > Editar Config
Añade lo siguiente a claude_desktop_config.json:

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

Guarda el archivo y reinicia Claude Desktop

Ubicaciones del archivo de configuración:

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

HTTP de Streaming

Inicia el servidor en modo HTTP:

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

Luego configura tu cliente MCP:

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

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

La mayoría de los clientes MCP usan el mismo formato de configuración stdio mostrado arriba.

Regiones de la UE o Australia

Añade --region eu o --region au a los argumentos:

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

Variables de Entorno

Variable	Descripción	Requerida	Predeterminado
`ITGLUE_API_KEY`	Clave de API de ITGlue	Sí
`ITGLUE_BASE_URL`	URL base de API personalizada	No	`https://api.itglue.com`
`TRANSPORT`	Modo de transporte: `stdio` o `http`	No	`stdio`
`PORT`	Puerto del servidor HTTP	No	`3000`

Opciones 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

Herramientas

Organizaciones

Herramienta	Descripción
`itglue_list_organizations`	Busca y lista organizaciones con filtrado y paginación
`itglue_get_organization`	Obtén información detallada sobre una organización específica

Documentos

Herramienta	Descripción
`itglue_list_documents`	Lista documentos globalmente o dentro de una organización
`itglue_get_document`	Obtén un documento con todas las secciones integradas
`itglue_create_document`	Crea un nuevo documento en borrador
`itglue_update_document`	Actualiza los metadatos del documento (nombre)
`itglue_publish_document`	Publica un documento en borrador
`itglue_delete_documents`	Elimina permanentemente uno o más documentos

Secciones de Documentos

Herramienta	Descripción
`itglue_list_document_sections`	Lista todas las secciones de un documento
`itglue_get_document_section`	Obtén una sección específica con contenido completo
`itglue_create_document_section`	Añade una sección (Texto, Encabezado, Galería, Paso)
`itglue_update_document_section`	Actualiza el contenido, tipo o posición de la sección
`itglue_delete_document_section`	Elimina permanentemente una sección

Configuración de la Clave de API

Inicia sesión en ITGlue como Administrador
Ve a Cuenta > Configuración > Claves de API
Genera una nueva Clave de API personalizada
Copia la clave y establécela como ITGLUE_API_KEY

ITGlue revoca automáticamente las claves de API que no se usan durante más de 90 días.

Regiones

Región	URL Base
EE. UU. (predeterminada)	`https://api.itglue.com`
UE	`https://api.eu.itglue.com`
Australia	`https://api.au.itglue.com`

Límite de Velocidad

La API de ITGlue permite un máximo de 3,000 solicitudes por ventana de 5 minutos. El servidor devolverá mensajes de error claros si se excede el límite de velocidad.

Docker

Compilar y ejecutar localmente

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

La imagen de Docker se ejecuta en modo de transporte HTTP por defecto en el puerto 3000.

Imagen precompilada

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

Verificación de salud

curl http://localhost:3000/health

Desarrollo

# 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

Acceso seguro para clientes, resolución automatizada de tickets y operaciones de TI inteligentes. Descubre cómo Junto está transformando la entrega de servicios de MSP en juntoai.com.

Licencia

MIT