TicketDesk MCP
TicketDesk MCP — 本番運用向けのMCPサーバー&クライアント
Model Context Protocol(MCP)のサーバーで、社内のサポートチケットキューを公開し、ペアとなるクライアントがそのツール、リソース、プロンプトを発見して呼び出す構成です。"Build a Production MCP Server & Client" ラボ(Module 4, Model Context Protocol)用に作られています。
目次
docs/tool-resources-prompts.md— サーバーが公開する機能docs/architecture.md— トランスポートの選択と根拠docs/security-summary.md— 認証、最小特権、エラー処理demo/session_log.txt— 実際に取込んだ発見・呼出しの一連のログ
Related MCP server: Ticket Queue MCP Server
アーキテクチャ
flowchart TD
HOST["Host application\n(e.g. an AI assistant / chatbot)"] --> CLIENT
subgraph Client["client.py — fastmcp.Client"]
CLIENT["Discovery: list_tools / list_resources /\nlist_resource_templates / list_prompts"]
ELICIT["elicitation_handler\n(client-side safety gate for\nhigh-impact actions)"]
CLIENT <--> ELICIT
end
CLIENT <-->|"Streamable HTTP\nAuthorization: Bearer <token>"| SERVER
subgraph Server["server.py — FastMCP('TicketDesk')"]
AUTH["StaticTokenVerifier\n(read:tickets / write:tickets scopes)"]
TOOLS["Tools: search_tickets, get_ticket,\nadd_ticket_note, close_ticket"]
RES["Resources: ticket://{ticket_id},\npolicy://sla"]
PROMPT["Prompt: triage_ticket"]
AUTH --> TOOLS
AUTH --> RES
AUTH --> PROMPT
end
SERVER --> DATA[("data/tickets.json,\ndata/sla_policy.md")]トランスポート: Streamable Streamable — 根拠はdocs/architecture.md(短く言えば、これは stdio が向いている「単一のローカルプロセス間の組み合わせ」ではなく、複数のチームの AI アプリケーションが接続する共有の社内機能として想定されているため)。
この MCP の公開アイテム
サーバーが公開するもの
4 tomのツール:
search_tickets,get_ticket,add_ticket_note,close_ticket(最後のものはクライアント側立enthousiastic をゲートに持つ高インパクトなアクション)2 リソース行:
ticket://{ticket_id}(テンプレート型)とpolicy://sla(静的)1 プロンプト:
triage_ticket
各項目の予約ドキュメンテーションはdocs/tools-resources-prompts.md を参照。
セットアップとデモの実行
pip install -r requirements.txt
# Terminal 1
python server.py
# Terminal 2
python client.py # interactive: real confirmation prompts via input()
python client.py --auto-confirm # non-interactive demo mode (used to produce demo/session_log.txt)client.py は dev-agent-token(読み取り+書き込みスコープ)で接続し、ディスカバリを実行、各ツール/リソース/プロンプトを一つずつ呼び出し、エラーハンドリングの二つの障害モード(要件 8)を実演し、close_ticket の高インパ仮クトアクションをクライアント側のエリエーションで実行(要件 6)し、最後に最小権限のデモとして dev-readonly-token が書き込みスコープのツールから正しく拒否されることを示します。
セキュリティ
全体については docs/security-summary.mdを参照。要約:StaticTokenVerifier による bearer-token認証、ツール単位の明示的スコープ検査(接続レベル・スコープ要求だけでは個々のツール呼び出しを制限できな、実際のスキマ・ギャップが開発中に発見・修正された。詳はセキュリテイドキュメントの積率な説明を参照)、そして ToolError と mask_error_details=True により、ユーザが対処可能なエラーと、絶対にそのままクライアントに返してはならない内部障害を区別します。
要件写像
要件 | 満たされる場所 |
≥3 りつのツール |
|
≥2 りつのリソース、各パURI |
|
≥1 りつの再利用可プロンプト |
|
クライアントが側個の発見/呼出し |
|
トランスポートンタの根拠 |
|
クライアント側回路の | |
安全対策 | エリシエーションによる |
セキュリテイ設計概要 |
|
リアルな障害モードでのエラー処理 | 無効なチケットID( |
デモ記録 |
|
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Helpdesk tickets from your AI: find, reply, take, hold, complete — within your own role. OAuth.
Build and manage AI-native customer support agents from Claude or any MCP client.
Work your Help tickets with your AI: read them, reply or leave notes, and set up forms and sites.
An MCP gateway for teams deploying AI tools at scale to employee-facing and headless agents.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to perform helpdesk tasks over MCP, including ticket management, knowledge base search, and reply drafting, with optional pay-per-action USDC settlement and human approval workflows.232MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI clients to access and manage an internal support ticket queue through MCP tools, resources, and prompts, including searching and viewing tickets, adding comments, closing tickets with confirmation, reading knowledge base articles, and viewing queue summaries over OAuth-secured Streamable HTTP.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to query and operate a help desk and service desk through MCP over HTTP, including tickets, requester communications, internal notes, attachments, stage and SLA history, time entries, clients, requesters, desks, knowledge base, contracts, and billing/satisfaction reports.MIT

Teletype MCP Serverofficial
AlicenseNot gradedqualityBmaintenanceEnables AI assistants to find and read customer conversations, look up profiles, send replies, manage workspace metadata, and handle daily support workflows. It also supports triage, drafting, escalation, and handover tasks through MCP tools, prompts, and resources.45 npm1MIT