使用说明
乔尔杰
连接的远程MCP服务器 高尔吉亚 帮助台 Claude.ai 通过 模型上下文协议.
在Claude.ai中粘贴Gorgias门票URL或ID，并直接讨论。
工具
| 工具 | 说明 |
|---|---|
get_ticket |
通过ID或Gorgias URL获取门票 |
list_ticket_messages |
获取完整的对话线索 |
get_customer |
按ID列出的客户详细信息 |
search_tickets |
按状态、客户、受让人筛选票证 |
create_ticket |
创建新票证 |
create_ticket_message |
在票证上发布消息或内部注释 |
update_ticket |
更新票证元数据（主题、优先级等） |
assign_ticket |
将票分配给用户或团队 |
close_ticket |
使用可选的内部注释关闭工单 |
reply_to_ticket |
向客户发送电子邮件回复 |
设置
需要Node.js 22+和 Gorgias API密钥.
cp .env.example .env
# Edit .env with your Gorgias credentials
npm install
npm run dev
在本地进行测试 MCP检查员:
npx @modelcontextprotocol/inspector
# Connect using Streamable HTTP → http://localhost:3000/
部署
使用Docker构建和运行：
docker compose up -d
服务器需要一个反向代理（Traefik、Caddy、nginx）来终止HTTPS。Claude.ai需要HTTPS才能连接。
部署后，在Claude.ai中添加您的服务器URL： 设置→ 集成→ 添加更多.
环境变量
| 变量 | 描述 |
|---|---|
PORT |
服务器端口（默认值：3000） |
GORGIAS_DOMAIN |
您的Gorgias子域名（例如。 myshop 对于myshop.gorgias.com） |
GORGIAS_EMAIL |
Gorgias帐户电子邮件 |
GORGIAS_API_KEY |
Gorgias REST API密钥 |
GORGIAS_EMAIL_INTEGRATION_ID |
电子邮件集成ID（用于路由） |
GORGIAS_USER_ID |
Gorgias用户ID（用于代理发件人） |
MCP_MASTER_KEY |
管理面板的主密钥 |
许可证
麻省理工学院