Zendesk Help Center MCP Server

🚀 Zendesk Help Center MCP Server

A Model Context Protocol (MCP) server interfacing with the Zendesk Help Center API, enabling integration with Claude Desktop and other compatible MCP clients.

🚀 Quick Start

This is an MCP server that connects with the Zendesk Help Center API, allowing seamless integration with Claude Desktop and other MCP - compatible clients.

✨ Features

• Article Search: Search for articles in your Zendesk Help Center.
• Article Details: Retrieve detailed information about a specific article by its ID.

📦 Installation

Prerequisites

• Node.js (v18 or higher)
• A Zendesk account with API access
• A Zendesk API token

Steps

1. Clone the repository:

   git clone https://github.com/yourusername/zendesk-help-center-mcp-server.git
   cd zendesk-help-center-mcp-server
   

2. Install dependencies:

   npm install
   

3. Create a .env file in the root directory and fill in your Zendesk credentials:

   ZENDESK_SUBDOMAIN=your-subdomain
   ZENDESK_EMAIL=your-email@example.com
   ZENDESK_API_TOKEN=your-api-token
   

   You can copy the .env.example file and fill in your details:

   cp .env.example .env
   

🔧 Build and Run

1. Build the project:

   npm run build
   

2. Start the server:

   npm start
   

The server will run on standard input/output, making it compatible with Claude Desktop and other MCP clients.

💻 Usage Examples

Available Tools

The server provides the following tools:

1. searchArticles

Search for articles in your Zendesk Help Center.

Parameters:

• query (string, required): Search keywords
• locale (string, optional): Language code (e.g., 'en', 'ja', 'en-us')
• page (number, optional): Page number
• per_page (number, optional): Number of results per page (maximum 100)

2. getArticle

Retrieve detailed information about a specific Zendesk Help Center article by its ID.

Parameters:

• id (number, required): Article ID
• locale (string, optional): Language code (e.g., 'en', 'ja', 'en-us')

Using with Claude Desktop

Add to Claude's mcpServers Configuration

Add the following configuration to the mcpServers section of the Claude settings file:

{
  "mcpServers": {
    "zendeskHelpCenter": {
      "command": "npx",
      "args": ["-y", "github:hidechae/zendesk-help-center-mcp-server"],
      "env": {
        "ZENDESK_SUBDOMAIN": "your-subdomain",
        "ZENDESK_EMAIL": "your-email@example.com",
        "ZENDESK_API_TOKEN": "your-api-token"
      }
    }
  }
}

After adding this configuration, you can use the Zendesk Help Center tools in Claude.

📚 Documentation

Development

This project uses TypeScript and follows the Model Context Protocol specification.

To run in development mode with auto - reloading:

npm run dev

📄 License

MIT

💪 Contribution

Contributions are welcome! Feel free to submit a Pull Request.