settings_input_componentIntegrations

Propojte celý svůj workflow

MCP server pro AI asistenty. 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 — standardizovaný způsob, jakým AI asistenti komunikují s externími nástroji. Žádný middleware, žádné scrapování, žádné vlastní API. Nativní integrace.

Rychlý slovníček

Pár pojmů používaných na této stránce — lidsky.

MCP

Model Context Protocol — standardizovaný protokol, kterým si AI asistenti (Claude, Cursor, Cline, …) volají externí nástroje. mcptask.online mluví MCP nativně, takže ho může ovládat libovolný MCP klient.

SSE

Server-Sent Events — HTTP transport, který MCP používá pro streamování volání nástrojů. Váš AI klient otevře dlouho běžící spojení na naši URL /mcp/sse.

Webhook

HTTP volání, které jedna aplikace provede druhé, když se něco stane. Inbound = někdo volá mcptask.online (např. GitHub při pushi). Outbound = mcptask.online volá váš systém (plánováno, zatím není).

MCPTASK_TOKEN

Dlouhý náhodný řetězec, kterým mcptask.online ověří, že požadavek opravdu přichází od vás. Vygenerujte si ho v Nastavení → API Access a používejte ho jako Bearer token. Berte ho jako heslo.

Co je MCP?

MCP (Model Context Protocol) je standardní protokol, který AI asistenti jako Claude používají k volání externích nástrojů a čtení externích dat. Místo ručního HTTP nebo parsování HTML AI mluví MCP nativně a my servírujeme definice nástrojů.

check_circleAI okamžitě rozumí struktuře dat

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

check_circleSpolehlivý, verzovaný protokol

check_circleStejné rozhraní pro všechny MCP klienty

Co přes MCP zvládnete

Čtení:

visibilityVypsat projekty a pieces (úkoly/stories/epicy)
visibilityNačíst detail piece (popis, stav, historie)
visibilityZobrazit vazby rodič/potomek
visibilityČíst komentáře a přílohy
visibilityČíst záznamy effortů

Zápis:

editZměnit stav piece
editZalogovat effort
editPřidat komentář
editPřiložit soubor
editVytvořit piece a sub-piece

Dotazy:

searchZískat další dostupný piece (seřazený podle priority)
searchFiltrovat pieces podle projektu, stavu, typu
searchVyhledávat v popisech
searchVypsat poslední aktivitu

Nastavení za 2 minuty

Jednorázově. Pak každý MCP klient, který připojíte (Claude Code, Claude Desktop, Cursor, Cline, …), umí mluvit s mcptask.online.

1. Získejte MCPTASK_TOKEN
Přihlaste se do mcptask.online → Nastavení → API Access → Generate token. Zkopírujte dlouhý řetězec.
2. Exportujte ho v shellu
Vložte do terminálu (nebo přidejte do ~/.zshrc / ~/.bashrc, aby přežil restart):
```
 export MCPTASK_TOKEN=mcptask_xxxxxxxxxxxxxxxxxxxxxxxxxxxx 
```

3. Vložte toto do .mcp.json (Claude Code) nebo do MCP dialogu vašeho klienta

Kanonní .mcp.json (Claude Code):

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

4. Kde ten soubor je?
Claude Code čte .mcp.json z kořene projektu (nebo globálně z ~/.claude.json). Pro Claude Desktop / Cursor / Cline vložte stejný JSON do MCP konfiguračního dialogu klienta.
5. Restartujte AI klienta
Claude Code, Cursor aj. načítají MCP servery při startu. V seznamu nástrojů uvidíte server mcptask-online.

info

Ostatní MCP klienti

