settings_input_componentIntegrations

Prepojte celý svoj workflow

MCP server pre AI asistentov. Inbound webhooky z GitHubu a GitLabu. Import z Jiry a Trella. Export do českého fakturačného systému.

MCP Server: rodný jazyk AI

mcptask.online poskytuje dedikovaný Model Context Protocol server — štandardizovaný spôsob, akým AI asistenti komunikujú s externými nástrojmi. Žiadny middleware, žiadne scrapovanie, žiadne vlastné API. Natívna integrácia.

Rýchly slovníček

Zopár pojmov používaných na tejto stránke — ľudsky.

MCP

Model Context Protocol — štandardizovaný protokol, ktorým si AI asistenti (Claude, Cursor, Cline, …) volajú externé nástroje. mcptask.online hovorí MCP natívne, takže ho vie ovládať ľubovoľný MCP klient.

SSE

Server-Sent Events — HTTP transport, ktorý MCP používa na streamovanie volaní nástrojov. Váš AI klient otvorí dlho bežiace spojenie na našu URL /mcp/sse.

Webhook

HTTP volanie, ktoré jedna aplikácia vykoná druhej, keď sa niečo stane. Inbound = niekto volá mcptask.online (napr. GitHub pri pushi). Outbound = mcptask.online volá váš systém (plánované, zatiaľ nie je).

MCPTASK_TOKEN

Dlhý náhodný reťazec, ktorým mcptask.online overí, že požiadavka naozaj prichádza od vás. Vygenerujte si ho v Nastavenia → API Access a používajte ho ako Bearer token. Berte ho ako heslo.

Čo je MCP?

MCP (Model Context Protocol) je štandardný protokol, ktorý AI asistenti ako Claude používajú na volanie externých nástrojov a čítanie externých dát. Namiesto ručného HTTP alebo parsovania HTML AI hovorí MCP natívne a my servírujeme definície nástrojov.

check_circleAI okamžite rozumie štruktúre dát

check_circleNepíšete žiadny vlastný integračný kód

check_circleSpoľahlivý, verzovaný protokol

check_circleRovnaké rozhranie pre všetkých MCP klientov

Čo cez MCP zvládnete

Čítanie:

visibilityVypísať projekty a pieces (úlohy/stories/epicy)
visibilityNačítať detail piece (popis, stav, história)
visibilityZobraziť väzby rodič/potomok
visibilityČítať komentáre a prílohy
visibilityČítať záznamy effortov

Zápis:

editZmeniť stav piece
editZalogovať effort
editPridať komentár
editPriložiť súbor
editVytvoriť piece a sub-piece

Dotazy:

searchZískať ďalší dostupný piece (zoradený podľa priority)
searchFiltrovať pieces podľa projektu, stavu, typu
searchVyhľadávať v popisoch
searchVypísať poslednú aktivitu

Nastavenie za 2 minúty

Jednorazovo. Potom každý MCP klient, ktorý pripojíte (Claude Code, Claude Desktop, Cursor, Cline, …), vie hovoriť s mcptask.online.

1. Získajte MCPTASK_TOKEN
Prihláste sa do mcptask.online → Nastavenia → API Access → Generate token. Skopírujte dlhý reťazec.
2. Exportujte ho v shelli
Vložte do terminálu (alebo pridajte do ~/.zshrc / ~/.bashrc, aby prežil reštart):
```
 export MCPTASK_TOKEN=mcptask_xxxxxxxxxxxxxxxxxxxxxxxxxxxx 
```

3. Vložte toto do .mcp.json (Claude Code) alebo do MCP dialógu vášho klienta

Kánonický .mcp.json (Claude Code):

 {  "mcpServers": {    "mcptask-online": {      "type": "sse",      "url": "https://mcptask.online/mcp/sse",      "headers": { "Authorization": "Bearer ${MCPTASK_TOKEN}" }    }  }}

4. Kde je ten súbor?
Claude Code číta .mcp.json z koreňa projektu (alebo globálne z ~/.claude.json). Pre Claude Desktop / Cursor / Cline vložte rovnaký JSON do MCP konfiguračného dialógu klienta.
5. Reštartujte AI klienta
Claude Code, Cursor a pod. načítavajú MCP servery pri štarte. V zozname nástrojov uvidíte server mcptask-online.

info

Ostatní MCP klienti

