TANSS MCP Server

TANSS MCP服务器

用于TANSS API的综合模型上下文协议（MCP）服务器，提供与Claude或n8n等人工智能助手的无缝集成。

______________________________________________________________________

这是什么？

TANSS MCP服务器弥合了人工智能助手（如Claude/n8n）和TANSS票务管理系统之间的差距。它暴露了 238个API终点 通过 237工具 AI助手可以调用它来：

• 🎫 创建和管理门票
• 📞 处理电话和电话分配
• 💬 管理聊天和通信
• 🖥️ 跟踪IT资产（PC、外围设备、组件）
• 👥 管理员工和公司
• ⏱️ 跟踪时间和时间戳
• 📊 创建报价和发票
• 🔧 处理远程支持会话
• 📈 监控系统和设备
• 还有更多！

______________________________________________________________________

特性

✅ 238个API终点 涵盖TANSS的所有功能\ ✅ 237工具 （例如。， create_ticket)\ ✅ 双重运输方式：stdio和SSE（HTTP）\ ✅ 基于角色的身份验证：支持6种不同的代币类型\ ✅ 自动令牌管理：承载前缀处理和特定角色的令牌优先级

______________________________________________________________________

快速开始

先决条件

• Python 3.8+
• 具有API访问权限的TANSS帐户
• TANSS的API令牌

安装

1. 克隆存储库

git clone 
cd tanss-mcp

1. 安装依赖项

pip install -r requirements.txt

1. 配置服务器

创建 config.ini 从示例中可以看出：

cp config.ini.example config.ini

编辑 config.ini 并添加您的TANSS凭据：

[tanss]
base_url = https://your-tanss-instance.com/backend/
api_token = your_api_token_here

[credentials]
username = your_username
password = your_password

1. 启动服务器

对于克劳德桌面（stdio模式）：

python3 server.py --mode stdio

对于web客户端（SSE模式）：

python3 server.py --mode sse --host 0.0.0.0 --port 3001

______________________________________________________________________

配置

基本配置

最小化 config.ini:

[tanss]
base_url = https://your-tanss.com/backend/
api_token = your_access_token

[sse]
host = 127.0.0.1
port = 3001

使用角色特定令牌的高级配置

为了增强安全性和权限，请配置特定角色的令牌：

[tanss]
base_url = https://your-tanss.com/backend/
api_token = your_main_token

# Optional: Role-specific tokens for specialized operations
erp_api_token = Bearer your_erp_token
phone_api_token = Bearer your_phone_token
remote_support_api_token = Bearer your_remote_support_token
monitoring_api_token = Bearer your_monitoring_token
device_management_api_token = Bearer your_device_mgmt_token
timestamp_api_token = Bearer your_timestamp_token

[sse]
host = 192.168.0.153
port = 3001
reload = false
log_level = info

[credentials]
username = your_username
password = your_password

______________________________________________________________________

用法

使用克劳德桌面

添加到您的Claude Desktop MCP设置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "tanss": {
      "command": "python3",
      "args": ["/absolute/path/to/tanss-mcp/server.py"],
      "cwd": "/absolute/path/to/tanss-mcp"
    }
  }
}

重新启动Claude Desktop，您将可以访问所有TANSS工具！

作为SSE服务器

# Start server
python3 server.py --mode sse --host 0.0.0.0 --port 3001

# The server will be available at:
# SSE endpoint: http://your-host:3001/sse
# Messages endpoint: http://your-host:3001/messages

获取您的API代币

使用 login 工具或测试脚本：

# Start SSE server first
python3 server.py --mode sse

# In another terminal, test login
python3 test_login.py

这将生成您可以在中使用的访问和刷新令牌 config.ini.

______________________________________________________________________

可用工具

服务器提供 237种人性化工具 横跨 41个类别.

最常用的工具

🎫 票务管理（37个工具）

• create_ticket -创建新票证
• get_ticket -获取门票详细信息
• update_ticket -更新现有工单
• delete_ticket -删除工单
• get_my_tickets -获取您指定的门票
• get_all_tickets -获取所有门票
• get_company_tickets -购买公司门票
• add_ticket_comment -在工单上添加评论
• get_ticket_history -查看票证更改历史记录
• upload_ticket_file -将文件上传到工单

⏱️ 时间追踪（15个工具）

• create_timestamp -打卡/打卡或记录时间
• get_timestamps -获取时间记录
• close_day -结束当天的时间跟踪
• get_timestamp_statistics -获取时间统计信息

💬 聊天（10个工具）

