TANSS

You run a TANSS MCP Server to bridge AI assistants with the TANSS ticketing and asset management system. It exposes a wide set of endpoints and tools, handles token authentication, and supports both local stdio and HTTP/SSE transport so AI tools can create and manage tickets, calls, chats, assets, and more through simple commands.

How to use

You connect an MCP client (such as Claude Desktop or other compatible tools) to the TANSS MCP Server to issue tool commands and receive structured results. Start with the local stdio mode for a quick setup, or use SSE for networked access. The server prioritizes role-specific tokens when configured, and falls back to the main API token when needed. The client communicates using the MCP protocol and can call a large catalog of tools (e.g., create_ticket, get_my_tickets, create_remote_support, get_monitoring_ticket, etc.). Ensure your config contains the correct TANSS base URL and your API token or role-specific tokens.

How to install

Follow these concrete steps to install and run the TANSS MCP Server.

Prerequisites: you need Python 3.8 or newer. You should have a TANSS account with API access and an API token.

# 1. Clone the TANSS MCP Server repository
git clone <repository-url>
cd tanss-mcp

# 2. Install dependencies
pip install -r requirements.txt

# 3. Prepare configuration
cp config.ini.example config.ini

# 4. Edit config.ini and add your TANSS credentials
# [tanss]
# base_url = https://your-tanss-instance.com/backend/
# api_token = your_api_token_here
#
# [credentials]
# username = your_username
# password = your_password

# 5. Start the server in stdio mode (Claude Desktop compatible)
python3 server.py --mode stdio

# 6. Or start the server in SSE mode for web clients
python3 server.py --mode sse --host 0.0.0.0 --port 3001

Configuration and security notes

Configuration and security are handled via a config file and per-token controls. You can enable role-specific tokens for enhanced permissions and automatic token handling.

[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

Starting from Claude Desktop or SSE client

Claude Desktop users can run the server via a local path specified in the MCP settings. The server should be launched with Python 3 and the script path to server.py, using the stdio transport. The example below shows the recommended approach for a local setup, with placeholders for absolute paths.

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

Command-line options and help

Use the help flag to see runtime options, including mode selection and port configuration.

python3 server.py --help

Notes and troubleshooting

• If you run into token expiration, rotate tokens and update config.ini accordingly.
• Use environment variables for tokens in production and enable HTTPS for security.
• In SSE mode, adjust CORS settings for production deployments as needed.

Available tools

create_ticket

Create a new ticket in TANSS and return its identifier and status.

get_ticket

Retrieve details for a specific ticket by its ID.

update_ticket

Update fields of an existing ticket.

delete_ticket

Remove a ticket from the system.

get_my_tickets

List tickets assigned to the current user.

get_all_tickets

List all tickets across the system.

get_company_tickets

List tickets for a specific company.

add_ticket_comment

Add a comment to a ticket.

get_ticket_history

Show the change history of a ticket.

upload_ticket_file

Attach a file to a ticket.

create_call

Log a new phone call.

get_my_calls

List calls assigned to you.

identify_caller

Identify a caller by phone number.

create_remote_support

Create a remote support session.

list_remote_supports

List all remote support sessions.

create_invoice

Create an invoice in ERP integration.

get_company_employees

Retrieve employees for a company.

create_pc

Create a new IT asset computer entry.

update_pc

Update an existing computer entry.

get_operating_system

Retrieve operating system information.

create_offer

Create a new offer or quote.

login

Authenticate and obtain API tokens.