MCP prístup (AI agenti)

Čo sa nedávno zmenilo

MCP je teraz plne dostupný aj na iPhone (popri webovej aplikácii). Obrazovka iPhone zrkadlí webovú a obsahuje rovnaké setup snippety pre všetky podporované AI klienty.

Plán Pro a vyšší

MCP prístup vyžaduje plán Pro alebo Ultra. Oba plány majú plný prístup read + write (27 nástrojov) a môžu prepnúť do read-only režimu, ak chceš.

MCP (Model Context Protocol) ti umožňuje pripojiť AI coding asistentov a automatizačné nástroje priamo k tvojim TellDone dátam. Po pripojení môže tvoj AI agent čítať tvoje poznámky, úlohy, udalosti, reporty, tagy a históriu zmien - a vytvárať, aktualizovať, mazať a obnovovať položky. Celkovo je 27 nástrojov: 10 na čítanie dát a 17 na zápis.

K dispozícii v iPhone aplikácii (Nastavenia → Integrácie → AI Agents) aj vo webovej aplikácii (Nastavenia → AI Agents).

Dva spôsoby pripojenia

AI klienta môžeš autentifikovať dvoma spôsobmi a oba sú plne podporované:

1. OAuth 2.1 (odporúčané) - štandardný súhlasový flow "Prihlásiť sa cez TellDone". Takto to funguje v konektorovom UI Claude Desktop a na Claude.ai. Žiadne kopírovanie tokenov - prihlásiš sa svojím TellDone účtom a schváliš oprávnenia, ktoré klient žiada.
2. Bearer token - skopíruj svoj osobný prístupový token z Nastavení a vlož ho do konfigurácie svojho klienta. Najjednoduchšie pre skripty, CLI nástroje a klientov bez vstavaného OAuth flow.

Klient	Odporúčané
Claude Desktop / Cowork	OAuth - pridaj vlastný konektor s MCP URL a potom sa prihlás
Claude Code (CLI)	Ktorékoľvek - claude mcp add ťa prevedie OAuth prihlásením v prehliadači, alebo pridaj hlavičku Bearer pre tokenovú metódu
Skripty alebo tvoj vlastný kód	Bearer token - najjednoduchšie na automatizáciu
Klient, ktorý umožňuje vyberať iba z adresára uvedených konektorov	Zatiaľ použi bearer token alebo mcp-remote most - TellDone zatiaľ nie je v žiadnom adresári konektorov

Požiadavky podľa plánu

Plán	MCP
Free	Zamknuté
Basic	Zamknuté
Pro	Read + Write (27 nástrojov) - môže prepnúť do Read-only režimu
Ultra	Read + Write (27 nástrojov) - môže prepnúť do Read-only režimu

Obrazovka v aplikácii

Obrazovka AI Agents má tri stavy podľa tvojho plánu a podľa toho, či je MCP zapnutý.

Zamknuté (Free a Basic)

Ak si v pláne Free alebo Basic, obrazovka vysvetľuje, čo MCP robí, a zobrazuje tlačidlo Upgrade. Klepnutím sa otvorí paywall, kde môžeš prejsť na Pro alebo Ultra.

Vypnuté (Pro a Ultra, funkcia vypnutá)

Ak si v Pro alebo Ultra, ale MCP si ešte nezapol, obrazovka zobrazuje krátke zhrnutie toho, čo tvoj plán dokáže (počet nástrojov, režim prístupu, kvóty), a tlačidlo Zapnúť. Klepnutím vygeneruješ pripojovací token a spustíš integráciu.

Zapnuté

Po zapnutí obrazovka zobrazuje všetko, čo potrebuješ na pripojenie AI klienta:

• Prepínač režimu - na Ultra môžeš prepínať medzi Read-only a Read + Write. Na Pro je režim fixne Read + Write.
• Riadok Access Token s prepínačom oka na zobrazenie alebo skrytie tokenu a tlačidlom kopírovať.
• Setup picker s kartami pre Claude Code, Cursor, Windsurf a Iné. Príslušný code snippet sa zobrazuje pod kartami - stačí skopírovať a vložiť do AI klienta.
• Tlačidlo Regenerovať - okamžite rotuje token a odpojí všetky aktívne relácie používajúce starý.
• Tlačidlo Vypnúť - vypne MCP a zmaže token. Môžeš ho znova zapnúť neskôr, ale vydá sa nový token.

tip

Drž svoj pripojovací token v tajnosti. Ktokoľvek s tokenom má prístup k tvojim TellDone dátam. Ak máš podozrenie, že token unikol, použi Regenerovať.

Ako zapnúť

MCP môžeš nakonfigurovať z ktorejkoľvek platformy:

• iPhone: Nastavenia → Integrácie → AI Agents (MCP)
• Web: app.telldone.app → Nastavenia → AI Agents

Kroky:

