Zendesk Help Center MCP Server

Zendesk ヘルプセンター MCP サーバー

Zendesk ヘルプセンター API と連携する Model Context Protocol（MCP）サーバーです。Claude Desktop やその他の MCP 対応クライアントと統合できます。

機能

• 記事検索：Zendesk ヘルプセンターの記事を検索します
• 記事の詳細：ID を指定して、特定の記事の詳細情報を取得します

前提条件

• Node.js（v18 以上）
• API アクセス権を持つ Zendesk アカウント
• Zendesk API トークン

インストール

1. このリポジトリをクローンします：

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

2. 依存関係をインストールします：

   npm install
   

3. ルートディレクトリに Zendesk の認証情報を記載した .env ファイルを作成します：

   ZENDESK_SUBDOMAIN=your-subdomain
   [email protected]
   ZENDESK_API_TOKEN=your-api-token
   

   .env.example ファイルをコピーし、詳細を記入できます：

   cp .env.example .env
   

ビルドと実行

1. プロジェクトをビルドします：

   npm run build
   

2. サーバーを起動します：

   npm start
   

サーバーは標準入出力で動作するため、Claude Desktop やその他の MCP クライアントと互換性があります。

利用可能なツール

サーバーでは、以下のツールを利用できます。

1. searchArticles

Zendesk ヘルプセンターの記事を検索します。

パラメーター：

• query（文字列、必須）：検索キーワード
• locale（文字列、任意）：ロケールコード（例：'en'、'ja'、'en-us'）
• page（数値、任意）：ページ番号
• per_page（数値、任意）：1 ページあたりの検索結果数（最大 100）

2. getArticle

ID を指定して、特定の Zendesk ヘルプセンター記事の詳細を取得します。

パラメーター：

• id（数値、必須）：記事 ID
• locale（文字列、任意）：ロケールコード（例：'en'、'ja'、'en-us'）

Claude Desktop での使用

Claude の mcpServers 設定への追加

Claude の設定ファイルにある mcpServers セクションに、以下の設定を追加します。

{
  "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"
      }
    }
  }
}

この設定を追加すると、Claude 内で Zendesk ヘルプセンターのツールを使用できます。

開発

このプロジェクトは TypeScript を使用し、Model Context Protocol の仕様に準拠しています。

自動リロードを有効にして開発モードで実行するには：

npm run dev

ライセンス

MIT

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。