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 (20 nástrojov). Ultra má vyššie kvóty a môže prepnúť do read-only režimu.

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 a reporty - a vytvárať, aktualizovať a mazať položky. Celkovo je 20 nástrojov: 9 na čítanie dát a 11 na zápis.

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

Požiadavky podľa plánu

Plán	MCP
Free	Zamknuté
Basic	Zamknuté
Pro	Read + Write (20 nástrojov)
Ultra	Read + Write (20 nástrojov, vyššie kvóty) - môže prepnúť aj 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 tvojho AI nástroja

Štyri karty v in-app Setup pickeri (Claude Code, Cursor, Windsurf, Iné) zodpovedajú sekciám nižšie. Vo všetkých príkladoch nahraď YOUR_TOKEN tokenom z tvojich nastavení.

Claude Code

Spusti tento príkaz v termináli:

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

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.

Čo môžeš robiť

Read nástroje (9) - 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)

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 (11) - 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ť

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)

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[].

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

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, completed_at, completed_by, source, created_at.

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, created_at.

poznámka

get_events nevracia attendees, reminder_minutes ani recurrence_rule. Tieto sú zapisovateľné cez create_event/update_event, ale nie sú zahrnuté vo výstupe zoznamu. Ak ich potrebuješ, načítaj rodičovskú poznámku cez get_note.

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.

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

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)

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. 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)

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