1. Klepni na Zapnúť.
2. Vyber svoj režim prístupu (iba Ultra - Pro je vždy Read + Write).
3. Zobraz a skopíruj svoj token pomocou ikony oka a kopírovania.
4. Vyber svoj nástroj v sekcii Setup (Claude Code, Cursor, Windsurf alebo Iné).
5. Vlož snippet do konfigurácie svojho AI klienta.

Pripojenie cez OAuth

OAuth je odporúčaná cesta pre Claude Desktop, Claude.ai, Cowork a Claude Code - prihlásiš sa svojím TellDone účtom namiesto toho, aby si niekam kopíroval token.

MCP URL pre OAuth: https://api.telldone.app/mcp/user (bez /mcp na konci - to je iná URL, používa sa iba pri bearer tokene nižšie)

Claude Desktop / Cowork

1. V klientovi zvoľ Add custom connector.
2. Zadaj URL servera: https://api.telldone.app/mcp/user
3. Klient otvorí súhlasovú stránku TellDone v tvojom prehliadači. Uvidíš, ktorá aplikácia žiada o prístup, aké presne oprávnenia chce, a prihlasovací formulár.
4. Prihlás sa e-mailom a heslom svojho TellDone účtu a klikni na Allow.
5. Klient automaticky dostane prístupový token a pripojí sa - žiadne kopírovanie tokenov.

poznámka

Prihlásenie na súhlasovej stránke používa e-mail a heslo tvojho TellDone účtu. Ak má tvoj účet iba Apple alebo Google Sign In (bez nastaveného hesla), použi zatiaľ metódu s bearer tokenom nižšie.

Claude Code

OAuth (otvorí prihlásenie v prehliadači):

claude mcp add --transport http telldone https://api.telldone.app/mcp/user

Claude Code objaví OAuth flow automaticky, ale pri prvom volaní ťa neprihlási - spusti /mcp priamo v Claude Code a zvoľ Authenticate, čím sa otvorí prihlásenie v prehliadači. Potom ti prístupový token obnovuje sám - nemusíš nič udržiavať.

Bearer token (bez prehliadača, vhodné pre headless nastavenia):

claude mcp add telldone --transport http \
  https://api.telldone.app/mcp/user/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Svoj YOUR_TOKEN získaš v aplikácii: Nastavenia → Integrácie → AI Agents → Skopírovať token (pozri Ako zapnúť vyššie).

Pripojenie cez bearer token

Pre klientov bez vstavanej podpory OAuth - Cursor, Windsurf a ďalších - vlož svoj osobný prístupový token priamo do konfigurácie klienta. Vo všetkých príkladoch nižšie nahraď YOUR_TOKEN tokenom z tvojich nastavení.

Cursor

Pridaj do .cursor/mcp.json:

