mcpField
Z
Zendesk Help Center MCP Server

Zendesk Help Center MCP Server

Local
github.com/hidechaeData & Analytics6Updated 76w ago
Repository

About Zendesk Help Center MCP Server

Zendesk Help Center MCP Server connects MCP-compatible clients to the Zendesk Help Center API. It supports article search and retrieval of article details, with credentials supplied through environment variables.

Key features

  1. 01Search Help Center articles
  2. 02Retrieve article details by ID
  3. 03Specify locale and pagination

Use cases

  1. 01Find help articles by keyword
  2. 02Retrieve a specific article for reference

MCP support

Exposes article search and article retrieval tools to MCP clients. It runs over standard input/output and requires Zendesk API credentials.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
[email protected]
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": "[email protected]",
        "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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.