TehProf Support MCP Server

AI-powered helpdesk management via Model Context Protocol. Connect any MCP-compatible assistant (Claude, ChatGPT, Cursor, Cline) to your support workspace — no custom integration code.

TehProf Support (support.tehprof.kz) is a multi-tenant SaaS helpdesk built for IT service companies. This server exposes 36 AI tools covering knowledge search, ticket lifecycle, analytics, automation, and Bitrix24 CRM proxy — gated by subscription tier.

Zero installation: use the hosted endpoint at https://support.tehprof.kz/mcp.

Table of Contents

• Quick Start
• Tools by Tier
• Supported AI Clients
• Architecture
• Server Discovery
• Authentication
• Self-Hosting
• Security
• FAQ
• Contributing
• License

Quick Start

Option 1 — hosted (recommended)

Add to your MCP client config — no install, no server to run:

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

For authenticated access (unlocks tier-specific tools):

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

Option 2 — sanity check via 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"}}}'

You should receive an initialize response with server capabilities.

Tools by Tier

The server gates tools by your TehProf Support plan. Anonymous (no API key) works out of the box.

Free — anonymous, no API key

Starter

Pro

Business

Supported AI Clients

Works with any client that speaks MCP over Streamable HTTP:

• Claude Desktop — claude_desktop_config.json
• Claude Code — .mcp.json or ~/.claude/settings.json
• Cursor — MCP settings panel
• Cline / Continue.dev — config.json
• ChatGPT (Custom GPT) — see gpt-config.md
• Custom agents — any @modelcontextprotocol/sdk consumer

Architecture

┌──────────────────────┐     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       │
                                                   └──────────────────────┘

Why Streamable HTTP (MCP 2025-03-26) and not stdio / SSE? Works through corporate proxies, scales horizontally, no long-lived connections to manage — the canonical transport for remote MCP.

Server Discovery

MCP clients can auto-discover this server via the .well-known endpoint:

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

The response lists server capabilities, auth requirements, and tier descriptors.

Authentication

1. Log in at support.tehprof.kz.
2. Settings → API Keys → Create.
3. Use it as Authorization: Bearer <key> in the MCP client header config.
4. Revoke / rotate any time from the same panel.

Keys are hashed at rest, rate-limited, and validated against the tenant's plan on every call.

The same tenant API key may also be used by GPT/OpenAPI clients against https://support.tehprof.kz/api/openapi.json as Authorization: Bearer <key>. Direct REST integrations that call /api/admin.php use X-Api-Key: <key> instead.

Security

• Transport: TLS 1.3, HSTS, no mixed content.
• CORS: allowlist (support.tehprof.kz, claude.ai, chat.openai.com) — no wildcard.
• Sessions: 1-hour inactivity TTL, evicted every 5 minutes.
• Tenant isolation: authenticated MCP/OpenAPI calls resolve the tenant from the API key; mismatched tenant_id is rejected with 403.
• Internal bridge: mcp-auth.php is not public; mcp-internal.php requires Bearer auth for tenant data and write actions require write scope.
• Secrets: never sent client-side, stored in HashiCorp Vault server-side.
• Audit log: every tool call is recorded against the tenant.

Report vulnerabilities to ilay25@gmail.com (please do not open public issues for security).

Self-Hosting

For tenants who need the MCP server running in their own network:

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

Set SUPPORT_BACKEND_URL to point at your Support backend. See CLAUDE.md for full env reference.

FAQ

Does this work without a TehProf account? Yes — anonymous access unlocks 16 free tools (knowledge, onboarding, demo, pricing, system, settings).

Can I use it with ChatGPT? Yes. Use a Custom GPT — configuration is in gpt-config.md.

What if my plan doesn't include a tool? The tool is hidden from tools/list — AI agents never see it. Upgrade at support.tehprof.kz.

How do I list all tools my plan exposes? Call MCP tools/list — the server filters in real time based on your Authorization header.

Where is the source code? Right here — github.com/tehprof/support-mcp. MIT licensed.

Links

• Website — support.tehprof.kz
• MCP endpoint — https://support.tehprof.kz/mcp
• Server card — /.well-known/mcp.json
• Knowledge base — support.tehprof.kz/help
• Bitrix24 Marketplace — bitrix24.kz/apps/app/tekhprof.app2
• MCP spec — modelcontextprotocol.io

Contributing

Pull requests welcome. For non-trivial changes, please open an issue first to discuss.

License

MIT — see LICENSE.