Integrace pro vývojáře: MCP a REST API

Funkce

Jak to funguje

1. 1Zkopírujte si tajný token účtu z mcptask.online (Nastavení účtu → Integrace → Tajný token).
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
• mergeSloučený 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 si tajný token účtu z mcptask.online (Nastavení účtu → Integrace → Tajný token).
2. 2V GitLab projektu přidejte webhook s URL https://mcptask.online/gitlab/efforts, trigger Push events a tajný 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 tajným 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 sloučí, 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ů

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

Konfigurace

JSON přes HTTP, omezený 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, omezený na vašeho uživatele — žádný zvláštní API klíč, žádná periodická rotace.

Endpointy

Všechny endpointy jsou omezené 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 na MCP serveru (/mcp): 60 požadavků/minutu na token plus hodinový limit účtu uvedený níže, daný tarifem (zkušební období má limit Professional). Volání REST API se do těchto limitů nepočítají. Ozvěte se, pokud potřebujete vyšší strop.

Samotné REST API je k dispozici ve všech tarifech.

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" }