Gorgias MCP Server

Gorgias MCP 服务

一个用于与 Gorgias 帮助台 API 交互的 MCP 服务。此服务提供用于管理工单、客户和其他 Gorgias 功能的工具和资源。

## 设置

1. 克隆此仓库
2. 安装依赖：
   ```
   npm install
   ```
3. 根据 `.env.example` 创建 `.env` 文件，并填入你的 Gorgias 凭据：
   ```
   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`：列出 Gorgias 帮助台中的工单
- `get_ticket`：按 ID 获取指定工单
- `create_ticket`：在 Gorgias 中创建工单
- `add_message_to_ticket`：向现有工单添加消息

### 客户
- `list_customers`：列出 Gorgias 中的客户
- `get_customer`：按 ID 获取指定客户

## 可用资源

- `gorgias://tickets`：列出所有工单
- `gorgias://ticket/{id}`：按 ID 获取指定工单

## 身份验证

此服务支持两种身份验证方式：
1. API 密钥身份验证（用户名/API 密钥）
2. OAuth 令牌身份验证

在 `.env` 文件中配置你偏好的方式。