{
  "mcpServers": {
    "telldone": {
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Windsurf

Pridaj do .codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "telldone": {
      "serverUrl": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Iné

Tieto snippety použi pre klienty, ktoré in-app picker zoskupuje pod Iné.

Codex

Pridaj do codex.json:

{
  "mcpServers": {
    "telldone": {
      "type": "http",
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

OpenClaw

Settings > MCP Servers > Add:

• Name: TellDone
• URL: https://api.telldone.app/mcp/user/mcp
• Auth: Bearer YOUR_TOKEN

Iní MCP klienti

Akýkoľvek nástroj, ktorý podporuje MCP cez HTTP, sa môže pripojiť. Použi endpoint https://api.telldone.app/mcp/user/mcp s autorizačnou hlavičkou Bearer YOUR_TOKEN.

Alternatívna auth hlavička

Ak si tvoj klient alebo proxy rezervuje hlavičku Authorization (napríklad niektoré Smithery-style gateways), pošli token namiesto toho v X-MCP-Token: YOUR_TOKEN. Obe hlavičky fungujú; ak sú prítomné obe, vyhráva Authorization.

Otestovanie pripojenia

Token si môžeš overiť jednoduchým cURL príkazom:

curl -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Úspešná odpoveď vypíše všetky dostupné nástroje.

Oprávnenia (scopes)

OAuth pripojenia majú rozsahy - počas prihlásenia presne vidíš, o čo klient žiada, a výslovne to schváliš.

Scope	Umožňuje aplikácii...
notes:read	Čítať tvoje poznámky, vyhľadávať, otvárať plné detaily poznámky
notes:write	Vytvárať, upravovať a mazať poznámky (a spúšťať pipeline hlasových poznámok)
tasks:read / tasks:write	Čítať / vytvárať, upravovať, dokončovať a mazať úlohy
events:read / events:write	Čítať / vytvárať, upravovať a mazať udalosti
reports:read	Čítať tvoje denné, týždenné, mesačné a ročné reporty
tags:read / tags:write	Vypísať tvoje tagy / vytvárať a premenovávať tagy
profile:read	Čítať info o tvojom profile a predplatnom
offline_access	Zostať pripojený, aj keď si preč (vydá refresh token, takže sa nemusíš prihlasovať v každej relácii)

Scopes sú strop, nie záruka - pripojenie iba s notes:read nemôže zavolať write nástroj, nech ho o to požiadaš akokoľvek. Tvoj plán je druhá brána nad rámec scopes.

Pripojenia cez bearer token nemajú individuálne scopes - riadi ich iba read/write režim tvojho plánu.

Čo môžeš robiť

Read nástroje (10) - Pro a Ultra

Nástroj	Čo robí
get_notes	Vypíše poznámky s filtrami (tagy, dátumový rozsah, textové vyhľadávanie)
get_note	Zobrazí jednu poznámku s jej podradenými úlohami, udalosťami a plným prepisom
get_notes_full	Získa viacero poznámok s vloženými úlohami a udalosťami v jednom volaní
get_tasks	Vypíše úlohy filtrované podľa stavu (to-do, done, all), tagov alebo dátumov
get_events	Vypíše kalendárové udalosti, filtruje podľa dátumového rozsahu
get_reports	Číta tvoje denné, týždenné, mesačné a ročné reporty (plný markdown)
get_tags	Zobrazí všetky tvoje tagy zoradené podľa použitia
get_profile	Pozri si info účtu a štatistiky spotreby
search	Hľadaj naprieč poznámkami, úlohami a udalosťami (text + sémantické hľadanie pre poznámky)
get_change_log	Zobrazí históriu úprav poznámky, úlohy alebo udalosti a či bola každá úprava vrátená

tip

Nástroj search podporuje sémantické hľadanie pre poznámky - nájde výsledky podľa významu, nielen podľa kľúčových slov. Napríklad hľadanie "schôdzky o rozpočte" nájde poznámky o finančných diskusiách, aj keď neobsahujú slovo "rozpočet".

Write nástroje (17) - Pro a Ultra

Nástroj	Čo robí
process_note	Plný AI pipeline - pošli text alebo audio, dostaneš späť poznámku s úlohami, udalosťami a tagmi
create_note	Pridá poznámku v plain texte (bez AI analýzy)
create_task	Pridá úlohu s prioritou, termínom, pripomienkou a tagmi
create_event	Pridá kalendárovú udalosť s dátumom, časom, miestom, pripomienkami, účastníkmi a opakovaním
update_note	Zmení názov poznámky, zhrnutie, typ, tagy, prioritu alebo stav
update_task	Zmení názov úlohy, popis, prioritu, termín, pripomienku, tagy alebo stav
complete_task	Označí úlohu ako hotovú
update_event	Zmení detaily udalosti, čas, miesto, pripomienky, účastníkov, opakovanie, tagy alebo stav
delete_note	Zmaže poznámku a všetky jej prepojené úlohy a udalosti
delete_task	Zmaže úlohu
delete_event	Zmaže udalosť
undo_change_log_entry	Vráti jednu sledovanú úpravu - urobenú AI alebo tebou - obnoví predchádzajúcu hodnotu poľa
restore_entity	Obnoví zmazanú alebo archivovanú poznámku, úlohu alebo udalosť
create_tag	Vytvorí nový tag alebo premení automaticky navrhnutý tag na trvalý
set_tag_pinned	Pripne alebo odopne tag, aby sa zoradil na vrch
delete_tag	Odstráni tag (možno ho obnoviť cez restore_tag)
restore_tag	Obnoví zmazaný tag

Všetky write a delete operácie sa okamžite prejavia na tvojich pripojených zariadeniach (telefón, webová aplikácia) cez real-time synchronizáciu.

Referencia nástrojov

get_notes

Vypíše poznámky s voliteľným filtrovaním. Filtre dátumu používajú recorded_at (kedy si nahral hlasovú poznámku), nie created_at.

Parameter	Typ	Default	Popis
limit	int	20	Počet poznámok na vrátenie (max 50)
offset	int	0	Preskoč toľko poznámok (pre stránkovanie, max 10000)
tags	string	-	Filtruj podľa tagov, oddelené čiarkami (zhoduje sa hociktorý)
search	string	-	Textové hľadanie v názve a zhrnutí
date_from	string	-	Začiatočný dátum, YYYY-MM-DD (vrátane)
date_to	string	-	Koncový dátum, YYYY-MM-DD (exclusive)
standalone_only	bool	false	Ak true, skryje nadväzujúce poznámky (poznámky pripojené k nadradenej poznámke, úlohe alebo udalosti) a vráti iba samostatné poznámky

Vracia: zoznam poznámok s id, title, summary, type, tags, priority, status, recorded_at, created_at.

get_note

Získa jednu poznámku s jej plným prepisom a všetkými prepojenými úlohami a udalosťami.

Parameter	Typ	Popis
note_id	string	UUID poznámky

Vracia: poznámku s title, summary, transcript, type, tags, priority, status, metadata, created_at, plus polia tasks[] a events[].

Vracia aj transcript_speakers (repliky prepisu označené podľa hovoriaceho, pri schôdzkach s viacerými hovoriacimi - inak null), speaker_count (null, pokiaľ nahrávka nebola rozdelená podľa hovoriaceho) a parent_note_id/parent_task_id/parent_event_id (nastavené, keď je táto poznámka follow-up úpravou inej položky). Každý záznam tasks[]/events[] obsahuje aj reminders_at/recurrence_rule (úlohy) alebo reminder_minutes/attendees/recurrence_rule (udalosti).

get_notes_full

Získa viacero poznámok s ich úlohami a udalosťami v jednom volaní. Rovnaké filtre ako get_notes, ale každá poznámka obsahuje vložené tasks[] a events[].

Parameter	Typ	Default	Popis
limit	int	10	Počet poznámok (max 20)
offset	int	0	Preskoč toľko poznámok
tags	string	-	Filtruj podľa tagov
date_from	string	-	Začiatočný dátum, YYYY-MM-DD
date_to	string	-	Koncový dátum, YYYY-MM-DD
standalone_only	bool	false	Ak true, skryje nadväzujúce poznámky (poznámky pripojené k nadradenej poznámke, úlohe alebo udalosti) a vráti iba samostatné poznámky

get_tasks

Vypíše úlohy s filtrovaním.

Parameter	Typ	Default	Popis
status	string	"todo"	Filter: todo, done alebo all
limit	int	30	Počet úloh (max 100)
offset	int	0	Preskoč toľko úloh
tags	string	-	Filtruj podľa tagov, oddelené čiarkami
date_from	string	-	Začiatočný dátum, YYYY-MM-DD (filtruje podľa termínu; úlohy bez termínu sú vylúčené)
date_to	string	-	Koncový dátum, YYYY-MM-DD (filtruje podľa termínu; úlohy bez termínu sú vylúčené)

Vracia: zoznam úloh s id, title, description, status, priority, tags, deadline, reminder_at, reminders_at, completed_at, completed_by, source, created_at. reminder_at kvôli spätnej kompatibilite zrkadlí prvú položku z reminders_at - použi reminders_at, ak chceš vidieť všetky pripomienky úlohy.

get_events

Vypíše kalendárové udalosti s filtrovaním podľa dátumového rozsahu.

Parameter	Typ	Default	Popis
limit	int	30	Počet udalostí (max 100)
offset	int	0	Preskoč toľko udalostí
date_from	string	-	Začiatočný dátum, YYYY-MM-DD (filtruje podľa času začiatku udalosti)
date_to	string	-	Koncový dátum, YYYY-MM-DD

Vracia: zoznam udalostí s id, title, description, status, start_at, end_at, location, is_all_day, tags, note_id, reminder_minutes, attendees, recurrence_rule, created_at.

get_reports

Získa tvoje AI vygenerované reporty s plným markdown obsahom.

Parameter	Typ	Default	Popis
report_type	string	"daily"	Typ: daily, weekly, monthly alebo yearly
limit	int	5	Počet reportov (max 10)

Vracia: zoznam reportov s id, type, period_start, period_end, content_md, created_at.

poznámka

Mesačné reporty môžu mať 3 000-5 000 slov. Použi limit=1, ak má tvoj AI nástroj úzky kontextový limit.

get_tags

Získa všetky tvoje tagy, zoradené najskôr podľa pripnutých, potom podľa počtu použití.

Žiadne parametre. Vracia až 100 tagov, každý s tag, usage_count, is_pinned, is_manual.

get_profile

Získa info tvojho účtu a štatistiky spotreby.

Žiadne parametre. Vracia email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at a stats (počty poznámok/úloh/udalostí).

search

Hľadá naprieč poznámkami, úlohami a udalosťami naraz. Pre poznámky podporuje textové aj sémantické hľadanie (nájde výsledky podľa významu pomocou AI embeddingov).

Parameter	Typ	Default	Popis
query	string	povinné	Hľadaný text (max 500 znakov)
limit	int	20	Max výsledky na typ (max 20)
semantic	bool	true	Zapne sémantické hľadanie pre poznámky

Vracia výsledky zoskupené podľa typu: notes[], tasks[], events[]. Každý výsledok má id, type, title, detail, created_at.

Nastav semantic=false pre rýchlejšie iba textové hľadanie.

get_change_log

Zobrazí históriu úprav poznámky, úlohy alebo udalosti - každú follow-up úpravu od AI aj každú manuálnu úpravu, ktorú si urobil ty sám, od najnovšej.

Parameter	Typ	Default	Popis
entity	string	povinné	notes, tasks alebo events
entity_id	string	povinné	UUID položky
include_manual	bool	false	Zahrnie aj tvoje vlastné manuálne úpravy, nielen tie od AI

Vracia: zoznam záznamov o zmenách s id (použi ho ako entry_id na vrátenie zmeny), field_name, old_value, new_value, source (follow_up, smart_context alebo manual), origin_note_id, edited_at a reverted_at (nastaví sa po vrátení zmeny).

process_note (Pro a Ultra)

Plný AI pipeline - funguje rovnako ako nahrávanie v aplikácii. Pošli text alebo audio a TellDone prepíše, analyzuje s AI a vytvorí štruktúrovanú poznámku s extrahovanými úlohami, udalosťami, tagmi a embeddingmi.

Tento nástroj je asynchrónny: vracia okamžite s audio_id a spracováva na pozadí. Výsledky prichádzajú cez real-time synchronizáciu na tvoje pripojené zariadenia, alebo môžeš pollnúť cez get_notes().

Parameter	Typ	Popis
text	string	Text na analýzu (preskočí prepis, ak nie je poskytnuté audio)
audio_base64	string	Base64-kódovaný audio súbor (až 50MB, spustí prepis)
audio_format	string	m4a, ogg, wav, mp3, aac alebo webm (default: m4a)
parent_task_id	string	UUID úlohy, ku ktorej je toto follow-up
parent_note_id	string	UUID poznámky, ku ktorej je toto follow-up
parent_event_id	string	UUID udalosti, ku ktorej je toto follow-up

Musíš poskytnúť buď text alebo audio_base64 (alebo oboje - audio má prioritu pre prepis).

Vracia: {"audio_id": "...", "status": "processing", "mode": "text-only"} alebo "mode": "audio+stt", ak bolo poskytnuté audio.

poznámka

process_note podlieha kvótam tvojho plánu (uploady za deň, poznámky za mesiac, max dĺžka textu). Použi get_profile na kontrolu aktuálnej spotreby.

create_note (Pro a Ultra)

Okamžite vytvor poznámku v plain texte. Nespúšťa AI analýzu - žiadne úlohy ani udalosti sa neextrahujú. Pre plnú AI analýzu s extrakciou úloh/udalostí použi namiesto toho process_note.

Parameter	Typ	Limit	Popis
title	string	200 znakov	Povinné
summary	string	1000 znakov	Voliteľné. Krátky teaser (1-3 vety). Zahrnuté v promptoch reportov, takže drž stručné
transcript	string	podľa plánu	Voliteľné. Long-form telo zobrazené v detaile poznámky. Nezahrnuté v reportoch. Limity: Free 2 000 / Basic 8 000 / Pro 20 000 / Ultra 50 000 znakov
type	string	-	Voliteľné. task, idea, info (default), status, meeting, event alebo reflection
tags	string	20 tagov	Oddelené čiarkami, voliteľné

create_task (Pro a Ultra)

Vytvor novú úlohu.

Parameter	Typ	Limit	Popis
title	string	200 znakov	Povinné
description	string	2000 znakov	Voliteľné
priority	string	-	low, medium (default) alebo high
deadline	string	-	YYYY-MM-DD, voliteľné
reminder_at	string	-	ISO 8601 datetime (napr. 2026-04-15T09:00:00Z), voliteľné
tags	string	20 tagov	Oddelené čiarkami, voliteľné
note_id	string	-	UUID na prepojenie úlohy s rodičovskou poznámkou, voliteľné

create_event (Pro a Ultra)

Vytvor kalendárovú udalosť.

Parameter	Typ	Limit	Popis
title	string	200 znakov	Povinné
start_at	string	-	ISO 8601 datetime, povinné
end_at	string	-	ISO 8601 datetime (default: start + 1 hodina)
description	string	2000 znakov	Voliteľné
location	string	200 znakov	Voliteľné
is_all_day	bool	-	Default: false
tags	string	20 tagov	Oddelené čiarkami, voliteľné
reminder_minutes	string	-	Minúty pred udalosťou oddelené čiarkami (napr. 15,60), voliteľné
attendees	string	-	Mená alebo e-maily oddelené čiarkami, voliteľné
recurrence_rule	string	-	RRULE string (napr. FREQ=WEEKLY;BYDAY=MO,WE,FR), voliteľné
note_id	string	-	UUID na prepojenie udalosti s rodičovskou poznámkou, voliteľné

update_note (Pro a Ultra)

Aktualizuj jedno alebo viac polí na existujúcej poznámke. Zmenia sa iba polia, ktoré poskytneš.

Parameter	Typ	Popis
note_id	string	Povinné, UUID poznámky
title	string	Nový názov (max 200 znakov)
summary	string	Nové zhrnutie (max 1000 znakov, pošli medzeru " " na vyčistenie)
transcript	string	Nový prepis (limit podľa plánu, pošli medzeru " " na vyčistenie)
type	string	task, idea, info, status, meeting, event alebo reflection
tags	string	Tagy oddelené čiarkami (nahrádza všetky existujúce tagy, max 20)
priority	string	low, medium alebo high
status	string	active alebo archived

upozornenie

Pri poznámkach vytvorených hlasovým pipelineom je transcript pôvodný výstup speech-to-text. Prepísanie nahradí kanonický zdroj - ak chceš zachovať pôvodný, zváž radšej pridanie k nemu.

update_task (Pro a Ultra)

Aktualizuj jedno alebo viac polí na existujúcej úlohe. Zmenia sa iba polia, ktoré poskytneš.

Parameter	Typ	Popis
task_id	string	Povinné, UUID úlohy
title	string	Nový názov
description	string	Nový popis (pošli medzeru " " na vyčistenie)
priority	string	low, medium alebo high
deadline	string	YYYY-MM-DD (pošli medzeru na vyčistenie)
status	string	todo alebo done
tags	string	Tagy oddelené čiarkami (nahrádza všetky existujúce tagy, max 20)
reminder_at	string	ISO 8601 datetime (pošli medzeru na vyčistenie)

Nastavenie status na done tiež zaznamená, kedy a ako bola úloha dokončená.

complete_task (Pro a Ultra)

Skratka na označenie úlohy ako hotovej.

Parameter	Typ	Popis
task_id	string	Povinné, UUID úlohy

Vracia chybu, ak úloha neexistuje alebo je už dokončená.

update_event (Pro a Ultra)

Aktualizuj jedno alebo viac polí na existujúcej udalosti. Zmenia sa iba polia, ktoré poskytneš.

Parameter	Typ	Popis
event_id	string	Povinné, UUID udalosti
title	string	Nový názov
description	string	Nový popis (pošli medzeru na vyčistenie)
start_at	string	Nový čas začiatku (ISO 8601)
end_at	string	Nový čas konca (ISO 8601)
location	string	Nové miesto (pošli medzeru na vyčistenie)
status	string	confirmed, tentative alebo cancelled
tags	string	Tagy oddelené čiarkami (nahrádza všetky existujúce tagy, max 20)
is_all_day	string	"true" alebo "false"
reminder_minutes	string	Minúty pred udalosťou oddelené čiarkami (napr. 15,60)
attendees	string	Mená alebo e-maily oddelené čiarkami
recurrence_rule	string	RRULE string (pošli medzeru na vyčistenie)

delete_note (Pro a Ultra)

Zmaže poznámku. Toto tiež zmaže všetky úlohy a udalosti, ktoré boli vytvorené z tejto poznámky.

Parameter	Typ	Popis
note_id	string	Povinné, UUID poznámky

delete_task (Pro a Ultra)

Zmaže úlohu.

Parameter	Typ	Popis
task_id	string	Povinné, UUID úlohy

delete_event (Pro a Ultra)

Zmaže udalosť.

Parameter	Typ	Popis
event_id	string	Povinné, UUID udalosti

undo_change_log_entry (Pro a Ultra)

Vráti jednu sledovanú úpravu - obnoví pole na hodnotu, akú malo pred touto úpravou, či už ju urobila AI (z follow-up nahrávky), alebo ty priamo.

Parameter	Typ	Popis
entity	string	Povinné, notes, tasks alebo events
entity_id	string	Povinné, UUID položky
entry_id	string	Povinné, id záznamu o zmene z get_change_log

Vracia: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Vrátenie toho istého záznamu dvakrát vráti chybu - už je vrátený.

restore_entity (Pro a Ultra)

Obnoví zmazanú alebo archivovanú poznámku, úlohu alebo udalosť.

Parameter	Typ	Popis
entity	string	Povinné, notes, tasks alebo events
entity_id	string	Povinné, UUID položky

Vracia: obnovenú položku ako JSON.

create_tag (Pro a Ultra)

Vytvorí nový tag alebo premení existujúci automaticky navrhnutý tag na trvalý.

Parameter	Typ	Popis
tag	string	Povinné, 1-50 znakov (ukladá sa malými písmenami)
category	string	Voliteľné

set_tag_pinned (Pro a Ultra)

Pripne alebo odopne tag, aby sa zoradil na vrch tvojho zoznamu tagov.

Parameter	Typ	Popis
tag	string	Povinné
pinned	bool	Povinné

Tagy obsahujúce znak / nemožno pripnúť.

delete_tag (Pro a Ultra)

Odstráni tag. Možno ho obnoviť cez restore_tag.

Parameter	Typ	Popis
tag	string	Povinné

restore_tag (Pro a Ultra)

Obnoví zmazaný tag.

Parameter	Typ	Popis
tag	string	Povinné

Vstupné limity

Pole	Max dĺžka	Použité v
title	200 znakov	create/update poznámka, úloha, udalosť
description	2 000 znakov	create/update úloha, udalosť
summary	1 000 znakov (hard)	create/update poznámka. Zahrnuté v promptoch reportov, držané krátke na kontrolu nákladov tokenov
transcript	podľa plánu: Free 2 000 / Basic 8 000 / Pro 20 000 / Ultra 50 000	create/update poznámka. Long-form telo, nie v reportoch
location	200 znakov	create/update udalosť
tags	20 tagov	create/update poznámka, úloha, udalosť
search query	500 znakov	search
audio_base64 (dekódované)	50 MB	process_note

Ak prekročíš limit, nástroj vráti chybovú správu ako "title too long (max 200 chars, got 250)".

Spracovanie chýb

Všetky nástroje vracajú JSON. Chyby používajú tento formát:

{"error": "description of what went wrong"}

Bežné chyby:

Chyba	Kedy
"MCP access is read-only..."	Write nástroj zavolaný v read-only režime
"Invalid note_id format"	Reťazec, ktorý nie je UUID, posunutý ako ID
"Note not found"	ID neexistuje alebo patrí inému používateľovi
"Task not found or already completed"	complete_task na neexistujúcej alebo už hotovej úlohe
"title too long (max 200 chars, got N)"	Vstupný limit prekročený
"Too many tags (max 20)"	Poskytnutých viac ako 20 tagov

HTTP-level chyby:

Kód	Význam
401	Neplatný alebo chýbajúci Bearer token
403	MCP vypnuté alebo plán nedovoľuje MCP
429	Prekročený rate limit (5 req/s, burst až 20)

Príklady použitia

Všetky príklady používajú cURL s MCP JSON-RPC protokolom. Nahraď YOUR_TOKEN svojím pripojovacím tokenom.

Čítanie dát

# Get your profile and stats
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_profile"}}'

# List recent notes (limit 5, from April 2026)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_notes","arguments":{"limit":5,"date_from":"2026-04-01"}}}'

# Search notes (hybrid text + semantic)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"search","arguments":{"query":"project deadline","limit":5}}}'

Zápis dát (Pro a Ultra)

# Process a note through full AI pipeline (extracts tasks + events)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":10,"method":"tools/call",
       "params":{"name":"process_note","arguments":{"text":"Need to buy groceries tomorrow. Meeting with Katie at 3pm at the cafe to discuss the project."}}}'

# Create a task with deadline and reminder
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":11,"method":"tools/call",
       "params":{"name":"create_task","arguments":{"title":"Review PR","priority":"high","deadline":"2026-04-15","reminder_at":"2026-04-15T09:00:00Z","tags":"dev"}}}'

# Create a recurring event with reminders and attendees
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":12,"method":"tools/call",
       "params":{"name":"create_event","arguments":{"title":"Team standup","start_at":"2026-04-12T10:00:00Z","reminder_minutes":"15","attendees":"Katie,John","recurrence_rule":"FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR","tags":"meeting"}}}'

# Complete a task
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":13,"method":"tools/call",
       "params":{"name":"complete_task","arguments":{"task_id":"<task-uuid>"}}}'

Úspešná odpoveď vyzerá takto:

{
  "jsonrpc": "2.0",
  "id": 10,
  "result": {
    "content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Review PR\",\"status\":\"todo\"}"}]
  }
}

poznámka

Write a update nástroje vracajú minimálne odpovede iba s id, title a status. Aby si po zápise získal plné detaily (tagy, prioritu, termín atď.), urob následné read volanie ako get_tasks alebo get_note.

Správa tokenov

Akcia	Ako
Zobraziť token	iPhone Nastavenia → Integrácie → AI Agents (alebo web Nastavenia → AI Agents), klepni na ikonu oka
Skopírovať token	Klepni na ikonu kopírovania vedľa tokenu
Regenerovať	Klepni na Regenerovať a potvrď. Starý token okamžite prestane fungovať a všetky aktívne relácie sa odpoja
Zmeniť režim	Iba Ultra - prepni medzi Read-only a Read + Write. Na Pro je režim fixne Read + Write
Vypnúť	Klepni na Vypnúť a potvrď. Token sa zmaže a všetky pripojenia sa zastavia. Môžeš znova zapnúť neskôr (vydá sa nový token)

Čo sa môžeš pýtať svojho AI agenta

Po pripojení sa svojho AI nástroja pýtaj veci ako:

Prehľad dňa:

• "Na čom som dnes pracoval?"
• "Ukáž mi poznámky z tohto týždňa"
• "Ktoré úlohy sú po termíne?"

Spravuj úlohy:

• "Vytvor úlohu: prehodnotiť kvartálny report, vysoká priorita, termín v piatok"
• "Označ Figma úlohu ako hotovú"
• "Na akých úlohách pracujem?"

Hľadaj a analyzuj:

• "Nájdi všetky poznámky o marketingovej stratégii"
• "Aké udalosti mám budúci týždeň?"
• "Zhrnu denné reporty z minulého týždňa"

Plánuj dopredu:

• "Vytvor udalosť: tímový standup zajtra o 10:00"
• "Čo mám v kalendári tento týždeň?"
• "Ukáž mi top tagy - čomu venujem najviac času?"

AI agent má plný prístup k tvojim poznámkam, úlohám, udalostiam a reportom. Dokáže čítať, vytvárať, aktualizovať a mazať dáta a odpovedať na komplexné otázky kombinovaním informácií z viacerých nástrojov.

Dôležité poznámky

• Dva spôsoby vytvárania poznámok - create_note vytvorí plain text poznámku okamžite (bez AI analýzy). process_note spustí plný AI pipeline (rovnako ako nahrávanie v aplikácii) - analyzuje text, extrahuje úlohy a udalosti, generuje tagy a embeddingy. Použi process_note, keď chceš, aby TellDone myslel za teba.
• Žiadna synchronizácia integrácií - položky vytvorené alebo aktualizované cez MCP nespúšťajú webhook automatizácie ani synchronizácie integrácií (Todoist, Notion). V tvojich aplikáciách sa objavia pri ďalšej synchronizácii.
• Sémantické hľadanie závisí od nástroja - poznámky vytvorené cez process_note dostanú embeddingy a objavia sa v sémantickom hľadaní. Poznámky vytvorené cez create_note embeddingy nedostanú, takže sa objavia iba v textovom hľadaní.
• Write odpovede sú minimálne - create a update nástroje vracajú iba id, title a status. Aby si po zápise získal všetky polia, urob následné read volanie.
• Filtre dátumu používajú UTC - parametre date_from/date_to sa porovnávajú ako UTC timestampy. Pre používateľov v non-UTC časových zónach môžu hraničné dátumy zahrnúť alebo vylúčiť položky zo susedných dní.
• Rate limit - 5 požiadaviek za sekundu, s burstami až do 20. Pri bulk operáciách rozlož svoje požiadavky.

Bezpečnosť

• Každý používateľ dostane unikátny 384-bitový pripojovací token
• Tvoj token je okamžite zrušený, keď vypneš MCP alebo ho regeneruješ
• Všetky dáta sú prísne izolované do tvojho účtu - tvoj agent má prístup iba k tvojim vlastným dátam
• Každá požiadavka je viazaná na tvojho používateľa - neexistuje spôsob, ako by agent mohol získať prístup k dátam iného používateľa
• Pripojenie používa HTTPS s rate limitingom (5 req/s, burst až 20)
• OAuth pripojenia používajú PKCE s jednorazovými autorizačnými kódmi a krátko platnými prístupovými tokenmi - pripojenie môžeš kedykoľvek zrušiť priamo v aplikácii

Ak chceš technické detaily - discovery endpointy, platnosť tokenov, celý OAuth flow - pozri našu open-source referenciu konektora na github.com/exp78/telldone-mcp, alebo sa priamo opýtaj https://api.telldone.app/.well-known/oauth-protected-resource.

Súkromie a tok dát

Tvoje dáta sa prenášajú do pripojeného AI nástroja iba vtedy, keď ho výslovne požiadaš, aby niečo urobil - napríklad keď ho požiadaš, aby prečítal alebo upravil tvoje poznámky. Nástroj dostane iba odpovede na konkrétne volania, ktoré urobí, v rozsahu oprávnení, ktoré si schválil. Máš to pod kontrolou: zmeň read/write režim svojho plánu, zúž OAuth scopes, ktoré pri prihlásení schvaľuješ, alebo regeneruj a vypni svoj bearer token - všetko v Nastaveniach. Plné detaily nájdeš v Zásadách ochrany súkromia, alebo napíš na support@telldone.app s akýmikoľvek otázkami.

Riešenie problémov

Príznak	Príčina / riešenie
Súhlasová stránka OAuth hlási "Wrong email or password"	Použi e-mail a heslo svojho TellDone účtu (ten, ktorým sa prihlasuješ do aplikácie). Ak má tvoj účet iba Apple alebo Google Sign In a žiadne heslo, použi namiesto toho metódu s bearer tokenom.
Pripojené, ale AI nedokáže nič vytvoriť ani upraviť	Tvoj plán alebo režim je read-only, alebo pripojenie nedostalo write scopes - pripoj sa znova a schváľ ich, prípadne skontroluj svoj režim v Nastaveniach.
Chyba "Insufficient scope" z nástroja	OAuth pripojenie nedostalo tento scope. Pripoj sa znova a schváľ oprávnenie, ktoré nástroj potrebuje.
Nástroje sa vôbec nezobrazujú	MCP nie je na tvojom účte zapnuté (Nastavenia → AI Agents), alebo tvoj plán MCP neobsahuje.
Môj klient mi umožňuje vyberať iba zo zoznamu konektorov a TellDone tam nie je	TellDone zatiaľ nie je v adresári konektorov žiadneho klienta - pridaj ho ako vlastný konektor s MCP URL, alebo použi metódu s bearer tokenom.

Pozri tiež

• Webhook automatizácie - posielaj dáta do externých služieb automaticky
• Todoist - vyhradená obojsmerná synchronizácia úloh
• Notion - vyhradená Notion integrácia