Zendesk Mcp
@michaelrice
关于 Zendesk Mcp
Zendesk MCP server for Claude Code and other MCP clients
基本信息
配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"zendesk-mcp": {
"command": "uvx",
"args": [
"zendesk-mcp"
]
}
}
}工具
29Get a Zendesk ticket by ID. Returns ticket fields including status, priority, requester, assignee, tags, and description.
Search Zendesk tickets by keyword and/or status. keywords: free-text search (e.g. 'login failure LDAP'). status: new, open, pending, hold, solved, closed — leave empty for all statuses. Returns id, subject, status, requester, assignee, and dates.
Get all comments (public replies and internal notes) for a Zendesk ticket. Includes attachment metadata but does not download files.
List all attachments across all comments for a Zendesk ticket. Returns filename, content type, size, and download URL for each. Use zendesk_download_attachment to fetch file contents.
Download a Zendesk attachment and return its contents. ticket_id is required to organize the local cache. Obtain attachment_url and filename from zendesk_list_attachments. Archives are unpacked, PDFs are text-extracted, images are base64-encoded.
Format a Zendesk ticket and its comments as an issue draft. Returns Markdown with ticket metadata, full conversation, and an empty Steps to Reproduce section. Use this output as the description when creating an issue in your tracker.
Post a public reply on a Zendesk ticket. The reply is visible to the requester. Use for customer-facing responses.
Post an internal note on a Zendesk ticket. Internal notes are only visible to agents and are not sent to the requester.
Set the status of a Zendesk ticket. Valid statuses: new, open, pending, hold, solved, closed.
Assign a Zendesk ticket to an agent by their email address. Pass 'me' as assignee_email to assign the ticket to yourself (the authenticated user).
Update one or more fields on a Zendesk ticket. Pass only the fields you want to change. status: new/open/pending/hold/solved/closed. priority: low/normal/high/urgent. type: problem/incident/question/task. assignee_id, requester_id, group_id, custom_status_id are integer IDs. due_at is ISO8601. Returns JSON of the refreshed ticket.
Get time tracking data for a Zendesk ticket. Returns total time spent and time spent on the last update, in both seconds and human-readable format (e.g. '2h 15m').
Log time spent on a Zendesk ticket. Adds seconds to the running total and records it as the last-update time. Returns logged amount and new total in seconds and human-readable format.
Get linked GitLab issues, merge requests, and commits for a Zendesk ticket via the Git-Zen integration. Returns structured lists with state, labels, weight, and direct GitLab links.
Create a new Zendesk ticket. subject and description are required. priority: low/normal/high/urgent. type: problem/incident/question/task. requester_id/assignee_id are user IDs (integers). custom_fields is a list of {id, value} dicts. Returns JSON of the created ticket.
List Zendesk tickets with pagination. page: 1-based page number. per_page: max 100. sort_by: created_at, updated_at, priority, or status. sort_order: asc or desc. Returns tickets plus pagination metadata.
Add a tag to a Zendesk ticket. Idempotent: adding an existing tag returns the current tag list without modifying the ticket. Returns JSON with ticket_id and current tags.
Remove a tag from a Zendesk ticket. Idempotent: removing a tag that isn't present returns the current tag list without modifying the ticket. Returns JSON with ticket_id and current tags.
List all active Zendesk views. Returns JSON array of {id, title}.
Get a Zendesk view's definition including filter conditions and execution settings. Returns JSON with id, title, active, conditions, execution.
Get the tickets currently matching a Zendesk view. Returns JSON array of tickets with essential fields.
List all active Zendesk macros with their actions. Returns JSON array of {id, title, description, actions: [{field, value}]}.
Preview the effect a macro would have (without applying it). Returns the result payload from Zendesk's apply preview endpoint.
Apply a macro to a Zendesk ticket. Fetches the macro preview, applies field changes, and posts any comment included in the macro. Returns JSON with id, status, tags, applied_changes, comment_added.
Search Zendesk users by name or email. Returns JSON array of {id, name, email, role}.
List all active Zendesk groups (excluding deleted). Returns JSON array of {id, name}.
List the members of a Zendesk group. Returns JSON array of {id, name, email}.
Fetch a Zendesk organization including its custom fields and tags. Returns JSON with id, name, organization_fields, tags, created_at, updated_at.
List all custom ticket statuses defined in Zendesk. Returns JSON array of {id, agent_label, end_user_label, status_category, active, default}. Use the id when setting custom_status_id on a ticket.
概览
What is Zendesk Mcp?
Zendesk Mcp is an MCP server that provides read and write tools for Zendesk tickets, comments, attachments, users, groups, organizations, views, macros, and time tracking. It is designed for use with Claude Code and other MCP clients.
How to use Zendesk Mcp?
Install Python 3.10+, create a virtualenv, install the package from a clone of the repository, run OAuth setup with python -m zendesk_mcp setup, then register the server with Claude Code using an absolute path to the venv's Python. Optionally allow read tools in ~/.claude/settings.json.
Key features of Zendesk Mcp
- Search, list, and fetch tickets with pagination
- Create, update, and set status on tickets
- Post public replies and internal notes
- Assign tickets to agents
- Browse and apply views and macros
- Look up users, groups, organizations, and custom statuses
- Read and log time-tracking entries
- Format tickets as Markdown issue draft for handoff
Use cases of Zendesk Mcp
- Automate ticket triaging and responses via Claude Code
- Fetch ticket context to assist in customer support workflows
- Apply macros and views to streamline agent actions
- Handoff ticket details to GitLab, GitHub, or Jira issue trackers
FAQ from Zendesk Mcp
What authentication does Zendesk Mcp use?
It uses OAuth with a Zendesk OAuth client. The user runs an interactive setup that opens a browser for authorization and stores a token locally.
What are the runtime requirements?
Python 3.10 or newer. No additional runtime beyond the Python packages installed in a virtualenv.
Are there any optional integrations?
Yes, Git-Zen integration reads linked GitLab issues/MRs/commits. Also optional Help Center knowledge base exposed as an MCP resource.
Does Zendesk Mcp support write operations?
Yes, it includes tools for creating and updating tickets, posting comments, setting status, assigning tickets, and logging time. These require explicit per-call approval unless added to the allowed permissions list.
What MCP transports or prompts are available?
The server uses standard MCP transport for tools. It exposes two prompts: analyze-ticket and draft-ticket-response.
数据与分析 分类下的更多 MCP 服务器
Federal Reserve Economic Data MCP Server
stefanoamorelliOpen-source FRED MCP Server (Federal Reserve Economic Data)
MCP Server for Deep Research
reading-plus-ai
Salesforce MCP Server
tsmztechSalesforce MCP Server
PubMed Analysis MCP Server
DarkroasterA PubMed MCP server.
arxiv-latex MCP Server
takashiishidaMCP server that uses arxiv-to-prompt to fetch and process arXiv LaTeX sources for precise interpretation of mathematical expressions in scientific papers.
评论