Zendesk Help Center MCP Server

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

Zendesk ヘルプセンター API と接続する Model Context Protocol (MCP) サーバーです。Claude Desktop やその他の互換性のある MCP クライアントとの統合を可能にします。

🚀 クイックスタート

このサーバーは、Zendesk ヘルプセンターの記事を検索し、詳細を取得するための API を提供します。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. ルートディレクトリに .env ファイルを作成し、Zendesk の認証情報を記入します：

   ZENDESK_SUBDOMAIN=your-subdomain
   ZENDESK_EMAIL=your-email@example.com
   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 (数値, 任意)：ページあたりの結果数（最大 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": "your-email@example.com",
        "ZENDESK_API_TOKEN": "your-api-token"
      }
    }
  }
}

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

開発

このプロジェクトは TypeScript を使用し、Model Context Protocol の仕様に準拠しています。 開発モードで実行し、自動的に再読み込みするには：

npm run dev

📄 ライセンス

MIT

🔗 貢献

貢献を歓迎します！自由に Pull Request を送信してください。