Zendesk Help Center Anon Server

• zendesk_list_categories
  • 説明:
    • Zendesk Help Centerのカテゴリ一覧を取得します。
  • パラメータ:
    • locale (オプション): 言語（例: ja, en-us、デフォルトは環境変数 ZENDESK_DEFAULT_LOCALE）
    • sort_by (オプション): ソート基準（position, created_at, updated_at のいずれか）
    • sort_order (オプション): ソート順（asc, desc のいずれか）
  • 戻り値:
    • テキスト形式のカテゴリ一覧（ID, 名前, 説明, URL）
• zendesk_list_sections_in_category
  • 説明:
    • Zendesk Help CenterのカテゴリID配下のセクション一覧を取得します。
  • パラメータ:
    • category_id (必須): カテゴリID (文字列または数値)
    • locale (オプション): 言語（例: ja, en-us、デフォルトは環境変数 ZENDESK_DEFAULT_LOCALE）
    • sort_by (オプション): ソート基準（position, created_at, updated_at のいずれか）
    • sort_order (オプション): ソート順（asc, desc のいずれか）
    • per_page (オプション): 1ページあたりの件数（最大100）
    • page (オプション): ページ番号
  • 戻り値:
    • テキスト形式のセクション一覧（ID, 名前, 説明, URL）とページネーション情報
• zendesk_get_articles_in_category
  • 説明:
    • Zendesk Help CenterのカテゴリID配下の記事一覧を取得します。
  • パラメータ:
    • category_id (必須): カテゴリID (文字列または数値)
    • locale (オプション): 言語（例: ja, en-us、デフォルトは環境変数 ZENDESK_DEFAULT_LOCALE）
    • sort_by (オプション): ソート基準（position, created_at, updated_at のいずれか）
    • sort_order (オプション): ソート順（asc, desc のいずれか）
    • per_page (オプション): 1ページあたりの件数（最大100）
    • page (オプション): ページ番号
  • 戻り値:
    • テキスト形式の記事一覧（ID, タイトル, URL, 抜粋）とページネーション情報
• zendesk_get_articles_in_section
  • 説明:
    • Zendesk Help CenterのセクションID配下の記事一覧を取得します。
  • パラメータ:
    • section_id (必須): セクションID (文字列または数値)
    • locale (オプション): 言語（例: ja, en-us、デフォルトは環境変数 ZENDESK_DEFAULT_LOCALE）
    • sort_by (オプション): ソート基準（position, created_at, updated_at のいずれか）
    • sort_order (オプション): ソート順（asc, desc のいずれか）
    • per_page (オプション): 1ページあたりの件数（最大100）
    • page (オプション): ページ番号
  • 戻り値:
    • テキスト形式の記事一覧（ID, タイトル, URL, 抜粋）とページネーション情報
• zendesk_search_articles
  • 説明:
    • ZenDesk Help Centerの記事をキーワードで検索します。
  • パラメータ:
    • query (必須): 検索キーワード (文字列)
    • locale (オプション): 言語（例: ja, en-us、デフォルトは環境変数 ZENDESK_DEFAULT_LOCALE）
    • per_page (オプション): 1ページあたりの件数（最大100）
    • page (オプション): ページ番号
  • 戻り値:
    • テキスト形式の検索結果（ID, タイトル, URL, 抜粋）とページネーション情報
• zendesk_get_article
  • 説明:
    • ZenDesk Help Centerの記事IDから記事詳細を取得します。
  • パラメータ:
    • id (必須): 記事ID (文字列または数値)
    • locale (オプション): 言語（例: ja, en-us、デフォルトは環境変数 ZENDESK_DEFAULT_LOCALE）
  • 戻り値:
    • テキスト形式の記事詳細情報（タイトル, URL, 本文）

• LANG:

  • 各ツールで locale パラメータを省略した場合のデフォルト言語や、国際化ライブラリ (i18n) で利用するデフォルト言語を設定します。サーバーの実行環境に応じて ja や en などが自動的に設定されることを想定しています。

• MCP_SERVER_NAME

  • MCPサーバーの名前を上書きします。
  • 指定しない場合は、public/locales/ 配下の言語ファイルから読み込まれます。

• MCP_SERVER_DESCRIPTION

  • MCPサーバーの説明を上書きします。
  • 指定しない場合は、public/locales/ 配下の言語ファイルから読み込まれます。

• MCP_TOOL_NAME_<TOOL_ID_IN_UPPERCASE>

  • ツールの表示名を個別に上書きします。
  • <TOOL_ID_IN_UPPERCASE> の部分には、ツールのデフォルト名 (例: zendesk_list_categories) をすべて大文字に置換したものを指定します。
  • 例:
    • zendesk_list_categories ツールの名前を変更する場合: MCP_TOOL_NAME_ZENDESK_LIST_CATEGORIES
    • zendesk_search_articles ツールの名前を変更する場合: MCP_TOOL_NAME_ZENDESK_SEARCH_ARTICLES
  • 指定しない場合は、public/locales/ 配下の言語ファイルから読み込まれます。

• MCP_TOOL_DESCRIPTION_<TOOL_ID_IN_UPPERCASE>

  • ツールの説明を個別に上書きします。
  • <TOOL_ID_IN_UPPERCASE> の部分は、上記と同様にツールのデフォルト名を大文字にしたものです。
  • 例:
    • zendesk_list_categories ツールの説明を変更する場合: MCP_TOOL_DESCRIPTION_ZENDESK_LIST_CATEGORIES
  • 指定しない場合は、public/locales/ 配下の言語ファイルから読み込まれます。

