Gorgias MCP Server

Gorgias MCP サーバー

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

## セットアップ

1. このリポジトリをクローンします
2. 依存関係をインストールします：
   ```
   npm install
   ```
3. Gorgias の認証情報を使って、`.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
```

使用可能なすべてのツールとリソースをテストできるウェブインターフェースが開きます。

## 使用可能なツール

### チケット
- `list_tickets`：Gorgias ヘルプデスクのチケット一覧を取得します
- `get_ticket`：ID を指定して特定のチケットを取得します
- `create_ticket`：Gorgias に新しいチケットを作成します
- `add_message_to_ticket`：既存のチケットにメッセージを追加します

### 顧客
- `list_customers`：Gorgias の顧客一覧を取得します
- `get_customer`：ID を指定して特定の顧客を取得します

## 使用可能なリソース

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

## 認証

このサーバーは、次の 2 つの認証方法に対応しています：
1. API キー認証（ユーザー名/API キー）
2. OAuth トークン認証

`.env` ファイルで使用する認証方法を設定してください。