TISYM MCP Server — dokumentace

TISYM poskytuje MCP (Model Context Protocol) server, který umožňuje AI asistentům přistupovat k datům helpdesku, projektů, fakturace a výkazů práce. Tato stránka popisuje dostupné nástroje, oprávnění a způsob připojení.

MCP URL: https://mcp.tisym.com
Protokol: MCP 2025-03-26, JSON-RPC 2.0, Streamable HTTP
Autentizace: OAuth 2.0 Authorization Code Flow + PKCE

Uživatelské role a oprávnění

Admin

Plný přístup ke všem 26 nástrojům — tikety, projekty, zákazníci, uživatelé, faktury, výkazy práce.

Solver (řešitel)

Helpdesk + projekty + výkazy práce. Fakturace a správa uživatelů není dostupná.

Contact (zákazník)

Zobrazení a zakládání vlastních tiketů a projektů. Jen čtení — bez zápisu do cizích dat.

Přehled nástrojů

Nástroj	Popis	Admin	Solver	Contact
Systém
`get_instance_info`	Informace o instanci	✅	✅	✅
Tikety
`list_tickets`	Seznam tiketů s filtry	✅	✅	✅
`get_ticket_details`	Detail tiketu	✅	✅	✅
`create_ticket`	Vytvoření tiketu	✅	✅	✅
`add_ticket_note`	Přidání komentáře k tiketu	✅	✅	✅
`delegate_ticket`	Přidělení tiketu řešiteli	✅	✅	❌
`get_attachment`	Stažení přílohy tiketu	✅	✅	✅
Projekty
`list_projects`	Seznam projektů	✅	✅	✅
`get_project_details`	Detail projektu	✅	✅	✅
`create_project`	Vytvoření projektu	✅	❌	❌
`update_project`	Úprava projektu	✅	❌	❌
`delete_project`	Smazání projektu	✅	❌	❌
Zákazníci
`list_customers`	Seznam zákazníků	✅	❌	❌
`get_customer_details`	Detail zákazníka	✅	❌	❌
`create_customer`	Vytvoření zákazníka	✅	❌	❌
`update_customer`	Úprava zákazníka	✅	❌	❌
`delete_customer`	Smazání zákazníka	✅	❌	❌
Výkazy práce
`list_work_reports`	Seznam výkazů	✅	✅	❌
`create_work_report`	Přidání výkazu práce	✅	✅	❌
`export_work_reports_csv`	Export výkazů do CSV	✅	✅	❌
Faktury
`list_invoices`	Seznam faktur	✅	❌	❌
`get_invoice_details`	Detail faktury	✅	❌	❌
`create_invoice`	Vystavení faktury	✅	❌	❌
`update_invoice`	Úprava faktury	✅	❌	❌
`mark_invoice_paid`	Označení faktury jako uhrazené	✅	❌	❌
`delete_invoice`	Smazání faktury	✅	❌	❌

Ukázky použití

Všechny příklady níže vychází z reálných dat testovací instance TISYM (test.tisym.com) a lze je kdykoli zopakovat — pouze čtou data, nic nemění.

Příklad 1 — Informace o TISYM instanci a přihlášeném uživateli
Prompt: „Jaká je to TISYM instance a kdo jsem přihlášen?"
AI zavolá: get_instance_info + get_current_user
Ukázková odpověď:

Jsi přihlášen jako Test (admin) do instance „Test" (test.tisym.com).
Dostupné jazyky: čeština (cs), angličtina (en).
Tvůj jazyk: angličtina, časové pásmo: Europe/Berlin.

Příklad 2 — Neřešené a odložené tikety seřazené podle priority
Prompt: „Ukaž mi tikety, které ještě nejsou vyřešené nebo jsou odložené — seřazené podle priority."
AI zavolá: list_tickets s id_states: [1, 7], sortBy: priority, sortDir: asc
Ukázková odpověď:

#16348 — PCI-DSS compliance review [Kritická] — Odloženo — Payment Gateway Integration
#16347 — Payment gateway integration - Stripe & PayPal [Vysoká] — Neřešeno — E-Commerce Platform Development
#16344 — Server migration - phase 1 planning [Standardní] — Odloženo — Cloud Infrastructure Upgrade
#16350 — Analytics dashboard for supply chain KPIs [Nízká] — Neřešeno — Supply Chain Tracking System

Příklad 3 — Na jakých projektech pracuji?
Prompt: „Vypiš aktivní projekty."
AI zavolá: list_projects s active: true
Ukázková odpověď:

Aktivní projekty (4):
• Cloud Infrastructure Upgrade — zákazník: TechVision Solutions Ltd.
• E-Commerce Platform Development — zákazník: Greenfield Digital Inc.
• Payment Gateway Integration — zákazník: Blue Harbour Fintech Pty Ltd
• Supply Chain Tracking System — zákazníci: Ironbridge Consulting Ltd., Northern Route Logistics Ltd.

Příklad 4 — Detail tiketu a jeho komentáře
Prompt: „Jaký je stav tiketu č. 16347 a co se na něm řešilo?"
AI zavolá: get_ticket_details s id: 16347
Ukázková odpověď:

Tiket: Payment gateway integration - Stripe & PayPal
Projekt: E-Commerce Platform Development | Stav: Neřešeno | Priorita: Vysoká

Komentáře (2):
1. Stripe integrace dokončena a otestována v sandboxu. PayPal OAuth flow implementován.
   Webhook endpointy nasazeny na staging. Refund flow potřebuje další testování.
   (5 hodin práce)
2. [INTERNÍ] Stripe sandbox přihlašovací údaje je nutné před spuštěním do produkce
   obměnit. Nesdílet aktuální testovací klíče s klientem.

Příklad 5 — Výkazy práce k projektu
Prompt: „Kolik hodin bylo vykázáno na projektu Cloud Infrastructure Upgrade?"
AI zavolá: list_work_reports s idProject: 601
Ukázková odpověď:

Výkazy práce — Cloud Infrastructure Upgrade:

CI/CD pipeline setup (tiket #16345):
  Pipeline plně nakonfigurována a otestována. Všechny fáze prošly včetně integračních testů.
  Spuštění do produkce vyžaduje manuální schválení od Sophie Caldwell.
  Čas: 3,5 hod | Autor: Test

Celkem: 3,5 hod (1 výkaz)

Dotazy k integraci: info@tisym.com