TehProf.kz Support

TehProf Support MCP 服务

通过 Model Context Protocol 实现 AI 驱动的服务台管理。将任意兼容 MCP 的助手（Claude、ChatGPT、Cursor、Cline）连接到您的支持工作区，无需编写自定义集成代码。

TehProf Support（support.tehprof.kz）是一款面向 IT 服务公司的多租户 SaaS 服务台。本服务提供 36 个 AI 工具，涵盖知识搜索、工单生命周期、分析、自动化和 Bitrix24 CRM 代理，并根据订阅等级进行限制。

无需安装：使用托管端点 https://support.tehprof.kz/mcp。

目录

• 快速开始
• 按等级划分的工具
• 支持的 AI 客户端
• 架构
• 服务发现
• 身份验证
• 自托管
• 安全性
• 常见问题
• 贡献
• 许可证

快速开始

选项 1 — 托管服务（推荐）

添加到 MCP 客户端配置中，无需安装，也无需运行服务：

{
  "mcpServers": {
    "tehprof-support": {
      "url": "https://support.tehprof.kz/mcp",
      "transport": "streamable-http"
    }
  }
}

如需通过身份验证访问（解锁特定等级的工具）：

{
  "mcpServers": {
    "tehprof-support": {
      "url": "https://support.tehprof.kz/mcp",
      "transport": "streamable-http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

选项 2 — 通过 curl 进行基本检查

curl -sX POST https://support.tehprof.kz/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

您应该会收到包含服务功能的 initialize 响应。

按等级划分的工具

本服务根据您的 TehProf Support 套餐限制工具。匿名使用（不提供 API 密钥）开箱即用。

免费 — 匿名，无需 API 密钥

工具	功能
knowledge_search	对知识库进行全文搜索
knowledge_read	阅读指定文章
knowledge_list	按类别列出文章
onboarding_guide	分步设置指南
onboarding_features	按套餐列出的功能矩阵
demo_create_ticket	在沙盒中创建工单
demo_view_ticket	查看演示工单
demo_workflow	演示完整的工单生命周期
pricing_plans	列出所有定价套餐
pricing_calculate	个性化套餐推荐
system_health	平台状态探测
system_info	服务功能
system_tenant_info	您的租户元数据
settings_get	读取租户设置
settings_update	更新可用设置
settings_operators	列出团队中的操作员

Starter

工具	功能
tickets_list	筛选工单列表
tickets_get	工单、消息和参与者
analytics_dashboard	KPI 仪表板概览
channels_list	消息渠道
channels_status	各渠道的连接状态

Pro

工具	功能
tickets_create	创建工单；可通过您自己的稳定外部 ID 同步客户公司/联系人（幂等），并通过 external_ref 去重
tickets_reply	代表操作员发布回复
tickets_update	更改状态/优先级
analytics_sla	SLA 合规报告
analytics_operators	各操作员的绩效
automation_rules_list	列出自动化规则
automation_rules_create	创建新规则
automation_rules_toggle	启用/禁用规则
webhooks_list	出站 Webhook

业务

工具	功能
bitrix_contacts	搜索 CRM 联系人
bitrix_deals	列出 CRM 交易
bitrix_tasks	筛选 Bitrix24 任务
bitrix_task_create	创建关联到工单的 Bitrix24 任务
bitrix_users	门户用户目录
channels_configure	配置 WA / TG / Email 渠道

支持的 AI 客户端

适用于任何通过 Streamable HTTP 使用 MCP 协议的客户端：

• Claude Desktop — claude_desktop_config.json
• Claude Code — .mcp.json 或 ~/.claude/settings.json
• Cursor — MCP 设置面板
• Cline / Continue.dev — config.json
• ChatGPT（Custom GPT） — 参见 gpt-config.md
• 自定义 Agent — 任何使用 @modelcontextprotocol/sdk 的客户端

架构

┌──────────────────────┐     Streamable HTTP      ┌──────────────────────┐
│  AI Client           │  ──────────────────────▶ │  MCP Server (this)   │
│  (Claude, GPT, ...)  │  JSON-RPC 2.0 + SSE      │  Node 20 + TS strict │
└──────────────────────┘                          └──────────┬───────────┘
                                                             │ HTTP localhost
                                                             ▼
                                                   ┌──────────────────────┐
                                                   │  PHP backend         │
                                                   │  mcp-auth.php        │
                                                   │  mcp-internal.php    │
                                                   └──────────┬───────────┘
                                                              │
                                                              ▼
                                                   ┌──────────────────────┐
                                                   │  SQLite (WAL)        │
                                                   │  Bitrix24 REST       │
                                                   └──────────────────────┘

为什么选择 Streamable HTTP（MCP 2025-03-26），而不是 stdio / SSE？ 可通过企业代理运行，支持水平扩展，无需管理长连接——这是远程 MCP 的规范传输方式。

服务发现

MCP 客户端可通过 .well-known 端点自动发现此服务：

GET https://support.tehprof.kz/.well-known/mcp.json

响应会列出服务能力、身份验证要求和层级说明。

身份验证

1. 登录 support.tehprof.kz。
2. 设置 → API 密钥 → 创建。
3. 在 MCP 客户端标头配置中，将其用作 Authorization: Bearer <key>。
4. 可随时在同一面板中撤销或轮换密钥。

密钥以哈希形式静态存储，受到速率限制，并且每次调用都会根据租户的套餐进行验证。

同一租户 API 密钥也可供 GPT/OpenAPI 客户端用于 https://support.tehprof.kz/api/openapi.json，身份验证方式为 Authorization: Bearer <key>。直接调用 /api/admin.php 的 REST 集成则使用 X-Api-Key: <key>。

安全

• 传输：TLS 1.3、HSTS，无混合内容。
• CORS：允许列表（support.tehprof.kz、claude.ai、chat.openai.com）——不使用通配符。
• 会话：闲置 TTL 为 1 小时，每 5 分钟清除一次。
• 租户隔离：经过身份验证的 MCP/OpenAPI 调用会根据 API 密钥解析租户；不匹配的 tenant_id 将被拒绝，并返回 403。
• 内部桥接：mcp-auth.php 不公开；mcp-internal.php 要求使用 Bearer 身份验证来访问租户数据，写入操作则要求 write 范围。
• 密钥：绝不发送到客户端，存储在服务器端的 HashiCorp Vault 中。
• 审计日志：每次工具调用都会记录到对应租户名下。

请将漏洞报告发送至 [email protected]（请勿公开提交安全问题）。

自托管

对于需要在自有网络中运行 MCP 服务的租户：

git clone https://github.com/tehprof/support-mcp
cd support-mcp
npm install
npm run build
MCP_PORT=8101 MCP_HOST=127.0.0.1 node dist/index.js

设置 SUPPORT_BACKEND_URL，使其指向你的 Support 后端。完整环境变量说明见 CLAUDE.md。

常见问题

没有 TehProf 账户也能使用吗？ 可以——匿名访问可解锁 16 个免费工具（知识、入门引导、演示、定价、系统、设置）。

可以与 ChatGPT 搭配使用吗？ 可以。使用 Custom GPT——配置见 gpt-config.md。

如果我的套餐不包含某个工具，该怎么办？ 该工具会从 tools/list 中隐藏——AI Agent 不会看到它。请前往 support.tehprof.kz 升级。

如何列出我的套餐开放的所有工具？ 调用 MCP tools/list——服务会根据你的 Authorization 标头实时筛选。

源代码在哪里？ 就在这里——github.com/tehprof/support-mcp。采用 MIT 许可。

链接

• 网站 — support.tehprof.kz
• MCP 端点 — https://support.tehprof.kz/mcp
• 服务卡片 — /.well-known/mcp.json
• 知识库 — support.tehprof.kz/help
• Bitrix24 Marketplace — bitrix24.kz/apps/app/tekhprof.app2
• MCP 规范 — modelcontextprotocol.io

参与贡献

欢迎提交拉取请求。对于较大的更改，请先提交议题进行讨论。

License

MIT — see LICENSE.