Štandardné MCP cez SSE. Použite rovnakú URL (https://mcptask.online/mcp/sse) a rovnakú hlavičku Authorization: Bearer ako vyššie.

downloadChcete radšej jedným príkazom? Pozrite si stránku /installation pre sprievodcu na macOS, Linuxe aj všeobecne na ľubovoľnom systéme.

Dostupné MCP nástroje

Týchto 12 nástrojov je reálne v MCP serveri mcptask.online dnes. AddMessageTool, AddAttachmentTool, CreatePieceTool, LogWorkProgressTool a všetky read nástroje fungujú end-to-end.

Tool	Description
`create_piece`	Vytvoriť nový piece (úloha, story, epic, recurent)
`get_piece`	Načítať jeden piece podľa ID
`list_pieces`	Vypísať pieces s filtrami (projekt, stav, typ)
`get_next_task`	Získať najdôležitejšiu dostupnú úlohu
`get_project_tree`	Získať hierarchiu projektu (epicy/stories/úlohy)
`list_projects`	Vypísať projekty, ku ktorým máte prístup
`get_project`	Načítať metadáta jedného projektu
`get_current_user`	Identifikovať používateľa za aktuálnym tokenom
`log_work_progress`	Zalogovať effort na piece a posunúť postup
`add_message`	Pridať komentár / správu k piece
`add_attachment`	Priložiť súbor k piece
`get_piece_efforts`	Načítať časové záznamy piece
`get_usage_guide`	Server sám opíše svoje schopnosti (capabilities a hinty na použitie)

Autentifikácia

Jeden credential, jedna env premenná. Žiadna stránka s API kľúčmi, žiadna OAuth appka na registráciu.

MCPTASK_TOKEN (Bearer):

vpn_keyVygenerujte v Nastavenia → API Access v mcptask.online
vpn_keyZviazaný s vaším používateľským účtom, scopovaný na vaše workspaces
vpn_keyKedykoľvek zrušte alebo rotujte na rovnakej stránke
vpn_keyBerte ho ako heslo — ktokoľvek ho má, koná ako vy

Oprávnenia:

securityToken dedí oprávnenia vášho používateľa — dnes žiadne ďalšie scope
securityRead-only vs. read-write riadia akcie, ktoré voláte
securityIzolácia per-project sa vynucuje na serveri
securityVšetky volania sa logujú pod vaším používateľom

Limity

Plan	Requests/Hour
Starter	1 000 požiadaviek/hod
Professional	10 000 požiadaviek/hod
Enterprise	Individuálne

Tieto čísla sú realistické, ale zatiaľ nie sú vynucované tvrdým limiterom — popisujú cieľové SLA. Ozvite sa, ak narazíte na stenu.

Verzovacie systémy (inbound webhooky)

These are inbound webhooks — your Git host calls mcptask.online when something happens. Outbound webhooks (mcptask.online → your systems) are planned, see below.

GitHub integrácia

check_circleFunguje (inbound webhook)schedule5 minút

Funkcie

codeWebhookové spracovanie eventov (push, pull request)

codeTelo PR sa parsue pre referencie na piece (napr. #Task-47)

codePR open/merge sa pridá na piece ako komentár s odkazom

codeČas zalogovaný z merge PR, ak je uvedená doba

Ako to funguje

1Otvorte piece v mcptask.online a skopírujte jeho webhook URL — každý piece má unikátnu URL v tvare https://mcptask.online/github/efforts/<token>
2Pridajte túto URL ako webhook v nastaveniach GitHub repozitára (Settings → Webhooks)
3Vyberte eventy: Push, Pull request
4Webhook uložte (secret nie je potrebný)
5Referencujte piece v commitoch a tele PR: napr. "Fix login #Task-47 2h"
6mcptask.online webhook prijme, napojí PR a zaloguje čas

Odkiaľ sa berú referencie #Task-47?

mcptask.online používa relatívne ID piece (napr. 47) ako referenčný token #Task-47. Nájdete ho na každej stránke piece a v URL — kánonický tvar je mcptask://pieces/{account_code}/{piece_id}.

Examples:

 Fix login #Task-47 2hImplement OAuth #Story-48 3h 30mRefactor auth #Epic-49 (no time logged, just a link)

Integrácia pull requestov

mergeTelo a názov PR sa parsue pre referencie (ľubovoľné #Task-N, #Story-N, #Epic-N, #Recurent-N)
mergePR otvorený → na piece pribudne komentár s odkazom na PR
mergePR mergnutý → posledný otvorený effort sa uzavrie, komentár sa aktualizuje
mergeStav PR je viditeľný na timeline piece

Možnosti konfigurácie

settingsViacero repozitárov na projekt

settingsPodpora privátnych repozitárov (ľubovoľný GitHub repo, kam webhook dosiahne)

settingsVlastné vzory pre referencie (predvolené: #Task-N, #Story-N, #Epic-N, #Recurent-N)

settingsAktualizácie stavu podľa branche

GitLab integrácia

check_circleFunguje (inbound webhook)schedule5 minút

Funkcie

codeRovnaké schopnosti ako GitHub (push, merge request)

codeFunguje s GitLab.com (SaaS)

codeFunguje so self-hosted GitLab (12.0+)

codePrepojenie merge requestov

Self-hosted setup

1Skopírujte webhook URL z mcptask.online (rovnaký tvar ako GitHub: /gitlab/efforts/<token>)
2Pridajte URL ako webhook v GitLab projekte (Settings → Webhooks)
3Trigger: Push events, Merge request events
4Otestujte doručenie z GitLab UI

Bezpečnosť

securityOverenie podpisu webhooku

securityAutentifikácia tokenom (URL token per piece)

securityŽiadny prístup k zdrojovému kódu (len metadáta)

securityVyžadované TLS šifrovanie

Import z projekťáku

Jira import

scienceBeta (import na požiadanie)workspace_premiumProfessional, Enterprise

Čo sa importuje

checkHierarchia issue (Epic > Story > Task > Subtask)

checkPopisy a základné akceptačné kritériá

checkKomentáre a diskusie

checkPrílohy

checkČasové záznamy (worklogy)

Čo sa neimportuje

removeJira workflows (mcptask.online používa jednoduchšie stavy)

removeJira pluginy/extenzie

removeAdmin nastavenia a schémy oprávnení

removeHistória sprintov (mapujeme len aktuálny stav)

removeUI pre mapovanie custom fields (robíme best-effort pasívne)

Postup

1Kontaktujte nás s URL Jiry a read-only API tokenom
2Import pustíme spoločne (background job, manuálny štart)
3Schválite mapovanie polí
4Ak niečo nesedí, pustíme znova

scheduleTypicky: záleží na veľkosti projektu — obvykle pol dňa s našou pomocou

Trello import

scienceBeta (import na požiadanie)workspace_premiumProfessional, Enterprise

Čo sa importuje

checkBoardy → projekty

checkZoznamy → epicy alebo stavy (konfigurovateľné)

checkKarty → úlohy

checkChecklisty → sub-úlohy

checkPrílohy

checkKomentáre

checkŠtítky → tagy

checkTermíny

Mapovanie

arrow_forward

HierarchickéZoznamy sa stanú epicy obsahujúcimi úlohy

arrow_forward

PlochéZoznamy sa stanú stavmi úloh

arrow_forward

VlastnéDefinujte si vlastné mapovanie

Postup

1Autorizujte Trello prístup v Nastavenia → Integrácie
2Spoločne vyberieme boardy a štýl mapovania
3Spustíme import
4Skontrolujete a doupravíte

scheduleTypicky: 10-30 minút s našou pomocou

EasyRedmine import

support_agentNa požiadaniediamondEnterprise

Kontaktujte nás pre pomoc s migráciou z EasyRedmine.

Podpora migrácie v Enterprise

Náš tím vám pomôže presťahovať sa z EasyRedmine s minimálnym výpadkom.

mailKontaktovať obchod

Fakturácia

Fakturoid (CZ)

check_circleFungujeverifiedVšetky plány

Funkcie

checkOAuth 2.0 autentifikácia

checkExport schválených effortov → faktúry

checkAutomatický výpočet DPH (CZ sadzby)

checkMapovanie klientov (Fakturoid kontakt ↔ mcptask.online spoločnosť)

checkSledovanie platieb

Postup

1Schválte efforty v mcptask.online
2Kliknite na "Export do Fakturoidu"
3Faktúra sa vytvorí vo Fakturoide
4Skontrolujte a odošlite z Fakturoidu
5Označte ako vyfaktúrované v mcptask.online

scheduleSetup: 5 minút

iDoklad (CZ)

check_circleFungujeverifiedVšetky plány

Funkcie

checkOAuth 2.0 autentifikácia

checkGenerovanie faktúr

checkDPH súlad (CZ)

checkPodpora viacerých mien

checkPárovanie bankových výpisov (dnes manuálne; plný sync je v roadmap)

Postup

Rovnaký tvar ako Fakturoid — vyberte efforty, exportujte, fakturujte. Bankový sync iDokladu je u nás dnes read-only; plná rekonciliácia je plánovaná.

Stripe (vlastná fakturácia mcptask.online)

check_circleFungujecredit_cardVšetky plány

info

Pozor: Stripe tu poháňa vlastné predplatné mcptask.online (per-seat Starter/Professional/Enterprise). Nie je to spôsob, ako cez mcptask.online fakturovať svojim klientom. Na fakturáciu klientov použite Fakturoid alebo iDoklad vyššie.

Čo tu Stripe robí

checkStiahne vám kartu za zvolený plán mcptask.online

checkPer-seat predplatné, prorated pri pridaní/odobraní

checkOšetrenie neúspešných platieb (e-mail + retry, potom downgrade)

checkPDF faktúry zo Stripe pre vaše účtovníctvo

checkViac mien pre medzinárodné karty

Toto je pre…

arrow_forwardPlatbu mcptask.online za miesta vo vašom tíme

arrow_forwardČistú Stripe faktúru do výdavkového dokladu

arrow_forwardUpgrady/downgrady plánov bez kontaktovania nás

REST API

check_circleFunguje (stabilné)workspace_premiumProfessional, Enterprise

JSON cez HTTP, scopovaný na váš účet. Použite, keď MCP nie je vhodný (server-to-server skripty, dashboardy, nemcp nástroje).

Autentifikácia

checkMCPTASK_TOKEN ako Bearer hlavička (rovnaký token ako pri MCP)

checkPodpisová hlavička per-request (X-MCPTASK-Signature) pre vyššiu bezpečnosť

Endpointy

Všetky endpointy sú scopované na kód vášho účtu (krátky kód z URL mcptask.online). Skutočné cesty používajú /pieces (všeobecný termín) namiesto /tasks — "piece" je u nás zastrešujúce slovo pre task, story, epic, recurent.

Projekty

codeGET /api/v1/{account_code}/projects - Vypísať projekty

codeGET /api/v1/{account_code}/projects/{id} - Načítať projekt

codePOST /api/v1/{account_code}/projects - Vytvoriť projekt

codePUT /api/v1/{account_code}/projects/{id} - Aktualizovať projekt

Pieces (úlohy, stories, epicy, recurenty)

codeGET /api/v1/{account_code}/pieces - Vypísať pieces

codeGET /api/v1/{account_code}/pieces/{id} - Načítať piece

codePOST /api/v1/{account_code}/pieces - Vytvoriť piece

codePUT /api/v1/{account_code}/pieces/{id} - Aktualizovať piece

Efforty

codeGET /api/v1/{account_code}/pieces/{id}/efforts - Vypísať efforty

codePOST /api/v1/{account_code}/pieces/{id}/efforts - Zalogovať effort

Používatelia

codeGET /api/v1/{account_code}/users - Vypísať používateľov

codeGET /api/v1/user - Aktuálny používateľ

Limity

Rovnaký obal ako MCP server:

Starter

1 000/hod

Professional

10 000/hod

Enterprise

Individuálne

Dokumentácia

descriptionReferenčný popis endpointov na /api/docs (renderovaný OpenAPI)

descriptionPríklady v curl, Ruby a JavaScripte

descriptionŽivý "try it" panel, ktorý volá váš účet vaším tokenom

Odchádzajúce webhooky (plánované)

hourglass_emptyČoskoro

Odchádzajúce webhooky (plánované)

workspace_premiumProfessional, Enterprise (plánované)

Odchádzajúce webhooky (mcptask.online → vaše systémy) sú v roadmap. Dnes neexistujú — hlasujte za ne v sekcii Roadmap nižšie, aby ste nám pomohli s prioritizáciou.

Evty plánované pre v1

Toto je tvar, s ktorým počítame. Nič z toho dnes nefunguje.

hourglass_emptypiece.created

hourglass_emptypiece.updated

hourglass_emptypiece.completed

hourglass_emptyeffort.logged

hourglass_emptycomment.added

hourglass_emptysprint.started

hourglass_emptysprint.completed

Použitia, s ktorými počítame

checkSlack/Teams notifikácie

checkSpúšťanie CI/CD pipeline na prechodoch piece

checkUpdate externých dashboardov

checkCustom automatizácia v Zapier / n8n / Make

Ako to bude fungovať (plán)

1Pridať webhook URL v Nastavenia → Integrácie → Odchádzajúce webhooky
2Vybrať typy eventov, ktoré sa majú posielať
3Nastaviť secret pre HMAC podpis
4Poslať testovací event z UI
5Pri non-2xx odpovedi retryujeme s exponenciálnym backoffom

info

Potrebujete to dnes?

Najrýchlejšia cesta, ako dnes reagovať na eventy v mcptask.online, je čítať ich cez MCP alebo REST API z malého skriptu. Alebo nastavte odchádzajúci webhook z vášho GitHub/GitLab repozitára (ak sa trigger deje tam) — tie už fungujú.

Požadované integrácie (Roadmap)

Veci, ktoré zvažujeme. Ak je niečo dôležité pre vás, napíšte nám — prioritizujeme podľa reálneho dopytu.

chat

Komunikácia

thumb_up

Slack — notifikácie a slash commandy

thumb_up

Microsoft Teams — rovnaký tvar ako Slack

thumb_up

Discord — pre tímy na Discorde

calendar_month

Kalendár

thumb_up

Google Calendar — sync termínov

thumb_up

Outlook — Microsoft ekosystém

design_services

Design

thumb_up

Figma — previazať dizajny s pieces

cloud_upload

Cloudové úložisko

thumb_up

Google Drive — prikladať súbory z Disku

thumb_up

Dropbox — file integrácia

Chcete integráciu? Napíšte nám s use case. Ďalšiu várku integrácií vyberáme z reálneho dopytu, nie z hlasovaní.

Porovnanie integrácií podľa plánu

Integration	Starter	Professional	Enterprise
MCP Server	check_circle	check_circle	✓ (dedicated)
GitHub (inbound webhook)	check_circle	check_circle	check_circle
GitLab (inbound webhook)	check_circle	check_circle	check_circle
Fakturoid	check_circle	check_circle	check_circle
iDoklad	check_circle	check_circle	check_circle
Stripe (fakturácia mcptask.online)	check_circle	check_circle	check_circle
Jira import	—	Beta	Beta
Trello import	—	Beta	Beta
REST API	—	check_circle	check_circle
Odchádzajúce webhooky	—	Plánované	Plánované
Vlastné integrácie	—	—	check_circle

Prepojte svoj workflow ešte dnes

arrow_forward

Spustiť skúšobnú prevádzkuMCP server a Git integrácie v cene

descriptionAPI dokumentácia

Need custom integration or migration assistance?

support_agentPopytať vlastnú integráciu

Prepojte celý svoj workflow

MCP Server: rodný jazyk AI

Rýchly slovníček

Čo je MCP?

Čo cez MCP zvládnete

Čítanie:

Zápis:

Dotazy:

Nastavenie za 2 minúty

1. Získajte MCPTASK_TOKEN

2. Exportujte ho v shelli

3. Vložte toto do .mcp.json (Claude Code) alebo do MCP dialógu vášho klienta

4. Kde je ten súbor?

5. Reštartujte AI klienta

Dostupné MCP nástroje

Autentifikácia

MCPTASK_TOKEN (Bearer):

Oprávnenia:

Limity

Verzovacie systémy (inbound webhooky)

GitHub integrácia

Funkcie

Ako to funguje

Odkiaľ sa berú referencie #Task-47?

Integrácia pull requestov

Možnosti konfigurácie

GitLab integrácia

Funkcie

Self-hosted setup

Bezpečnosť

Import z projekťáku

Jira import

Čo sa importuje

Čo sa neimportuje

Postup

Trello import

Čo sa importuje

Mapovanie

Postup

EasyRedmine import

Podpora migrácie v Enterprise

Fakturácia

Fakturoid (CZ)

Funkcie

Postup

iDoklad (CZ)

Funkcie

Postup

Stripe (vlastná fakturácia mcptask.online)

Čo tu Stripe robí

Toto je pre…

REST API

REST API

Autentifikácia

Endpointy

Projekty

Pieces (úlohy, stories, epicy, recurenty)

Efforty

Používatelia

Limity

Dokumentácia

Odchádzajúce webhooky (plánované)

Odchádzajúce webhooky (plánované)

Evty plánované pre v1

Použitia, s ktorými počítame

Ako to bude fungovať (plán)

Požadované integrácie (Roadmap)

Komunikácia

Kalendár

Design

Cloudové úložisko

Porovnanie integrácií podľa plánu

Prepojte svoj workflow ešte dnes