Integrace s GitHubem, Jirou a fakturací — končí fakturou, ne zavřeným ticketem.

Funkce

Jak to funguje

1. 1Zkopírujte si tajný token účtu z mcptask.online (Účet → Integrace).
2. 2V GitHub repozitáři přidejte webhook s Payload URL https://mcptask.online/github/efforts, vyberte Just the push event a vložte tajný token.
3. 3Přidejte druhý webhook s Payload URL https://mcptask.online/github/pulls, vyberte Let me select individual events → Pull requests a vložte stejný token.
4. 4Do commit zpráv přidejte řádek https://mcptask.online/ACCOUNT/tasks/ID NN%, kde NN je procento pokroku.
5. 5Do popisu pull requestu přidejte řádek mcptask: https://mcptask.online/ACCOUNT/tasks/ID.
6. 6Při mergi se zmíněný úkol schválí a poslední effort se nastaví na 100 %.

Jak odkazovat na úkol

Použijte veřejnou URL úkolu https://mcptask.online/ACCOUNT/tasks/ID. ACCOUNT je kód vašeho účtu a ID je relativní ID úkolu, které najdete na stránce úkolu a v URL.

 https://mcptask.online/ACCOUNT/tasks/47 40%https://mcptask.online/ACCOUNT/tasks/48 100%mcptask: https://mcptask.online/ACCOUNT/tasks/47 

Integrace pull requestů

• mergeOtevřený PR → k úkolu se přidá poznámka s odkazem na PR
• mergeMergnutý PR → úkol se schválí a přidá se poznámka o dokončení
• mergePoslední effort se při mergi nastaví na 100 %
• mergeFunguje s libovolným veřejným i privátním repozitářem, který dosáhne mcptask.online

Možnosti konfigurace

Funkce

Jak to funguje

1. 1Zkopírujte secret token účtu z mcptask.online (Account → Integrations).
2. 2V GitLab projektu přidejte webhook s URL https://mcptask.online/gitlab/efforts, trigger Push events a secret token vložte do pole Secret token.
3. 3Přidejte druhý webhook s URL https://mcptask.online/gitlab/merge_requests, trigger Merge request events, se stejným secret tokenem.
4. 4V commit zprávách přidejte řádek https://mcptask.online/ACCOUNT/tasks/ID NN%, kde NN je procento postupu.
5. 5V popisu merge requestu přidejte řádek mcptask: https://mcptask.online/ACCOUNT/tasks/ID.
6. 6Když se MR mergne, odkazovaný piece se schválí a poslední effort se nastaví na 100 %.

Jak odkazovat na piece

Použijte veřejné URL piece https://mcptask.online/ACCOUNT/tasks/ID. ACCOUNT je kód vašeho účtu a ID je relative ID piece zobrazené na stránce piece a v URL.

 https://mcptask.online/ACCOUNT/tasks/47 40%https://mcptask.online/ACCOUNT/tasks/48 100%mcptask: https://mcptask.online/ACCOUNT/tasks/47 

Integrace Merge Requestů

• mergeMR otevřen → na piece se přidá poznámka s odkazem na MR
• mergeMR mergnutý → piece se schválí a přidá se dokončovací poznámka
• mergePostup posledního effortu se při mergnutí nastaví na 100 %
• mergeFunguje s GitLab.com i self-hosted GitLab (12.0+), který se dostane na mcptask.online

Konfigurace

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

Autentizace

Jeden údaj, jedna hlavička. Stejný MCPTASK_TOKEN, který používáte pro MCP server, autentizuje každé volání REST API jako Bearer token.

Authorization: Bearer <MCPTASK_TOKEN>

Token získáte v mcptask.online → Zobrazit uživatele → Rozšířené informace → API Token. JWT kódovaný, podepsaný HS256, scopovaný na vašeho uživatele — žádný zvláštní API klíč, žádná periodická rotace.

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.

Limity

Vynucují se per účet i per token: 60 požadavků/minutu na token plus hodinový limit účtu uvedený níže, sdílený MCP serverem i REST API. Ozvěte se, pokud potřebujete vyšší strop.

Samotné REST API je funkce plánů Professional a Enterprise — limit Starteru platí pro MCP server.

Dokumentace

Reálné příkazy, které můžete rovnou zkopírovat do terminálu. $MCPTASK_TOKEN nahraďte tokenem z mcptask.online → Zobrazit uživatele → Rozšířené informace → API Token a $ACCOUNT kódem vašeho účtu.

curl https://mcptask.online/api

{ "message": "mcptask.online REST API v0.10", "version": "0.10", "version_app": "5.72", "revision": "1272" }

curl https://mcptask.online/api/$ACCOUNT/users/current \
  -H "Authorization: Bearer $MCPTASK_TOKEN"

{ "id": 7, "user_nick": "george", "email": "george@example.com", "default_account_code": "bcp" }

curl https://mcptask.online/api/$ACCOUNT/projects \
  -H "Authorization: Bearer $MCPTASK_TOKEN"

[ { "id": 1, "code": "bcp", "name": "BCP Development" } ]

curl -X POST https://mcptask.online/api/$ACCOUNT/pieces \
  -H "Authorization: Bearer $MCPTASK_TOKEN" \
  -H "Content-Type: application/json" \
  -d ''{"piece_type":"Task","name":"Review PR","project_id":1}''

{ "id": 42, "name": "Review PR", "piece_type": "Task", "state": "new" }