koundinya/zd-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

16 stars 12 forks 品質 80 トレンド 25MIT

Repository Install

Zendesk MCP Server

概要

A Model Context Protocol (MCP) server that provides AI assistants like Claude with seamless integration to Zendesk Support. Enables natural language interactions with Zendesk tickets, allowing you to search, create, update, and manage support tickets through conversational AI. - 🎫 : Create, read, update, and search Zendesk tickets - 💬 : Add public comments and private internal notes - 🔍 : Search tickets using Zendesk's powerful query syntax - 🔗 : Retrieve and manage linked incident tickets - 🏷️ : Add and manage ticket tags and metadata - 🔒 : Uses Zendesk API tokens for secure access - 🚀 : Available via npm, npx, or manual setup Set these environment variables in your system or MCP client configuration: Add to your Claude Desktop configuration file: - : ~/Library/Application Support/Claude/claude_desktop_config.json - : %APPDATA%/Claude/claude_desktop_config.json Add to ~/.cursor/mcp.json or .cursor/mcp.

README

以下は原文 README の抜粋です。原文を見る。

Zendesk MCP Server

✨ Features

🎫 Complete Ticket Management: Create, read, update, and search Zendesk tickets
💬 Comments & Notes: Add public comments and private internal notes
🔍 Advanced Search: Search tickets using Zendesk’s powerful query syntax
🔗 Incident Management: Retrieve and manage linked incident tickets
🏷️ Tag Management: Add and manage ticket tags and metadata
🔒 Secure Authentication: Uses Zendesk API tokens for secure access
🚀 Easy Installation: Available via npm, npx, or manual setup

🚀 Quick Start

Option 1: NPM Installation (Recommended)

npm install -g zd-mcp-server

Option 2: Use with npx (No Installation)

npx zd-mcp-server

Option 3: Development Setup

git clone https://github.com/koundinya/zd-mcp-server.git
cd zd-mcp-server
npm install
npm run build

⚙️ Configuration

Environment Variables

Set these environment variables in your system or MCP client configuration:

export ZENDESK_EMAIL="[email protected]"
export ZENDESK_TOKEN="your-zendesk-api-token"
export ZENDESK_SUBDOMAIN="your-company"  # from https://your-company.zendesk.com

Claude Desktop Setup

Add to your Claude Desktop configuration file:

Location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "zendesk": {
      "command": "npx",
      "args": ["-y", "zd-mcp-server"],
      "env": {
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_TOKEN": "your-zendesk-api-token",
        "ZENDESK_SUBDOMAIN": "your-company"
      }
    }
  }
}

Alternative (if installed globally):

{
  "mcpServers": {
    "zendesk": {
      "command": "zd-mcp-server",
      "env": {
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_TOKEN": "your-zendesk-api-token",
        "ZENDESK_SUBDOMAIN": "your-company"
      }
    }
  }
}

Cursor IDE Setup

Add to ~/.cursor/mcp.json or .cursor/mcp.json in your project:

{
  "mcpServers": {
    "zendesk": {
      "command": "npx",
      "args": ["-y", "zd-mcp-server"],
      "env": {
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_TOKEN": "your-zendesk-api-token",
        "ZENDESK_SUBDOMAIN": "your-company"
      }
    }
  }
}

Other MCP Clients

GitHub で README 全文を見る

インストール

npx -y zd-mcp-server

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "zendesk": {
      "command": "npx",
      "args": ["-y", "zd-mcp-server"],
      "env": {
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_TOKEN": "your-zendesk-api-token",
        "ZENDESK_SUBDOMAIN": "your-company"
      }
    }
  }
}