客户操作系统MCP服务器
本地人 模型上下文协议 用于管理CustomerOS（票证、帐户、团队成员和笔记）的服务器，由Supabase支持。
专为配合使用而设计 克劳德代码 但适用于任何MCP客户端。
工具
| 工具 | 说明 |
|---|---|
list_accounts | 列出所有具有状态的帐户 |
get_account | 按名称查找帐户（模糊搜索） |
list_team | 列出具有角色的团队成员 |
list_tickets | 列出门票，可选择按状态过滤 |
get_my_tickets | 列出您的未结门票 |
get_ticket | 通过ID获取完整的门票详细信息 |
list_notes | 列出帐户的客户备注 |
list_templates | 列出默认工单模板 |
create_ticket | 使用模板、帐户、受让人创建新票证 |
update_ticket | 更新票证状态、受让人、截止日期、描述 |
设置
1.安装
git clone https://github.com/throxy-labs/customeros-mcp.git
cd customeros-mcp
bun install # or npm install
bun run build # or npm run build2.环境变量
联系bergen@throxy.com用于访问凭据。
将这些设置在壳中或 .env:
CUSTOMEROS_SUPABASE_URL=
CUSTOMEROS_SUPABASE_ANON_KEY=
CUSTOMEROS_BERGEN_EMPLOYEE_ID= # optional, for get_my_tickets3.配置MCP客户端
克劳德代码 --添加到您的 .mcp.json 或克劳德代码设置：
{
"mcpServers": {
"customeros": {
"command": "node",
"args": ["/path/to/customeros-mcp/dist/index.js"],
"env": {
"CUSTOMEROS_SUPABASE_URL": "https://your-project.supabase.co",
"CUSTOMEROS_SUPABASE_ANON_KEY": "your-anon-key",
"CUSTOMEROS_BERGEN_EMPLOYEE_ID": "your-employee-uuid"
}
}
}
}使用示例
连接后，您的MCP客户端可以调用以下工具：
list_tickets(status: "todo")
create_ticket(template: "email", account: "Acme", title: "March Campaign", assignee: "bergen")
update_ticket(ticket: "TK-320", status: "backlog")
get_ticket(id: "TK-492")票证描述支持markdown（##标头、-lists、， 大胆)并自动转换为用于CustomerOS UI的HTML。
Supabase架构
在您的Supabase项目中需要这些表：
accounts--id、名称、状态team_members--id、姓名、角色、团队tickets--id、标识符、标题、描述、状态、模板、account_id、account_name、employee_id、employee_name、截止日期、custom_fields、created_atclient_notes--id、内容、author_name、account_id、created_atticket_templates--slug、标签、描述、default_employee_name、default_deadline_days、字段、排序顺序
许可证
麻省理工学院