Syncro MCP服务器
Syncro MSP的模型上下文协议（MCP）服务器，实现了高效工具导航的决策树架构。
一键部署
特性
- 决策树架构：工具按域组织并延迟加载
- 域名导航：在客户、票证、资产、联系人和发票之间导航
- 延迟加载：域处理程序和Syncro客户端按需加载
- Syncro API全面覆盖：访问Syncro MSP的关键功能
安装
WYRE MCP服务器通过OCI/GHCR映像和（如果可用）MCPB捆绑包进行分发。没有npm包-- npm install @wyre-technology/syncro-mcp 将返回404。选项1:WYRE MCP网关（推荐）
使用托管网关 mcp.wyre.ai -将Syncro API密钥粘贴到网关UI中，您就完成了。
{
"mcpServers": {
"syncro": {
"type": "http",
"url": "https://mcp.wyre.ai/v1/syncro/mcp",
"headers": {
"X-Syncro-Api-Key": "${SYNCRO_API_KEY}"
}
}
}
}选项2:Claude代码命令行界面（从GitHub运行）
claude mcp add syncro \
-e SYNCRO_API_KEY=your-api-key \
-e SYNCRO_SUBDOMAIN=your-subdomain \
-- npx -y github:wyre-technology/syncro-mcp选项3：Docker（GHCR）
docker run --rm \
-e SYNCRO_API_KEY=your-api-key \
-e SYNCRO_SUBDOMAIN=your-subdomain \
ghcr.io/wyre-technology/syncro-mcp:latest选项4：来源
git clone https://github.com/wyre-technology/syncro-mcp.git
cd syncro-mcp
npm ci
npm run build
node dist/index.js配置
设置以下环境变量：
| 变量 | 必填 | 描述 |
|---|---|---|
SYNCRO_API_KEY | 是 | 您的Syncro API密钥 |
SYNCRO_SUBDOMAIN | 否 | 您的Syncro子域（如适用） |
获取API密钥
- 登录您的Syncro MSP帐户
- 导航到“设置”>“API令牌”
- 生成具有适当权限的新API令牌
建筑
决策树导航
服务器使用分层方法进行工具发现：
- 初始状态：仅显示导航和状态工具
- 导航后：域特定工具可用
- 返回导航：返回主菜单切换域
这减少了认知负荷，提高了LLM工具选择的准确性。
可用域名
| 域 | 描述 | 工具 |
|---|---|---|
customers | 管理客户帐户 | 列表、获取、创建、搜索 |
tickets | 管理支持票 | 列表、获取、创建、更新、添加_注释 |
assets | 管理配置项 | 列表、获取、搜索 |
contacts | 管理客户联系人 | 列表、获取、创建 |
invoices | 查看和管理账单 | 列表、获取、创建、发送电子邮件 |
工具参考
导航工具
同步导航
导航到域以访问其工具。
{
"domain": "customers" | "tickets" | "assets" | "contacts" | "invoices"
}syncro_back
从任何域返回主菜单。
同步状态
显示当前导航状态和凭据状态。
客户域名
syncro_客户列表
列出具有可选过滤器的客户。
{
"query": "search term",
"business_name": "Company Inc",
"email": "contact@example.com",
"include_disabled": false,
"page": 1,
"per_page": 25
}syncro_客户_获取
通过ID获取特定客户。
{
"customer_id": 123
}syncro_customers_create
创建新客户。
{
"business_name": "Acme Corp",
"firstname": "John",
"lastname": "Doe",
"email": "john@acme.com"
}syncro_客户_搜索
按查询字符串搜索客户。
{
"query": "acme",
"limit": 25
}门票域名
syncro_tickets列表
列出带有可选过滤器的门票。
{
"customer_id": 123,
"status": "Open",
"user_id": 456,
"resolved": false
}syncro_tickets_get
通过ID获得特定的票。
{
"ticket_id": 789
}syncro_tickets_create
创建新票证。
{
"customer_id": 123,
"subject": "Network Issue",
"problem_type": "Network",
"comment_body": "Initial description"
}syncro_tickets更新
更新现有工单。
{
"ticket_id": 789,
"status": "Resolved",
"user_id": 456
}syncro_tickets \_添加注释
在工单上添加评论。
{
"ticket_id": 789,
"body": "Comment text",
"hidden": false
}资产域
syncro_assets_list
列出具有可选筛选器的资产。
{
"customer_id": 123,
"asset_type": "Desktop"
}syncro_assets_get
按ID获取特定资产。
{
"asset_id": 456
}syncro_assets_search
按查询或序列号搜索资产。
{
"query": "workstation",
"asset_serial": "SN12345"
}联系人域
syncro_contacts_list
列出具有可选筛选器的联系人。
{
"customer_id": 123,
"query": "john"
}syncro_contacts_get
通过ID获取特定联系人。
{
"contact_id": 789
}syncro_contacts_create
创建新联系人。
{
"customer_id": 123,
"name": "Jane Smith",
"email": "jane@example.com"
}发票域
syncro_invoices_list
列出带有可选过滤器的发票。
{
"customer_id": 123,
"status": "sent",
"since_date": "2024-01-01"
}syncro_invoices_get
按ID获取特定发票。
{
"invoice_id": 456
}syncro_invoices_create
创建新发票。
{
"customer_id": 123,
"due_date": "2024-02-01"
}syncro_invoices_email
通过电子邮件向客户发送发票。
{
"invoice_id": 456,
"subject": "Your Invoice"
}速率限制
Syncro API的速率限制为每分钟180个请求。底层 @wyre-technology/node-syncro 库自动处理速率限制。
发展
# Install dependencies
npm install
# Build
npm run build
# Run in development
npm run dev
# Type check
npm run typecheck
# Lint
npm run lint许可证
阿帕奇-2.0