TehProf.kz Support

TehProf Support MCP サーバー

Model Context Protocol を介した AI 搭載のヘルプデスク管理です。MCP 互換のアシスタント（Claude、ChatGPT、Cursor、Cline）をサポートワークスペースに接続できます。カスタム連携コードは不要です。

TehProf Support (support.tehprof.kz) は、IT サービス企業向けに構築されたマルチテナントの SaaS ヘルプデスクです。このサーバーは、ナレッジ検索、チケットのライフサイクル、分析、自動化、Bitrix24 CRM プロキシを網羅する 36 の AI ツールを、サブスクリプションプランに応じて提供します。

インストールは不要です。ホスト型エンドポイント https://support.tehprof.kz/mcp をご利用ください。

目次

• クイックスタート
• プラン別ツール
• 対応 AI クライアント
• アーキテクチャ
• サーバーの検出
• 認証
• セルフホスト
• セキュリティ
• FAQ
• 貢献
• ライセンス

クイックスタート

オプション 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 キーなし）でもすぐに利用できます。

Free — 匿名、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 / メールのチャネルを設定します

対応 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 をご覧ください
• カスタムエージェント — @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       │
                                                   └──────────────────────┘

stdio / SSE ではなく、Streamable HTTP（MCP 2025-03-26）を採用する理由は？ 企業のプロキシ経由で動作し、水平スケーリングが可能で、長時間接続を管理する必要がありません。リモート MCP における標準的なトランスポートです。

サーバーの検出

MCP クライアントは .well-known エンドポイントを介して、このサーバーを自動検出できます。

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

応答には、サーバーの機能、認証要件、ティアの説明が含まれます。

認証

1. support.tehprof.kz にログインします。
2. 設定 → API Keys → 作成を選択します。
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 バックエンドの URL に設定してください。環境変数の一覧は CLAUDE.md をご覧ください。

FAQ

TehProf アカウントがなくても利用できますか？ はい。匿名アクセスでは、16 個の無料ツール（ナレッジ、オンボーディング、デモ、料金、システム、設定）を利用できます。

ChatGPT で利用できますか？ はい。Custom GPT を使用してください。設定については gpt-config.md をご覧ください。

プランに含まれていないツールはどうなりますか？ そのツールは tools/list に表示されないため、AI エージェントには表示されません。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.