itglue-mcp-服务器
非官方 模型上下文协议（MCP） 服务器 ITGlue API使AI助手能够管理ITGlue文档、文档部分和组织。
备注：这是一个非官方的、由社区维护的项目，不隶属于Kaseya/ITGlue或得到其认可。
特性
- 13工具 涵盖文档、文档部分和组织
- 对文档和文档部分的完全CRUD支持
- 直接从您的AI助手发布文档
- 查找组织ID的组织查找
- 分页、过滤和排序支持
- Markdown和JSON响应格式
- API区域支持（美国、欧盟、澳大利亚）
- Stdio和流式HTTP传输
- Docker支持容器化部署
快速开始
克劳德桌面版
- 打开克劳德桌面并转到 设置>开发人员>编辑配置
- 添加以下内容
claude_desktop_config.json:
{
"mcpServers": {
"itglue": {
"command": "npx",
"args": ["-y", "itglue-mcp-server"],
"env": {
"ITGLUE_API_KEY": "your-api-key-here"
}
}
}
}- 保存文件并 重新启动克劳德桌面
配置文件位置：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
流式HTTP
以HTTP模式启动服务器：
ITGLUE_API_KEY=your-key npx itglue-mcp-server --transport http --port 3000然后配置您的MCP客户端：
{
"mcpServers": {
"itglue": {
"type": "streamable-http",
"url": "http://localhost:3000/mcp"
}
}
}其他MCP客户端（Cursor、Windsurf、Claude Code等）
大多数MCP客户端使用与上述相同的stdio配置格式。
欧盟或澳大利亚地区
添加 --region eu 或 --region au 对于args：
{
"mcpServers": {
"itglue": {
"command": "npx",
"args": ["-y", "itglue-mcp-server", "--region", "eu"],
"env": {
"ITGLUE_API_KEY": "your-api-key-here"
}
}
}
}环境变量
| 变量 | 描述 | 必填 | 默认 |
|---|---|---|---|
ITGLUE_API_KEY | ITGlue API密钥 | 是 | |
ITGLUE_BASE_URL | 自定义API基础URL | 否 | https://api.itglue.com |
TRANSPORT | 运输方式： stdio 或 http | 没有 | stdio |
PORT | HTTP服务器端口 | 否 | 3000 |
CLI选项
--api-key ITGlue API key (overrides env var)
--base-url Custom API base URL (overrides env var)
--region API region: us, eu, or au (default: us)
--transport Transport mode: stdio or http (default: stdio)
--port
HTTP server port (default: 3000)
--help Show help
--version Show version工具
组织
| 工具 | 说明 |
|---|---|
itglue_list_organizations | 使用过滤和分页功能搜索和列出组织 |
itglue_get_organization | 获取特定组织的详细信息 |
文件
| 工具 | 说明 |
|---|---|
itglue_list_documents | 在全球或组织内列出文档 |
itglue_get_document | 获取包含所有嵌入部分的文档 |
itglue_create_document | 创建新的草稿文档 |
itglue_update_document | 更新文档元数据（名称） |
itglue_publish_document | 发布文档草稿 |
itglue_delete_documents | 永久删除一个或多个文档 |
文档章节
| 工具 | 说明 |
|---|---|
itglue_list_document_sections | 列出文档中的所有部分 |
itglue_get_document_section | 获取包含完整内容的特定部分 |
itglue_create_document_section | 添加一个部分（文本、标题、图库、步骤） |
itglue_update_document_section | 更新节内容、类型或位置 |
itglue_delete_document_section | 永久删除分区 |
API密钥设置
- 以管理员身份登录ITGlue
- 首选 帐户>设置>API密钥
- 生成新的自定义API密钥
- 复制密钥并将其设置为
ITGLUE_API_KEY
ITGlue自动吊销90天以上未使用的API密钥。
区域
| 区域 | 基本URL |
|---|---|
| 美国（默认） | https://api.itglue.com |
| 欧盟 | https://api.eu.itglue.com |
| 澳大利亚 | https://api.au.itglue.com |
速率限制
ITGlue API每5分钟窗口最多允许3000个请求。如果超过速率限制，服务器将返回明确的错误消息。
码头工人
在本地构建和运行
docker build -t itglue-mcp-server .
docker run --rm -p 3000:3000 -e ITGLUE_API_KEY=your-key itglue-mcp-server默认情况下，Docker镜像在端口3000上以HTTP传输模式运行。
预构建图像
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健康检查
curl http://localhost:3000/health发展
# 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由Junto赞助
安全的客户端访问、自动票证解析和智能IT操作。了解Junto如何改变MSP服务交付 汇集.com.
许可证
麻省理工学院