{
  "mcp": {
    "servers": {
      "zendesk-help-center-mcp-server": {
        "type": "stdio",
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "dosugamea/zendesk-help-center-mcp-server:1.0.0"
        ]
      }
    }
  }
}

Zendesk Help Center を1つしか使わない場合

1つしか使わない場合は 最低限 ZENDESK_SITE_DOMAIN と LANG を設定してください。

{
  "mcpServers": {
    "makeshop-help-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ZENDESK_SITE_DOMAIN",
        "-e",
        "LANG",
        "-e",
        "MCP_SERVER_NAME",
        "-e",
        "MCP_SERVER_DESCRIPTION",
        "dosugamea/zendesk-help-center-anon-mcp:1.0.0"
      ],
      "env": {
        "MCP_SERVER_NAME": "makeshop-help-mcp",
        "MCP_SERVER_DESCRIPTION": "makeshopのヘルプ記事を取得するためのツールを提供します。カテゴリ、セクション、記事の一覧取得、記事の検索、記事詳細の取得ができます。",
        "ZENDESK_SITE_DOMAIN": "manual.makeshop.jp",
        "LANG": "ja"
      }
    }
  }
}

Zendesk Help Center を2つ以上使う場合

2つ以上使う場合、そのままだと同名のツールが登録されてしまいLLMの混乱を招きます。 下記のように各ツールの名前と説明を設定してください。

{
  "mcpServers": {
    "kyash-help": {
      "command": "docker",
      "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "ZENDESK_SITE_DOMAIN",
          "-e",
          "LANG",
          "-e",
          "MCP_SERVER_NAME",
          "-e",
          "MCP_SERVER_DESCRIPTION",
          "-e",
          "MCP_TOOL_NAME_ZENDESK_LIST_CATEGORIES",
          "-e",
          "MCP_TOOL_DESCRIPTION_ZENDESK_LIST_CATEGORIES",
          "-e",
          "MCP_TOOL_NAME_ZENDESK_LIST_SECTIONS_IN_CATEGORY",
          "-e",
          "MCP_TOOL_DESCRIPTION_ZENDESK_LIST_SECTIONS_IN_CATEGORY",
          "-e",
          "MCP_TOOL_NAME_ZENDESK_GET_ARTICLES_IN_CATEGORY",
          "-e",
          "MCP_TOOL_DESCRIPTION_ZENDESK_GET_ARTICLES_IN_CATEGORY",
          "-e",
          "MCP_TOOL_NAME_ZENDESK_GET_ARTICLES_IN_SECTION",
          "-e",
          "MCP_TOOL_DESCRIPTION_ZENDESK_GET_ARTICLES_IN_SECTION",
          "-e",
          "MCP_TOOL_NAME_ZENDESK_GET_ARTICLE",
          "-e",
          "MCP_TOOL_DESCRIPTION_ZENDESK_GET_ARTICLE",
          "-e",
          "MCP_TOOL_NAME_ZENDESK_SEARCH_ARTICLES",
          "-e",
          "MCP_TOOL_DESCRIPTION_ZENDESK_SEARCH_ARTICLES",
          "dosugamea/zendesk-help-center-mcp-server:1.0.0"
      ],
      "env": {
          "MCP_SERVER_NAME": "kyash-help-mcp",
          "MCP_SERVER_DESCRIPTION": "Kyashのヘルプ記事を取得するツールを提供します。カテゴリ、セクション、記事の一覧取得、記事の検索、記事詳細を取得可能。",
          "MCP_TOOL_NAME_ZENDESK_LIST_CATEGORIES": "kyash_list_categories",
          "MCP_TOOL_DESCRIPTION_ZENDESK_LIST_CATEGORIES": "Kyashのカテゴリ一覧を取得します。",
          "MCP_TOOL_NAME_ZENDESK_LIST_SECTIONS_IN_CATEGORY": "kyash_list_sections_in_category",
          "MCP_TOOL_DESCRIPTION_ZENDESK_LIST_SECTIONS_IN_CATEGORY": "Kyashのカテゴリ内のセクション一覧を取得します。",
          "MCP_TOOL_NAME_ZENDESK_GET_ARTICLES_IN_CATEGORY": "kyash_get_articles_in_category",
          "MCP_TOOL_DESCRIPTION_ZENDESK_GET_ARTICLES_IN_CATEGORY": "Kyashの記事一覧を取得します。",
          "MCP_TOOL_NAME_ZENDESK_GET_ARTICLES_IN_SECTION": "kyash_get_articles_in_section",
          "MCP_TOOL_DESCRIPTION_ZENDESK_GET_ARTICLES_IN_SECTION": "Kyashの記事一覧を取得します。",
          "MCP_TOOL_NAME_ZENDESK_GET_ARTICLE": "kyash_get_article",
          "MCP_TOOL_DESCRIPTION_ZENDESK_GET_ARTICLE": "Kyashの記事詳細を取得します。",
          "MCP_TOOL_NAME_ZENDESK_SEARCH_ARTICLES": "kyash_search_articles",
          "MCP_TOOL_DESCRIPTION_ZENDESK_SEARCH_ARTICLES": "Kyashの記事を検索します。",
          "ZENDESK_SITE_DOMAIN": "support.kyash.co",
          "LANG": "ja"
      }
    }
  }
}