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 CloudClaude is AI and can make mistakes. Please double-check responses.
Setup in 2 minutes
- 1Start a free trial on cloud.anythingmcp.com.
- 2Click Znuny in the connector store. Paste credentials when prompted.
- 3Mint an MCP API key and point your AI client at the generated MCP URL.
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.
- Go to Admin → Web Services → Add web service and import Znuny's sample
GenericTicketConnectorREST.yml(in the Znuny source it isdevelopment/webservices/GenericTicketConnectorREST.yml). That file defines exactly the four operations this adapter calls, and the routes below are its routes:GET /Ticketis TicketSearch,POST /Ticketis TicketCreate,GET /Ticket/:TicketIDis TicketGet andPATCH /Ticket/:TicketIDis TicketUpdate. If you wrote your own web service with different routes, change them here to match. - Note the web service name you gave it — it is part of every URL. Set it in
ZNUNY_WEBSERVICE; the bundled file's default isGenericTicketConnectorREST. - Create a Znuny agent for the integration with the queue permissions the agent should have, and put its login in
ZNUNY_USERNAMEand password inZNUNY_PASSWORD. SetZNUNY_URLto 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 toSSRF_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.