concierge-mcp

Concierge（Discordネイティブのカスタマーサポートプラットフォーム）向けのローカルMCPサーバーです。

お使いのAIエージェント（Claude Desktop、Cursor、Cline、またはその他のMCP互換クライアント）をConciergeサポートサーバーに接続し、サポートスタック全体を自然言語で操作できます。チケットのライフサイクル、AI設定、ナレッジベース、パネル、自動化、分析、請求、Discord通信など、200以上のツールを網羅しています。

できること

「SaaS用にConciergeをセットアップして。#supportにパネルをデプロイし、@Modと@Adminにエージェント権限を付与して。優先度の高いチケットのSLAを30分に設定して。」

「過去30日間のCSATレポートを表示して。その後、チケット #142 への返信を提案して。」

「エージェントの応答がない7日以上前のチケットをすべて一括でクローズし、顧客にDMでトランスクリプトを送って。」

「チケット #88 を明日の午前9時（ET）までスヌーズし、その顧客をVIPとしてフラグ付けして。」

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) に以下を追加します：

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Claude Desktopを再起動します。MCPサーバーリストに「concierge」が表示され、200以上の全ツールが利用可能になります。

Cursor

~/.cursor/mcp.json に以下を追加します：

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Cline / その他のMCPクライアント

同じ command/args/env 形式を使用してください。すべてのMCPクライアントはstdioサーバーをサポートしています。

認証情報の取得

1. conciergetickets.net/dashboard でConciergeダッシュボードを開きます

2. いずれかのパネルを開き → Advanced → MCP Settings を選択します

3. MCP Enabled をONに切り替えます — これによりAPIキーが生成されます

4. APIキーをコピーします（CONCIERGE_MCP_KEY として設定してください）

5. ギルドIDはDiscordサーバーIDです。URLから確認するか、右クリック → サーバーIDをコピー（開発者モードが必要）で取得できます

仕組み

このパッケージは軽量なstdioプロキシです。MCPクライアントが起動すると、以下の処理が行われます：

1. https://api.conciergetickets.net/api/v1/guilds/{GUILD_ID}/mcp にあるConcierge MCPサーバーに接続します

2. APIキーで認証します

3. ライブツールカタログを取得します（Conciergeが新しいツールをリリースしても、再インストールなしで自動的に表示されます）

4. すべてのツール呼び出しをリモートサーバーに転送します

ローカルバイナリは小さく、ステートレスです。ギルドのデータはConciergeのインフラストラクチャ上に保持されます。

ツールカテゴリ

• チケット — 完全なライフサイクル（クレーム、スヌーズ、再オープン、完了、転送、ロック、マージ、分割など）および一括操作

• AI — チケットの要約、感情分析、返信の提案、回答の再生成、翻訳

• ナレッジベース — 完全なCRUD + 検索 + GitBookインポート

• 顧客 — プロフィール、メモ、VIP切り替え、期限付きブラックリスト

• パネル — 完全な埋め込みカスタマイズによる作成/デプロイ/再デプロイ

• 設定 — update_panel_config / update_guild_config を介したTicketPanelおよびGuildのすべての設定

• Discord — メッセージ送信、DM、リアクション、アナウンス投稿、チャンネル/ロール/メンバーの検索

• Webhook — 完全なCRUD + テスト、再配信、統計

• 分析 — 概要、ピーク時間、エージェントリーダーボード、CSVエクスポート

• CRM — テスト、同期、Salesforce/HubSpot/Zendesk/Freshdeskからのプル

• Cronトリガー — SLAスキャン、自動クローズ、エスカレーションチェックのオンデマンド実行

• チーム — 招待、削除、ワークロード/スケジュール/ステータス/スキルの設定

npx -y concierge-mcp を実行し、tools/list を呼び出すと、完全なライブカタログを確認できます。

ディスカバリーエンドポイント（非MCP統合用）

• GET https://api.conciergetickets.net/api/v1/public/openapi.json — REST API用の完全なOpenAPI 3.1仕様

• GET https://api.conciergetickets.net/api/v1/public/schema.json — 解析済みPrismaスキーマ（すべてのモデル、フィールド、列挙型）

リンク

• Concierge: https://conciergetickets.net

• ドキュメント: https://conciergetickets.net/docs

• Model Context Protocol: https://modelcontextprotocol.io

ライセンス

MIT