• create_chat -开始新的聊天
• send_chat_message -发送消息
• close_chat -关闭聊天
• reopen_chat -重新打开已关闭的聊天
• add_chat_participant -将某人添加到聊天室

📞 电话（8种工具）

• create_call -记录电话
• get_my_calls -接听您的电话
• identify_caller -通过电话号码识别来电者
• assign_call_to_employee -分配一个呼叫

🔧 远程支持（9个工具）

• create_remote_support -创建远程支持会话
• list_remote_supports -列出所有远程支持会话
• assign_device_to_remote_support -链接设备
• assign_employee_to_remote_support -指派一名技术人员

💼 ERP集成（15个工具）

• get_company_employees -招聘公司员工
• get_company_departments -获取部门
• get_ticket_types -获取可用的门票类型
• get_ticket_statuses -获取可用票证状态
• create_invoice -创建发票
• create_customer -创建客户

🖥️ IT资产管理

• create_pc / update_pc / delete_pc -管理计算机
• create_peripheral / update_peripheral -管理外围设备
• create_component / update_component -管理组件
• get_operating_system -获取操作系统信息

📋 报价和报价（13个工具）

• create_offer -创建新的报价/报价
• update_offer -更新报价
• get_offer_template -获取报价模板

🔐 认证

• login -登录并获取API令牌

完整工具清单

工具总数： 237

工具类别

______________________________________________________________________

API 文档

此MCP服务器实现 Tans API第10.10.0版.

TANSS API官方文件： 🔗 https://api-doc.tanss.de/#section/Documentation-是-TANSS-API的一部分。-版本：-10.10.0

API文档提供：

• 详细的端点规范
• 请求/响应模式
• 身份验证要求
• 参数说明
• 请求和响应示例

______________________________________________________________________

建筑

身份验证流程

┌─────────────────────────────────────────────────────────────────┐
│                        MCP Client                               │
│                    (Claude, etc.)                               │
└────────────────────────────┬────────────────────────────────────┘
                             │
                             │ MCP Protocol
                             │
┌────────────────────────────▼────────────────────────────────────┐
│                    TANSS MCP Server                             │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │  Tool Catalog (237 tools)                                │  │
│  │  - create_ticket                                         │  │
│  │  - get_my_tickets                                        │  │
│  │  - create_remote_support                                 │  │
│  │  - ...                                                   │  │
│  └──────────────────────────────────────────────────────────┘  │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │  Token Manager                                           │  │
│  │  - Main API Token                                        │  │
│  │  - Role-specific Tokens (ERP, Phone, etc.)              │  │
│  │  - Automatic Bearer prefix handling                      │  │
│  └──────────────────────────────────────────────────────────┘  │
└────────────────────────────┬────────────────────────────────────┘
                             │
                             │ HTTP + Custom apiToken header
                             │
┌────────────────────────────▼────────────────────────────────────┐
│                        TANSS API                                │
│                     (v10.10.0)                                  │
└─────────────────────────────────────────────────────────────────┘

令牌优先级

在进行API调用时，服务器使用以下令牌优先级：

1. 角色特定令牌 （如果为该端点类别配置）
2. 主要API令牌 （回退）

例子：

• ERP端点使用 erp_api_token 如果已配置，否则 api_token
• 票证端点始终使用 api_token

自定义身份验证标头

TANSS使用 自定义身份验证标头 而不是标准 Authorization 头球

headers = {
    'apiToken': 'Bearer ',  # TANSS-specific
    'Content-Type': 'application/json'
}

服务器会自动处理此问题。

______________________________________________________________________

命令行选项

python3 server.py --help

选项

示例

# stdio mode (default for Claude Desktop)
python3 server.py --mode stdio

# SSE mode for local development
python3 server.py --mode sse

# SSE mode for network access
python3 server.py --mode sse --host 0.0.0.0 --port 3001

# Development mode with auto-reload
python3 server.py --mode sse --reload --log-level debug

______________________________________________________________________

安全说明

⚠️ 重要安全注意事项：

• 在生产中为令牌使用环境变量
• 定期轮换API令牌
• 监控令牌到期日期
• 在生产中为SSE模式正确配置CORS
• 使用HTTPS进行生产部署

______________________________________________________________________

贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

______________________________________________________________________

支持

作者 塞巴斯蒂安·米歇尔\ 公司： ProNet系统有限公司\ 网站： https://www.pronet-systems.de

• 咨询官方 TANSS API文件

______________________________________________________________________

由以下材料制成❤️ ProNet系统有限公司