Kntor MCP Server

Kntor MCP服务器

Kntor.io医疗保健ERP的模型上下文协议（MCP）服务器。允许AI代理（Claude、n8n、WhatsApp机器人）与ERP系统交互。

Claude桌面设置

选项1：使用npx（推荐）

添加到您的Claude桌面配置(%APPDATA%\Claude\claude_desktop_config.json 在Windows上， ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "kntor-erp": {
      "command": "npx",
      "args": ["-y", "kntor-mcp"],
      "env": {
        "KNTOR_API_KEY": "kntor_your_api_key_here"
      }
    }
  }
}

选项2：使用本地安装

{
  "mcpServers": {
    "kntor-erp": {
      "command": "node",
      "args": ["C:\\path\\to\\kntor-mcp-server\\bin\\kntor-mcp.mjs"],
      "env": {
        "KNTOR_API_KEY": "kntor_your_api_key_here"
      }
    }
  }
}

保存配置后，重新启动Claude Desktop。

服务器开发

# Install dependencies
pnpm install

# Set up secrets
wrangler secret put SUPABASE_URL
wrangler secret put SUPABASE_ANON_KEY
wrangler secret put SUPABASE_SERVICE_ROLE_KEY

# Run locally
pnpm run dev

# Deploy
pnpm run deploy

认证

服务器使用3层身份验证模型：

1. API密钥 (x-api-key header）-标识品牌/租户
2. JWT （在工具调用中）-标识用户，保留 auth.uid()
3. 基于角色的访问控制 -执行前验证权限

获取API密钥

API密钥由品牌管理员在Kntor.io仪表板中创建：

1. 前往设置→ MCP集成
2. 单击“创建API密钥”
3. 保存密钥（仅显示一次）

可用工具

get_availability

查看专业人员的预约安排。

{
  "method": "tools/call",
  "params": {
    "name": "get_availability",
    "arguments": {
      "jwt": "eyJhbGciOiJS...",
      "date": "2025-01-20",
      "professional_id": "uuid-optional",
      "profession_type": "psychologist"
    }
  }
}

schedule_appointment

安排一个新的约会。

{
  "method": "tools/call",
  "params": {
    "name": "schedule_appointment",
    "arguments": {
      "jwt": "eyJhbGciOiJS...",
      "patient_id": "patient-uuid",
      "professional_id": "prof-uuid",
      "appointment_date": "2025-01-20",
      "start_time": "10:00",
      "duration_minutes": 60
    }
  }
}

API终点

示例请求

curl -X POST https://mcp.kntor.io/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: kntor_your_api_key_here" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

定价层次

发展

# Type check
pnpm run typecheck

# Run locally
pnpm run dev

# Deploy to production
pnpm run deploy

建筑

mcp-server/
├── src/
│   ├── index.ts           # Worker entry point
│   ├── types.ts           # TypeScript types
│   ├── auth/
│   │   ├── api-key.ts     # API key validation
│   │   └── jwt.ts         # JWT validation + user client
│   ├── tools/
│   │   ├── index.ts       # Tool registry
│   │   ├── get-availability.ts
│   │   └── schedule-appointment.ts
│   └── utils/
│       ├── supabase.ts    # Supabase client factory
│       └── metering.ts    # Usage logging
├── wrangler.toml          # Cloudflare config
└── package.json