How to Use the Zammad MCP in Windsurf

Q: Can Windsurf help manage user accounts in Zammad?

Yeah, absolutely. You can create new users using createuser or perform secure de-provisioning with dataprivacydeleteuser. The agent makes sure these actions follow proper security protocols.

Q: If I need to search for old tickets in Zammad, does Windsurf handle that?

It does. You can ask Cascade to list all tickets using listtickets or narrow the scope down by searching with searchtickets. It pulls the data and presents it right where you are working.

Q: Does the MCP Server allow listing all available Zammad groups?

Yep. You use the listgroups tool to pull a master list of every group in your instance, giving you a full view of how your helpdesk is structured.

Automate Zammad workflows using Windsurf's autonomous agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Zammad MCP to Windsurf

Create your Vinkius account to connect Zammad to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Zammad with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage full ticket lifecycles via the MCP Server

When you set a goal, Cascade handles the entire process. You can create new tickets with `create_ticket` and then track down details using `get_ticket`. If the issue changes, update the status directly with `update_ticket`. This means you don't have to manually jump between Zammad pages.

Automate user setup and permissions in Windsurf

Need a new helpdesk agent? Cascade can automate user provisioning. Use `create_user` for setup, or if the employee leaves, it handles cleanup with `data_privacy_delete_user`. You'll also manage roles by listing all available ones using `list_roles`.

Contextual article generation and tagging

Cascade figures out what needs to be said. For an existing ticket, you can generate a full summary with `summarize_ticket`. You also control metadata by adding tags using `add_tag` or removing them with `remove_tag`, keeping your Zammad records clean.

Setup guide

Set up Zammad MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Zammad MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Zammad payment history." If connected, Cascade will call the Zammad tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "zammad-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Zammad. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Zammad now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Zammad MCP in Windsurf

Windsurf’s Cascade agent monitors the state of a ticket. You just tell it to close it, and it executes `update_ticket` with the correct status. It handles all the required steps so you don't get stuck on manual transitions.

Yeah, absolutely. You can create new users using `create_user` or perform secure de-provisioning with `data_privacy_delete_user`. The agent makes sure these actions follow proper security protocols.

It does. You can ask Cascade to list all tickets using `list_tickets` or narrow the scope down by searching with `search_tickets`. It pulls the data and presents it right where you are working.

This server handles User data. Specifically, you can securely delete a user account using `data_privacy_delete_user`, which is the recommended process over simply deleting records.

Yep. You use the `list_groups` tool to pull a master list of every group in your instance, giving you a full view of how your helpdesk is structured.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python