Gorgias MCP Server

🚀 堡狮网 MCP サーバー

このサーバーは、堡獅網のヘルプデスク API とやり取りするための MCP サーバーです。管理チケット、顧客、その他の堡獅網機能に関するツールやリソースを提供します。

🚀 クイックスタート

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

npm install

3. .env.example をもとに .env ファイルを作成し、堡獅網の認証情報を入力します。

GORGIAS_DOMAIN=your-domain.gorgias.com
GORGIAS_USERNAME=your-username
GORGIAS_API_KEY=your-api-key

または、OAuth アプリケーションの場合は以下のように入力します。

GORGIAS_DOMAIN=your-domain.gorgias.com
GORGIAS_ACCESS_TOKEN=your-oauth-access-token

💻 サーバーの起動

サーバーを起動するには、以下のコマンドを実行します。

npm run dev

💻 MCP Inspector でのテスト

MCP Inspector を使用してサーバーをテストするには、以下のコマンドを実行します。

npm run inspect

これにより、すべての利用可能なツールとリソースをテストできる Web インターフェイスが開きます。

✨ 主な機能

💻 使用例

基本的な使用法

利用可能なツールには、以下のようなものがあります。

チケット関連

• list_tickets：堡獅網のヘルプデスク内のチケットを一覧表示します。
• get_ticket：ID を指定して特定のチケットを取得します。
• create_ticket：堡獅網内に新しいチケットを作成します。
• add_message_to_ticket：既存のチケットにメッセージを追加します。

顧客関連

• list_customers：堡獅網内の顧客を一覧表示します。
• get_customer：ID を指定して特定の顧客を取得します。

利用可能なリソース

• gorgias://tickets：すべてのチケットを一覧表示します。
• gorgias://ticket/{id}：ID を指定して特定のチケットを取得します。

🔧 技術詳細

このサーバーは、2 種類の認証方法をサポートしています。

1. API キー認証（ユーザー名/API キー）
2. OAuth トークン認証

.env ファイルで好みの方法を設定してください。