Gorgias MCP Server

🚀 堡獅網 MCP 服務器

堡獅網 MCP 服務器用於與堡獅網幫助臺 API 進行交互，為用戶提供了管理票務、客戶等堡獅網功能的工具和資源。

🚀 快速開始

安裝指南

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 獲取特定票務。

認證方法

該服務器支持兩種認證方式：

1. API Key 認證（用戶名/API 密鑰）
2. OAuth 令牌認證

請在 .env 文件中配置您偏好的認證方法。