Standardní MCP přes SSE. Použijte stejnou URL (https://mcptask.online/mcp/sse) a stejnou hlavičku Authorization: Bearer jako výše.

downloadChcete raději jedním příkazem? Podívejte se na stránku /installation pro průvodce na macOS, Linuxu i obecně na libovolném systému.

Dostupné MCP nástroje

Těchto 12 nástrojů je reálně v MCP serveru mcptask.online dnes. AddMessageTool, AddAttachmentTool, CreatePieceTool, LogWorkProgressTool a všechny read nástroje fungují end-to-end.

Tool	Description
`create_piece`	Vytvořit nový piece (úkol, story, epic, recurent)
`get_piece`	Načíst jeden piece podle ID
`list_pieces`	Vypsat pieces s filtry (projekt, stav, typ)
`get_next_task`	Získat nejdůležitější dostupný úkol
`get_project_tree`	Získat hierarchii projektu (epicy/stories/úkoly)
`list_projects`	Vypsat projekty, ke kterým máte přístup
`get_project`	Načíst metadata jednoho projektu
`get_current_user`	Identifikovat uživatele za aktuálním tokenem
`log_work_progress`	Zalogovat effort na piece a posunout postup
`add_message`	Přidat komentář / zprávu k piece
`add_attachment`	Přiložit soubor k piece
`get_piece_efforts`	Načíst časové záznamy piece
`get_usage_guide`	Server sám popíše své schopnosti (capabilities a hinty k použití)

Autentizace

Jeden credential, jedna env proměnná. Žádná stránka s API klíči, žádná OAuth appka k registraci.

MCPTASK_TOKEN (Bearer):

vpn_keyVygenerujte v Nastavení → API Access v mcptask.online
vpn_keySvázaný s vaším uživatelským účtem, scopovaný na vaše workspaces
vpn_keyKdykoli zrušte nebo rotujte na stejné stránce
vpn_keyBerete ho jako heslo — kdokoli ho má, jedná jako vy

Oprávnění:

securityToken dědí oprávnění vašeho uživatele — dnes žádné další scope
securityRead-only vs. read-write řídí akce, které voláte
securityIzolace per-project se vynucuje na serveru
securityVšechna volání se logují pod vaším uživatelem

Limity

Plan	Requests/Hour
Starter	1 000 požadavků/hod
Professional	10 000 požadavků/hod
Enterprise	Individuálně

Tato čísla jsou realistická, ale zatím nejsou vynucovaná tvrdým limiterem — popisují cílové SLA. Ozvěte se, pokud narazíte na zeď.

Verzovací 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 integrace

check_circleFunguje (inbound webhook)schedule5 minut

Funkce

codeWebhookové zpracování eventů (push, pull request)

codeTělo PR se parsuje pro reference na piece (např. #Task-47)

codePR open/merge se přidá na piece jako komentář s odkazem

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

Jak to funguje

1Otevřete piece v mcptask.online a zkopírujte jeho webhook URL — každý piece má unikátní URL ve tvaru https://mcptask.online/github/efforts/<token>
2Přidejte tuto URL jako webhook v nastavení GitHub repozitáře (Settings → Webhooks)
3Vyberte eventy: Push, Pull request
4Webhook uložte (secret není potřeba)
5Referencujte piece v commitech a těle PR: např. "Fix login #Task-47 2h"
6mcptask.online webhook přijme, napojí PR a zaloguje čas

Odkud se berou reference #Task-47?

mcptask.online používá relativní ID piece (např. 47) jako referenční token #Task-47. Najdete ho na každé stránce piece a v URL — kanonní 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)

Integrace pull requestů

mergeTělo a název PR se parsuje pro reference (libovolné #Task-N, #Story-N, #Epic-N, #Recurent-N)
mergePR otevřen → na piece přibude komentář s odkazem na PR
mergePR mergnut → poslední otevřený effort se uzavře, komentář se aktualizuje
mergeStav PR je vidět na timeline piece

Možnosti konfigurace

settingsVíce repozitářů na projekt

settingsPodpora privátních repozitářů (libovolný GitHub repo, kam webhook dosáhne)

settingsVlastní vzory pro reference (výchozí: #Task-N, #Story-N, #Epic-N, #Recurent-N)

settingsAktualizace stavu podle branche

GitLab integrace

check_circleFunguje (inbound webhook)schedule5 minut

Funkce

codeStejné schopnosti jako GitHub (push, merge request)

codeFunguje s GitLab.com (SaaS)

codeFunguje se self-hosted GitLab (12.0+)

codePropojení merge requestů

Self-hosted setup

1Zkopírujte webhook URL z mcptask.online (stejný tvar jako GitHub: /gitlab/efforts/<token>)
2Přidejte URL jako webhook v GitLab projektu (Settings → Webhooks)
3Trigger: Push events, Merge request events
4Otestujte doručení z GitLab UI

Bezpečnost

securityOvěření podpisu webhooku

securityAutentizace tokenem (URL token per piece)

securityŽádný přístup ke zdrojovému kódu (jen metadata)

securityVyžadováno TLS šifrování

Import z projekťáku

Jira import

scienceBeta (import na požádání)workspace_premiumProfessional, Enterprise

Co se importuje

checkHierarchie issue (Epic > Story > Task > Subtask)

checkPopisy a základní akceptační kritéria

checkKomentáře a diskuze

checkPřílohy

checkČasové záznamy (worklogy)

Co se neimportuje

removeJira workflows (mcptask.online používá jednodušší stavy)

removeJira pluginy/extenze

removeAdmin nastavení a schémata oprávnění

removeHistorie sprintů (mapujeme jen aktuální stav)

removeUI pro mapování custom fields (děláme best-effort pasivně)

Postup

1Kontaktujte nás s URL Jiry a read-only API tokenem
2Import pustíme společně (background job, manuální start)
3Schválíte mapování polí
4Pokud něco nesedí, pustíme znovu

scheduleTypicky: záleží na velikosti projektu — obvykle půl dne s naší pomocí

Trello import

scienceBeta (import na požádání)workspace_premiumProfessional, Enterprise

Co se importuje

checkBoardy → projekty

checkSeznamy → epicy nebo stavy (konfigurovatelné)

checkKarty → úkoly

checkChecklisty → sub-úkoly

checkPřílohy

checkKomentáře

checkŠtítky → tagy

checkTermíny

Mapování

arrow_forward

HierarchickéSeznamy se stanou epicy obsahujícími úkoly

arrow_forward

PlochéSeznamy se stanou stavy úkolů

arrow_forward

VlastníDefinujte si vlastní mapování

Postup

1Autorizujte Trello přístup v Nastavení → Integrace
2Společně vybereme boardy a styl mapování
3Spustíme import
4Zkontrolujete a doupravíte

scheduleTypicky: 10-30 minut s naší pomocí

EasyRedmine import

support_agentNa požádánídiamondEnterprise

Kontaktujte nás pro pomoc s migrací z EasyRedmine.

Podpora migrace v Enterprise

Náš tým vám pomůže přestěhovat se z EasyRedmine s minimálním výpadkem.

mailKontaktovat obchod

Fakturace

Fakturoid (CZ)

check_circleFungujeverifiedVšechny plány

Funkce

checkOAuth 2.0 autentizace

checkExport schválených effortů → faktury

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

checkMapování klientů (Fakturoid kontakt ↔ mcptask.online společnost)

checkSledování plateb

Postup

1Schvalte efforty v mcptask.online
2Klikněte na "Export do Fakturoidu"
3Faktura se vytvoří ve Fakturoidu
4Zkontrolujte a odešlete z Fakturoidu
5Označte jako vyfakturováno v mcptask.online

scheduleSetup: 5 minut

iDoklad (CZ)

check_circleFungujeverifiedVšechny plány

Funkce

checkOAuth 2.0 autentizace

checkGenerování faktur

checkDPH shoda (CZ)

checkPodpora více měn

checkPárování bankovních výpisů (dnes manuální; plný sync je v roadmapě)

Postup

Stejný tvar jako Fakturoid — vyberte efforty, exportujte, fakturujte. Bankovní sync iDokladu je u nás dnes read-only; plná rekonciliace je plánovaná.

Stripe (vlastní fakturace mcptask.online)

check_circleFungujecredit_cardVšechny plány

info

Pozor: Stripe tady pohání vlastní předplatné mcptask.online (per-seat Starter/Professional/Enterprise). Není to způsob, jak přes mcptask.online fakturovat svým klientům. K fakturaci klientů použijte Fakturoid nebo iDoklad výše.

Co tady Stripe dělá

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

checkPer-seat předplatné, prorated při přidání/odebrání

checkOšetření neúspěšných plateb (e-mail + retry, pak downgrade)

checkPDF faktury ze Stripe pro vaše účetnictví

checkVíce měn pro mezinárodní karty

Toto je pro…

arrow_forwardPlatbu mcptask.online za místa ve vašem týmu

arrow_forwardČistou Stripe fakturu do výdajového dokladu

arrow_forwardUpgrady/downgrady plánů bez kontaktování nás

REST API

check_circleFunguje (stabilní)workspace_premiumProfessional, Enterprise

JSON přes HTTP, scopovaný na váš účet. Použijte, když MCP není vhodný (server-to-server skripty, dashboardy, nemcp nástroje).

Autentizace

checkMCPTASK_TOKEN jako Bearer hlavička (stejný token jako u MCP)

checkPodpisová hlavička per-request (X-MCPTASK-Signature) pro vyšší bezpečnost

Endpointy

Všechny endpointy jsou scopované na kód vašeho účtu (krátký kód z URL mcptask.online). Skutečné cesty používají /pieces (obecný termín) místo /tasks — "piece" je u nás zastřešující slovo pro task, story, epic, recurent.

Projekty

codeGET /api/v1/{account_code}/projects - Vypsat projekty

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

codePOST /api/v1/{account_code}/projects - Vytvořit projekt

codePUT /api/v1/{account_code}/projects/{id} - Aktualizovat projekt

Pieces (úkoly, stories, epicy, recurenty)

codeGET /api/v1/{account_code}/pieces - Vypsat pieces

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

codePOST /api/v1/{account_code}/pieces - Vytvořit piece

codePUT /api/v1/{account_code}/pieces/{id} - Aktualizovat piece

Efforty

codeGET /api/v1/{account_code}/pieces/{id}/efforts - Vypsat efforty

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

Uživatelé

codeGET /api/v1/{account_code}/users - Vypsat uživatele

codeGET /api/v1/user - Aktuální uživatel

Limity

Stejný obal jako MCP server:

Starter

1 000/hod

Professional

10 000/hod

Enterprise

Individuálně

Dokumentace

descriptionReferenční popis endpointů na /api/docs (renderovaný OpenAPI)

descriptionPříklady v curl, Ruby a JavaScriptu

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

Odchozí webhooky (plánováno)

hourglass_emptyJiž brzy

Odchozí webhooky (plánováno)

workspace_premiumProfessional, Enterprise (plánováno)

Odchozí webhooky (mcptask.online → vaše systémy) jsou v roadmapě. Dnes neexistují — hlasujte pro ně v sekci Roadmap níže, abyste nám pomohli s prioritizací.

Eventy plánované pro v1

Toto je tvar, se kterým počítáme. Nic 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žití, se kterými počítáme

checkSlack/Teams notifikace

checkSpouštění CI/CD pipeline na přechodech piece

checkUpdate externích dashboardů

checkCustom automatizace v Zapier / n8n / Make

Jak to bude fungovat (plán)

1Přidat webhook URL v Nastavení → Integrace → Odchozí webhooky
2Vybrat typy eventů, které se mají posílat
3Nastavit secret pro HMAC podpis
4Poslat testovací event z UI
5Při non-2xx odpovědi retryujeme s exponenciálním backoffem

info

Potřebujete to dnes?

Nejrychlejší cesta, jak dnes reagovat na eventy v mcptask.online, je číst je přes MCP nebo REST API z malého skriptu. Nebo nastavte odchozí webhook z vašeho GitHub/GitLab repozitáře (pokud se trigger děje tam) — ty už fungují.

Požadované integrace (Roadmap)

Věci, které zvažujeme. Pokud je něco důležité pro vás, napište nám — prioritizujeme podle reálné poptávky.

chat

Komunikace

thumb_up

Slack — notifikace a slash commandy

thumb_up

Microsoft Teams — stejný tvar jako Slack

thumb_up

Discord — pro týmy na Discordu

calendar_month

Kalendář

thumb_up

Google Calendar — sync termínů

thumb_up

Outlook — Microsoft ekosystém

design_services

Design

thumb_up

Figma — provázat designy s pieces

cloud_upload

Cloudové úložiště

thumb_up

Google Drive — přikládat soubory z Disku

thumb_up

Dropbox — file integrace

Chcete integraci? Napište nám s use case. Další várku integrací vybíráme z reálné poptávky, ne z hlasování.

Srovnání integrací podle 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 (fakturace mcptask.online)	check_circle	check_circle	check_circle
Jira import	—	Beta	Beta
Trello import	—	Beta	Beta
REST API	—	check_circle	check_circle
Odchozí webhooky	—	Plánováno	Plánováno
Vlastní integrace	—	—	check_circle

Propojte svůj workflow ještě dnes

arrow_forward

Zahájit zkušební provozMCP server a Git integrace v ceně

descriptionAPI dokumentace

Need custom integration or migration assistance?

support_agentPoptat vlastní integraci

Propojte celý svůj workflow

MCP Server: rodný jazyk AI

Rychlý slovníček

Co je MCP?

Co přes MCP zvládnete

Čtení:

Zápis:

Dotazy:

Nastavení za 2 minuty

1. Získejte MCPTASK_TOKEN

2. Exportujte ho v shellu

3. Vložte toto do .mcp.json (Claude Code) nebo do MCP dialogu vašeho klienta

4. Kde ten soubor je?

5. Restartujte AI klienta

Dostupné MCP nástroje

Autentizace

MCPTASK_TOKEN (Bearer):

Oprávnění:

Limity

Verzovací systémy (inbound webhooky)

GitHub integrace

Funkce

Jak to funguje

Odkud se berou reference #Task-47?

Integrace pull requestů

Možnosti konfigurace

GitLab integrace

Funkce

Self-hosted setup

Bezpečnost

Import z projekťáku

Jira import

Co se importuje

Co se neimportuje

Postup

Trello import

Co se importuje

Mapování

Postup

EasyRedmine import

Podpora migrace v Enterprise

Fakturace

Fakturoid (CZ)

Funkce

Postup

iDoklad (CZ)

Funkce

Postup

Stripe (vlastní fakturace mcptask.online)

Co tady Stripe dělá

Toto je pro…

REST API

REST API

Autentizace

Endpointy

Projekty

Pieces (úkoly, stories, epicy, recurenty)

Efforty

Uživatelé

Limity

Dokumentace

Odchozí webhooky (plánováno)

Odchozí webhooky (plánováno)

Eventy plánované pro v1

Použití, se kterými počítáme

Jak to bude fungovat (plán)

Požadované integrace (Roadmap)

Komunikace

Kalendář

Design

Cloudové úložiště

Srovnání integrací podle plánu

Propojte svůj workflow ještě dnes