Znuny

Znuny

Znuny (the maintained OTRS fork, and the same API as OTOBO): search and read tickets with their articles, open tickets and add articles, over the GenericInterface REST web service on your own instance.

7-day free trial · No credit card · EU-hosted

Ask Znuny anything

Try a real prompt against Znuny via AnythingMCP — Claude calls the tools, returns the answer. Press Enter on your own message to install on Cloud.

Install Znuny on Cloud
Znuny · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

Setup in 2 minutes

  1. 1Start a free trial on cloud.anythingmcp.com.
  2. 2Click Znuny in the connector store. Paste credentials when prompted.
  3. 3Mint an MCP API key and point your AI client at the generated MCP URL.
Install Znuny now

Guides for Znuny

Step-by-step setup for the most popular AI clients.

Setting up Znuny

From the connector definition itself: where to find the credentials, what they need to be allowed to do, and which API this adapter talks to.

A Znuny web service has to be created before any of this works. Znuny does not expose a REST API by default; you build one in the admin UI.

  1. Go to Admin → Web Services → Add web service and import Znuny's sample GenericTicketConnectorREST.yml (in the Znuny source it is development/webservices/GenericTicketConnectorREST.yml). That file defines exactly the four operations this adapter calls, and the routes below are its routes: GET /Ticket is TicketSearch, POST /Ticket is TicketCreate, GET /Ticket/:TicketID is TicketGet and PATCH /Ticket/:TicketID is TicketUpdate. If you wrote your own web service with different routes, change them here to match.
  2. Note the web service name you gave it — it is part of every URL. Set it in ZNUNY_WEBSERVICE; the bundled file's default is GenericTicketConnectorREST.
  3. Create a Znuny agent for the integration with the queue permissions the agent should have, and put its login in ZNUNY_USERNAME and password in ZNUNY_PASSWORD. Set ZNUNY_URL to your instance root, no trailing slash.

Credentials travel in the request itself, not in a header. The GenericInterface expects UserLogin and Password as parameters on every call — that is Znuny's design, not an oversight here. AnythingMCP appends them automatically so they never reach a prompt or a tool parameter. They do end up in the query string, and therefore in the web server's access log: give this agent its own Znuny account and rotate its password like any other.

Znuny 7 path. The connector calls ZNUNY_URL + /znuny/nph-genericinterface.pl/Webservice/<name>, the script alias of Znuny 7.x. Znuny 6.5 and older serve the same GenericInterface under /otrs/ (/otrs/nph-genericinterface.pl/...), and OTOBO under /otobo/; there the URL above answers 404. On those versions, after installing, change the connector's base URL to https://<host>/otrs/nph-genericinterface.pl/Webservice/<name> (or /otobo/...), or add a ScriptAlias /znuny/ to the web server pointing at the same cgi-bin directory. ZNUNY_SCRIPT_PATH is not read by this connector.

Creating a ticket needs State and Priority. TicketCreate has no defaults for them and rejects the call without them ("Ticket->StateID or Ticket->State parameter is required!"). When ticket types are enabled (SysConfig Ticket::Type), Type is required too.

Search returns ids only. znuny_search_tickets gives you TicketIDs; znuny_get_ticket turns one into a full record. Articles are omitted unless you ask for them, because a long thread is large.

Checked against the source, not a live system. The routes match Znuny's sample GenericTicketConnectorREST.yml and the required fields match Znuny's TicketCreate/TicketUpdate operations, but this adapter has not been run against a live instance. A web service with different routes than the sample needs the tool paths changed to match. A correction from anyone running this against a real system is genuinely welcome.

Self-hosted, which is the thing to plan for.

  • On AnythingMCP Cloud the instance must be reachable from the public internet on a real hostname with a valid TLS certificate. A self-signed certificate will fail: the connector offers no trust-anything switch.
  • On an internal host (znuny.intern, 10.0.0.x), self-host AnythingMCP on the same network and add that host to SSRF_ALLOWED_HOSTS, or the outbound guard refuses the call before it is made.

Your AI is two clicks away from Znuny.

Install the connector, paste your credentials, ask your AI a question. 7-day free trial, no credit card.