zendesk-help-center-mcp-server

zendesk-help-center-mcp-server

3.3

If you are the rightful owner of zendesk-help-center-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcpreview.com.

A Model Context Protocol (MCP) server that interfaces with the Zendesk Help Center API, allowing integration with Claude Desktop and other MCP-compatible clients.

Zendesk Help Center MCP Server

A Model Context Protocol (MCP) server that interfaces with the Zendesk Help Center API, allowing 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 specific articles by ID

Prerequisites

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

Installation

  1. Clone this 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 with 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
    

Building and Running

  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.

Available Tools

The server provides the following tools:

1. searchArticles

Search for articles in your Zendesk Help Center.

Parameters:

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

2. getArticle

Get details of a specific Zendesk Help Center article by ID.

Parameters:

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

Using with Claude Desktop

Adding to Claude's mcpServers Configuration

Add the following configuration to the mcpServers section in Claude's 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 within Claude.

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

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.