MCP pristup (AI agenti)

Šta se nedavno promenilo

MCP je sada potpuno dostupan na iPhone-u (pored veb aplikacije). iPhone ekran preslikava veb i uključuje iste isečke za podešavanje za sve podržane AI klijente.

Plan Pro i viši

MCP pristup zahteva plan Pro ili Ultra. Oba plana dobijaju pun pristup za čitanje + pisanje (27 alata) i mogu preći u režim samo za čitanje ako to žele.

MCP (Model Context Protocol) ti omogućava da povežeš AI asistente za kodiranje i alate za automatizaciju direktno sa svojim TellDone podacima. Kada je povezan, tvoj AI agent može da čita tvoje beleške, zadatke, događaje, izveštaje, oznake i istoriju promena - i da kreira, ažurira, briše i vraća stavke. Ukupno ima 27 alata: 10 za čitanje podataka i 17 za pisanje.

Dostupno i u iPhone aplikaciji (Podešavanja → Integracije → AI agenti) i u veb aplikaciji (Podešavanja → AI agenti).

Na iPhone-u, Podešavanja → Integracije → AI agenti otvara ekran za podešavanje MCP-a sa tvojim tokenom pristupa podrazumevano maskiranim:

A na vebu:

Dva načina za povezivanje

Postoje dva načina da autentifikuješ AI klijenta, i oba su potpuno podržana:

1. OAuth 2.1 (preporučeno) - standardni tok saglasnosti „Prijava putem TellDone-a". Ovo koristi Claude Desktop connector interfejs i Claude.ai. Bez kopiranja tokena - prijaviš se svojim TellDone nalogom i odobriš dozvole koje klijent traži.
2. Bearer token - kopiraj svoj lični token pristupa iz Podešavanja i nalepi ga u konfiguraciju svog klijenta. Najjednostavnije za skripte, CLI-jeve i klijente koji nemaju ugrađen OAuth tok.

Klijent	Preporučeno
Claude Desktop / Cowork	OAuth - dodaj prilagođeni konektor sa MCP URL-om, pa se prijavi
Claude Code (CLI)	Bilo koji - claude mcp add te vodi kroz OAuth u pregledaču, ili dodaj Bearer zaglavlje za metod tokena
Skripte ili tvoj sopstveni kod	Bearer token - najjednostavnije za automatizaciju
Klijent koji podržava samo biranje iz direktorijuma navedenih konektora	Za sada koristi bearer token ili mcp-remote most - TellDone još nije ni u jednom direktorijumu konektora

Zahtevi plana

Plan	MCP
Free	Zaključano
Basic	Zaključano
Pro	Čitanje + pisanje (27 alata) - može preći u režim samo za čitanje
Ultra	Čitanje + pisanje (27 alata) - može preći u režim samo za čitanje

Ekran u aplikaciji

Ekran AI agenata ima tri stanja u zavisnosti od tvog plana i toga da li je MCP uključen.

Zaključano (Free i Basic)

Ako si na planu Free ili Basic, ekran objašnjava šta MCP radi i prikazuje dugme Nadogradi. Dodir na njega otvara paywall gde možeš preći na Pro ili Ultra.

Onemogućeno (Pro i Ultra, funkcija isključena)

Ako si na Pro ili Ultra, ali još nisi uključio MCP, ekran prikazuje kratak rezime onoga što tvoj plan može (broj alata, režim pristupa, kvote) i dugme Omogući. Dodirni ga da generišeš svoj token za povezivanje i pokreneš integraciju.

Omogućeno

Kada je omogućen, ekran prikazuje sve što ti je potrebno da povežeš AI klijenta:

• Prekidač režima - na Ultra možeš prebacivati između Samo za čitanje i Čitanje + pisanje. Na Pro je režim fiksiran na Čitanje + pisanje.
• Red Token pristupa sa prekidačem oka za otkrivanje ili sakrivanje tokena i dugmetom za kopiranje.
• Birač podešavanja sa karticama za Claude Code, Cursor, Windsurf i Ostalo. Odgovarajući isečak koda pojavljuje se ispod kartica - samo ga kopiraj i nalepi u svog AI klijenta.
• Dugme Ponovo generiši - rotira token odmah i prekida sve aktivne sesije koje koriste stari.
• Dugme Onemogući - isključuje MCP i briše token. Možeš ponovo omogućiti kasnije, ali će biti izdat novi token.

savet

Drži svoj token za povezivanje privatnim. Svako sa tokenom može pristupiti tvojim TellDone podacima. Koristi Ponovo generiši ako ikada posumnjaš da je token procureo.

Kako da omogućiš

MCP možeš podesiti sa bilo koje platforme:

• iPhone: Podešavanja → Integracije → AI agenti (MCP)
• Veb: app.telldone.app → Podešavanja → AI agenti

Koraci:

1. Dodirni Omogući.
2. Izaberi svoj režim pristupa (samo Ultra - Pro je uvek Čitanje + pisanje).
3. Otkrij i kopiraj svoj token koristeći ikonice oka i kopiranja.
4. Izaberi svoj alat u odeljku Podešavanje (Claude Code, Cursor, Windsurf ili Ostalo).
5. Nalepi isečak u konfiguraciju svog AI klijenta.

Povezivanje putem OAuth-a

OAuth je preporučeni put za Claude Desktop, Claude.ai, Cowork i Claude Code - prijaviš se svojim TellDone nalogom umesto da kopiraš token unaokolo.

MCP URL za OAuth: https://api.telldone.app/mcp/user (bez završnog /mcp - to je drugi URL, koristi se samo za bearer-token put ispod)

Claude Desktop / Cowork

1. U klijentu, izaberi Add custom connector.
2. Unesi URL servera: https://api.telldone.app/mcp/user
3. Klijent otvara TellDone stranicu saglasnosti u tvom pregledaču. Videćeš koja aplikacija traži pristup, tačne dozvole koje želi i formu za prijavu.
4. Prijavi se svojim TellDone imejlom i lozinkom naloga, pa klikni Allow.
5. Klijent automatski dobija token pristupa i povezuje se - nema tokena za kopiranje.

napomena

Prijava na stranici saglasnosti koristi imejl i lozinku tvog TellDone naloga. Ako tvoj nalog ima samo Apple ili Google prijavu (bez postavljene lozinke), za sada koristi bearer-token metod ispod.

Claude Code

OAuth (otvara prijavu u pregledaču):

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

Claude Code automatski otkriva OAuth tok, ali te ne prijavljuje pri prvom pozivu - pokreni /mcp unutar Claude Code-a i izaberi Authenticate da otvoriš prijavu u pregledaču. Nakon toga osvežava tvoj token pristupa za tebe - nema šta da se održava.

Bearer token (bez pregledača, dobro za headless podešavanja):

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

Nabavi svoj YOUR_TOKEN iz aplikacije: Podešavanja → Integracije → AI agenti → Kopiraj token (pogledaj Kako da omogućiš iznad).

Povezivanje pomoću bearer tokena

Za klijente bez ugrađene OAuth podrške - Cursor, Windsurf i druge - nalepi svoj lični token pristupa direktno u konfiguraciju klijenta. Zameni YOUR_TOKEN tokenom iz svojih podešavanja u svim primerima ispod.

Cursor

Dodaj u .cursor/mcp.json:

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

Windsurf

Dodaj u .codeium/windsurf/mcp_config.json:

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

Ostalo

Koristi ove isečke za klijente koje birač u aplikaciji grupiše pod Ostalo.

Codex

Dodaj u 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

Drugi MCP klijenti

Bilo koji alat koji podržava MCP preko HTTP-a može se povezati. Koristi krajnju tačku https://api.telldone.app/mcp/user/mcp sa Bearer YOUR_TOKEN autorizacionim zaglavljem.

Alternativno auth zaglavlje

Ako tvoj klijent ili proksi rezerviše Authorization zaglavlje (na primer, neki Smithery-style gateway-i), pošalji token u X-MCP-Token: YOUR_TOKEN umesto toga. Oba zaglavlja rade; ako su oba prisutna, Authorization pobeđuje.

Testiranje veze

Možeš verifikovati da tvoj token radi jednostavnom cURL komandom:

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

Uspešan odgovor izlistava sve dostupne alate.

Dozvole (opsezi)

OAuth veze imaju opsege - tokom prijave vidiš tačno šta klijent traži i to izričito odobravaš.

Opseg	Omogućava aplikaciji da...
notes:read	Čita tvoje beleške, pretražuje, otvara pune detalje beleške
notes:write	Kreira, uređuje, briše beleške (i pokreće proces glasovne beleške)
tasks:read / tasks:write	Čita / kreira, uređuje, završava i briše zadatke
events:read / events:write	Čita / kreira, uređuje i briše događaje
reports:read	Čita tvoje dnevne, nedeljne, mesečne i godišnje izveštaje
tags:read / tags:write	Izlistava tvoje oznake / kreira i preimenuje oznake
profile:read	Čita tvoj profil i informacije o pretplati
offline_access	Ostaje povezan kada si odsutan (izdaje refresh token tako da ne moraš da se prijavljuješ svaku sesiju)

Opsezi su plafon, ne garancija - veza samo sa notes:read ne može pozvati alat za pisanje bez obzira na to šta tražiš. Tvoj plan je druga kapija povrh opsega.

Bearer-token veze nemaju pojedinačne opsege - njima upravlja samo režim čitanja/pisanja tvog plana.

Šta možeš da radiš

Alati za čitanje (10) - Pro i Ultra

Alat	Šta radi
get_notes	Izlistava beleške sa filterima (oznake, opseg datuma, pretraga teksta)
get_note	Prikazuje jednu belešku sa njenim podređenim zadacima, događajima i punim transkriptom
get_notes_full	Preuzima više beleški sa ugrađenim zadacima i događajima u jednom pozivu
get_tasks	Izlistava zadatke filtrirane po statusu (za uraditi, završeno, sve), oznakama ili datumima
get_events	Izlistava događaje u kalendaru, filtrira po opsegu datuma
get_reports	Čita tvoje dnevne, nedeljne, mesečne i godišnje izveštaje (pun markdown)
get_tags	Prikazuje sve tvoje oznake sortirane po korišćenju
get_profile	Prikazuje informacije o tvom nalogu i statistiku potrošnje
search	Pretražuje kroz beleške, zadatke i događaje (tekstualna + semantička pretraga za beleške)
get_change_log	Prikazuje istoriju izmena beleške, zadatka ili događaja i to da li je svaka izmena poništena

savet

Alat search podržava semantičku pretragu za beleške - pronalazi rezultate po značenju, ne samo po ključnim rečima. Na primer, pretraga „sastanci o budžetu" pronaći će beleške o finansijskim diskusijama čak i ako ne sadrže reč „budžet".

Alati za pisanje (17) - Pro i Ultra

Alat	Šta radi
process_note	Pun AI proces - pošalji tekst ili zvuk, dobij belešku sa zadacima, događajima i oznakama
create_note	Dodaje običnu tekstualnu belešku (bez AI analize)
create_task	Dodaje zadatak sa prioritetom, rokom, podsetnikom i oznakama
create_event	Dodaje događaj u kalendaru sa datumom, vremenom, lokacijom, podsetnicima, učesnicima i ponavljanjem
update_note	Menja naslov, rezime, tip, oznake, prioritet ili status beleške
update_task	Menja naslov, opis, prioritet, rok, podsetnik, oznake ili status zadatka
complete_task	Označava zadatak kao završen
update_event	Menja detalje događaja, vreme, lokaciju, podsetnike, učesnike, ponavljanje, oznake ili status
delete_note	Briše belešku i sve njene povezane zadatke i događaje
delete_task	Briše zadatak
delete_event	Briše događaj
undo_change_log_entry	Poništava jednu praćenu izmenu - AI ili tvoju sopstvenu - vraćajući prethodnu vrednost polja
restore_entity	Vraća obrisanu ili arhiviranu belešku, zadatak ili događaj
create_tag	Kreira novu oznaku, ili pretvara automatski predloženu oznaku u trajnu
set_tag_pinned	Kači ili otkači oznaku tako da se sortira na vrh
delete_tag	Uklanja oznaku (može se vratiti pomoću restore_tag)
restore_tag	Vraća obrisanu oznaku

Sve operacije pisanja i brisanja pojavljuju se trenutno na tvojim povezanim uređajima (telefon, veb aplikacija) putem sinhronizacije u realnom vremenu.

Referenca alata

get_notes

Izlistava beleške sa opcionim filtriranjem. Filteri datuma koriste recorded_at (kada si snimio glasovnu belešku), ne created_at.

Parametar	Tip	Podrazumevano	Opis
limit	int	20	Broj beleški za vraćanje (max 50)
offset	int	0	Preskoči ovoliko beleški (za paginaciju, max 10000)
tags	string	-	Filtriraj po oznakama, razdvojenim zarezima (poklapa bilo koju)
search	string	-	Pretraga teksta po naslovu i rezimeu
date_from	string	-	Datum početka, YYYY-MM-DD (uključivo)
date_to	string	-	Datum završetka, YYYY-MM-DD (isključivo)
standalone_only	bool	false	Kada je true, sakriva beleške nastavka (beleške povezane sa nadređenom beleškom/zadatkom/događajem) i vraća samo samostalne beleške

Vraća: listu beleški sa id, title, summary, type, tags, priority, status, recorded_at, created_at.

get_note

Preuzima jednu belešku sa njenim punim transkriptom i svim povezanim zadacima i događajima.

Parametar	Tip	Opis
note_id	string	UUID beleške

Vraća: belešku sa title, summary, transcript, type, tags, priority, status, metadata, created_at, plus nizovima tasks[] i events[].

Takođe vraća transcript_speakers (razmene transkripta sa oznakama govornika, za sastanke sa nekoliko govornika - inače null), speaker_count (null osim ako je snimak podeljen po govorniku) i parent_note_id/parent_task_id/parent_event_id (postavljeno kada je ova beleška izmena-nastavak druge stavke). Svaki unos tasks[]/events[] takođe uključuje reminders_at/recurrence_rule (zadaci) ili reminder_minutes/attendees/recurrence_rule (događaji).

get_notes_full

Preuzima više beleški sa njihovim zadacima i događajima u jednom pozivu. Isti filteri kao get_notes, ali svaka beleška uključuje ugrađene tasks[] i events[].

Parametar	Tip	Podrazumevano	Opis
limit	int	10	Broj beleški (max 20)
offset	int	0	Preskoči ovoliko beleški
tags	string	-	Filtriraj po oznakama
date_from	string	-	Datum početka, YYYY-MM-DD
date_to	string	-	Datum završetka, YYYY-MM-DD
standalone_only	bool	false	Kada je true, sakriva beleške nastavka (beleške povezane sa nadređenom beleškom/zadatkom/događajem) i vraća samo samostalne beleške

get_tasks

Izlistava zadatke sa filtriranjem.

Parametar	Tip	Podrazumevano	Opis
status	string	"todo"	Filter: todo, done ili all
limit	int	30	Broj zadataka (max 100)
offset	int	0	Preskoči ovoliko zadataka
tags	string	-	Filtriraj po oznakama, razdvojenim zarezima
date_from	string	-	Datum početka, YYYY-MM-DD (filtrira po roku; zadaci bez roka se izuzimaju)
date_to	string	-	Datum završetka, YYYY-MM-DD (filtrira po roku; zadaci bez roka se izuzimaju)

Vraća: listu zadataka sa id, title, description, status, priority, tags, deadline, reminder_at, reminders_at, completed_at, completed_by, source, created_at. reminder_at odražava prvi unos reminders_at radi kompatibilnosti unazad - koristi reminders_at da vidiš sve podsetnike zadatka.

get_events

Izlistava događaje u kalendaru sa filtriranjem po opsegu datuma.

Parametar	Tip	Podrazumevano	Opis
limit	int	30	Broj događaja (max 100)
offset	int	0	Preskoči ovoliko događaja
date_from	string	-	Datum početka, YYYY-MM-DD (filtrira po vremenu početka događaja)
date_to	string	-	Datum završetka, YYYY-MM-DD

Vraća: listu događaja sa id, title, description, status, start_at, end_at, location, is_all_day, tags, note_id, reminder_minutes, attendees, recurrence_rule, created_at.

get_reports

Preuzima tvoje AI izveštaje sa punim markdown sadržajem.

Parametar	Tip	Podrazumevano	Opis
report_type	string	"daily"	Tip: daily, weekly, monthly ili yearly
limit	int	5	Broj izveštaja (max 10)

Vraća: listu izveštaja sa id, type, period_start, period_end, content_md, created_at.

napomena

Mesečni izveštaji mogu imati 3.000-5.000 reči. Koristi limit=1 ako tvoj AI alat ima uzak kontekstni prozor.

get_tags

Preuzima sve tvoje oznake, sortirane prvo po zakačenim, pa po broju korišćenja.

Bez parametara. Vraća do 100 oznaka, svaku sa tag, usage_count, is_pinned, is_manual.

get_profile

Preuzima informacije o tvom nalogu i statistiku potrošnje.

Bez parametara. Vraća email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at i stats (broj beleški/zadataka/događaja).

search

Pretražuje kroz beleške, zadatke i događaje odjednom. Za beleške podržava i tekstualnu i semantičku pretragu (pronalazi rezultate po značenju koristeći AI ugradnje).

Parametar	Tip	Podrazumevano	Opis
query	string	obavezno	Tekst za pretragu (max 500 karaktera)
limit	int	20	Maks. rezultata po tipu (max 20)
semantic	bool	true	Omogući semantičku pretragu za beleške

Vraća rezultate grupisane po tipu: notes[], tasks[], events[]. Svaki rezultat ima id, type, title, detail, created_at.

Postavi semantic=false za bržu pretragu samo teksta.

get_change_log

Prikazuje istoriju izmena beleške, zadatka ili događaja - svaku AI izmenu iz nastavka i svaku ručnu izmenu koju si sam napravio, najnovije prve.

Parametar	Tip	Podrazumevano	Opis
entity	string	obavezno	notes, tasks ili events
entity_id	string	obavezno	UUID stavke
include_manual	bool	false	Uključi i tvoje sopstvene ručne izmene, ne samo AI

Vraća: listu unosa promena sa id (koristi ovo kao entry_id za poništavanje), field_name, old_value, new_value, source (follow_up, smart_context ili manual), origin_note_id, edited_at i reverted_at (postavljeno kada se poništi).

process_note (Pro i Ultra)

Pun AI proces - radi isto kao snimanje u aplikaciji. Pošalji tekst ili zvuk, i TellDone će transkribovati, analizirati veštačkom inteligencijom i kreirati strukturisanu belešku sa izvučenim zadacima, događajima, oznakama i ugradnjama.

Ovaj alat je asinhron: vraća se odmah sa audio_id i obrađuje u pozadini. Rezultati stižu putem sinhronizacije u realnom vremenu na tvoje povezane uređaje, ili možeš anketirati pomoću get_notes().

Parametar	Tip	Opis
text	string	Tekst za analizu (preskače transkripciju ako nije priložen zvuk)
audio_base64	string	Base64-kodirana audio datoteka (do 50MB, pokreće transkripciju)
audio_format	string	m4a, ogg, wav, mp3, aac ili webm (podrazumevano: m4a)
parent_task_id	string	UUID zadatka čiji je ovo nastavak
parent_note_id	string	UUID beleške čiji je ovo nastavak
parent_event_id	string	UUID događaja čiji je ovo nastavak

Moraš priložiti ili text ili audio_base64 (ili oboje - zvuk ima prioritet za transkripciju).

Vraća: {"audio_id": "...", "status": "processing", "mode": "text-only"} ili "mode": "audio+stt" ako je zvuk priložen.

napomena

process_note podleže kvotama tvog plana (otpremanja dnevno, beleške mesečno, maksimalna dužina teksta). Koristi get_profile da proveriš svoju trenutnu potrošnju.

create_note (Pro i Ultra)

Kreira običnu tekstualnu belešku trenutno. Ne pokreće AI analizu - ne izvlače se zadaci ni događaji. Za punu AI analizu sa izvlačenjem zadataka/događaja, koristi process_note umesto toga.

Parametar	Tip	Ograničenje	Opis
title	string	200 kar.	Obavezno
summary	string	1000 kar.	Opciono. Kratak najava (1-3 rečenice). Uključeno u upite izveštaja, pa neka bude kratko
transcript	string	zavisi od plana	Opciono. Dugačko telo prikazano u detalju beleške. Nije uključeno u izveštaje. Ograničenja: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000 kar.
type	string	-	Opciono. task, idea, info (podrazumevano), status, meeting, event ili reflection
tags	string	20 oznaka	Razdvojene zarezima, opciono

create_task (Pro i Ultra)

Kreira novi zadatak.

Parametar	Tip	Ograničenje	Opis
title	string	200 kar.	Obavezno
description	string	2000 kar.	Opciono
priority	string	-	low, medium (podrazumevano) ili high
deadline	string	-	YYYY-MM-DD, opciono
reminder_at	string	-	ISO 8601 datum-vreme (npr. 2026-04-15T09:00:00Z), opciono
tags	string	20 oznaka	Razdvojene zarezima, opciono
note_id	string	-	UUID za povezivanje zadatka sa nadređenom beleškom, opciono

create_event (Pro i Ultra)

Kreira događaj u kalendaru.

Parametar	Tip	Ograničenje	Opis
title	string	200 kar.	Obavezno
start_at	string	-	ISO 8601 datum-vreme, obavezno
end_at	string	-	ISO 8601 datum-vreme (podrazumevano: početak + 1 sat)
description	string	2000 kar.	Opciono
location	string	200 kar.	Opciono
is_all_day	bool	-	Podrazumevano: false
tags	string	20 oznaka	Razdvojene zarezima, opciono
reminder_minutes	string	-	Minuti pre događaja razdvojeni zarezima (npr. 15,60), opciono
attendees	string	-	Imena ili imejlovi razdvojeni zarezima, opciono
recurrence_rule	string	-	RRULE string (npr. FREQ=WEEKLY;BYDAY=MO,WE,FR), opciono
note_id	string	-	UUID za povezivanje događaja sa nadređenom beleškom, opciono

update_note (Pro i Ultra)

Ažurira jedno ili više polja na postojećoj belešci. Menjaju se samo polja koja priložiš.

Parametar	Tip	Opis
note_id	string	Obavezno, UUID beleške
title	string	Novi naslov (max 200 kar.)
summary	string	Novi rezime (max 1000 kar., prosledi razmak " " da obrišeš)
transcript	string	Novi transkript (ograničenje zavisi od plana, prosledi razmak " " da obrišeš)
type	string	task, idea, info, status, meeting, event ili reflection
tags	string	Oznake razdvojene zarezima (zamenjuje sve postojeće oznake, max 20)
priority	string	low, medium ili high
status	string	active ili archived

oprez

Za beleške kreirane glasovnim procesom, transcript je originalni izlaz pretvaranja govora u tekst. Prepisivanje ga zamenjuje kanonskim izvorom - razmisli o dodavanju umesto toga ako želiš da sačuvaš original.

update_task (Pro i Ultra)

Ažurira jedno ili više polja na postojećem zadatku. Menjaju se samo polja koja priložiš.

Parametar	Tip	Opis
task_id	string	Obavezno, UUID zadatka
title	string	Novi naslov
description	string	Novi opis (prosledi razmak " " da obrišeš)
priority	string	low, medium ili high
deadline	string	YYYY-MM-DD (prosledi razmak da obrišeš)
status	string	todo ili done
tags	string	Oznake razdvojene zarezima (zamenjuje sve postojeće oznake, max 20)
reminder_at	string	ISO 8601 datum-vreme (prosledi razmak da obrišeš)

Postavljanje status na done takođe beleži kada i kako je zadatak završen.

complete_task (Pro i Ultra)

Prečica za označavanje zadatka kao završenog.

Parametar	Tip	Opis
task_id	string	Obavezno, UUID zadatka

Vraća grešku ako zadatak ne postoji ili je već završen.

update_event (Pro i Ultra)

Ažurira jedno ili više polja na postojećem događaju. Menjaju se samo polja koja priložiš.

Parametar	Tip	Opis
event_id	string	Obavezno, UUID događaja
title	string	Novi naslov
description	string	Novi opis (prosledi razmak da obrišeš)
start_at	string	Novo vreme početka (ISO 8601)
end_at	string	Novo vreme završetka (ISO 8601)
location	string	Nova lokacija (prosledi razmak da obrišeš)
status	string	confirmed, tentative ili cancelled
tags	string	Oznake razdvojene zarezima (zamenjuje sve postojeće oznake, max 20)
is_all_day	string	"true" ili "false"
reminder_minutes	string	Minuti pre događaja razdvojeni zarezima (npr. 15,60)
attendees	string	Imena ili imejlovi razdvojeni zarezima
recurrence_rule	string	RRULE string (prosledi razmak da obrišeš)

delete_note (Pro i Ultra)

Briše belešku. Ovo takođe briše sve zadatke i događaje koji su kreirani iz ove beleške.

Parametar	Tip	Opis
note_id	string	Obavezno, UUID beleške

delete_task (Pro i Ultra)

Briše zadatak.

Parametar	Tip	Opis
task_id	string	Obavezno, UUID zadatka

delete_event (Pro i Ultra)

Briše događaj.

Parametar	Tip	Opis
event_id	string	Obavezno, UUID događaja

undo_change_log_entry (Pro i Ultra)

Poništava jednu praćenu izmenu - vraća polje na njegovu vrednost pre te izmene, bez obzira na to da li je izmenu napravila veštačka inteligencija (iz snimka nastavka) ili ti direktno.

Parametar	Tip	Opis
entity	string	Obavezno, notes, tasks ili events
entity_id	string	Obavezno, UUID stavke
entry_id	string	Obavezno, id unosa promene iz get_change_log

Vraća: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Poništavanje istog unosa dvaput vraća grešku - već je poništen.

restore_entity (Pro i Ultra)

Vraća obrisanu ili arhiviranu belešku, zadatak ili događaj.

Parametar	Tip	Opis
entity	string	Obavezno, notes, tasks ili events
entity_id	string	Obavezno, UUID stavke

Vraća: vraćenu stavku kao JSON.

create_tag (Pro i Ultra)

Kreira novu oznaku, ili pretvara postojeću automatski predloženu oznaku u trajnu.

Parametar	Tip	Opis
tag	string	Obavezno, 1-50 karaktera (čuva se malim slovima)
category	string	Opciono

set_tag_pinned (Pro i Ultra)

Kači ili otkači oznaku tako da se sortira na vrh tvoje liste oznaka.

Parametar	Tip	Opis
tag	string	Obavezno
pinned	bool	Obavezno

Oznake koje sadrže / karakter ne mogu se zakačiti.

delete_tag (Pro i Ultra)

Uklanja oznaku. Može se vratiti pomoću restore_tag.

Parametar	Tip	Opis
tag	string	Obavezno

restore_tag (Pro i Ultra)

Vraća obrisanu oznaku.

Parametar	Tip	Opis
tag	string	Obavezno

Ograničenja unosa

Polje	Maks. dužina	Koristi se u
title	200 karaktera	create/update note, task, event
description	2.000 karaktera	create/update task, event
summary	1.000 karaktera (tvrdo)	create/update note. Uključeno u upite izveštaja, drži se kratkim radi kontrole troška tokena
transcript	zavisi od plana: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000	create/update note. Dugačko telo, nije u izveštajima
location	200 karaktera	create/update event
tags	20 oznaka	create/update note, task, event
search query	500 karaktera	search
audio_base64 (dekodirano)	50 MB	process_note

Ako prekoračiš ograničenje, alat vraća poruku o grešci poput "title too long (max 200 chars, got 250)".

Rukovanje greškama

Svi alati vraćaju JSON. Greške koriste ovaj format:

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

Uobičajene greške:

Greška	Kada
"MCP access is read-only..."	Alat za pisanje pozvan u režimu samo za čitanje
"Invalid note_id format"	String koji nije UUID prosleđen kao ID
"Note not found"	ID ne postoji ili pripada drugom korisniku
"Task not found or already completed"	complete_task na nepostojećem ili već završenom zadatku
"title too long (max 200 chars, got N)"	Prekoračeno ograničenje unosa
"Too many tags (max 20)"	Prosleđeno više od 20 oznaka

Greške na HTTP nivou:

Kod	Značenje
401	Nevažeći ili nedostajući Bearer token
403	MCP onemogućen ili plan ne dozvoljava MCP
429	Prekoračeno ograničenje brzine (5 zahteva/s, nalet do 20)

Primeri upotrebe

Svi primeri koriste cURL sa MCP JSON-RPC protokolom. Zameni YOUR_TOKEN svojim tokenom za povezivanje.

Čitanje podataka

# 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}}}'

Pisanje podataka (Pro i 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>"}}}'

Uspešan odgovor izgleda ovako:

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

napomena

Alati za pisanje i ažuriranje vraćaju minimalne odgovore sa samo id, title i status. Da dobiješ pune detalje (oznake, prioritet, rok itd.) nakon pisanja, napravi naknadni poziv za čitanje poput get_tasks ili get_note.

Upravljanje tokenom

Radnja	Kako
Prikaži token	iPhone Podešavanja → Integracije → AI agenti (ili veb Podešavanja → AI agenti), dodirni ikonicu oka
Kopiraj token	Dodirni ikonicu kopiranja pored tokena
Ponovo generiši	Dodirni Ponovo generiši i potvrdi. Stari token prestaje da radi odmah i sve aktivne sesije se prekidaju
Promeni režim	Samo Ultra - prebacuj između Samo za čitanje i Čitanje + pisanje. Na Pro je režim fiksiran na Čitanje + pisanje
Onemogući	Dodirni Onemogući i potvrdi. Token se briše i sve veze se zaustavljaju. Možeš ponovo omogućiti kasnije (biće izdat novi token)

Šta možeš da tražiš od svog AI agenta

Kada je povezan, pitaj svoj AI alat stvari poput:

Pregledaj svoj dan:

• „Na čemu sam radio danas?"
• „Prikaži mi moje beleške iz ove nedelje"
• „Koji su zadaci zakasneli?"

Upravljaj zadacima:

• „Kreiraj zadatak: pregledati kvartalni izveštaj, visok prioritet, rok petak"
• „Označi Figma zadatak kao završen"
• „Na kojim zadacima radim?"

Pretraži i analiziraj:

• „Pronađi sve beleške o marketing strategiji"
• „Koje događaje imam sledeće nedelje?"
• „Rezimiraj moje dnevne izveštaje iz prošle nedelje"

Planiraj unapred:

• „Kreiraj događaj: sastanak tima sutra u 10h"
• „Šta je na mom kalendaru ove nedelje?"
• „Prikaži mi moje najbolje oznake - na šta trošim najviše vremena?"

AI agent ima pun pristup tvojim beleškama, zadacima, događajima i izveštajima. Može da čita, kreira, ažurira i briše podatke i da odgovara na složena pitanja kombinovanjem informacija iz više alata.

Važne napomene

• Dva načina za kreiranje beleški - create_note kreira običnu tekstualnu belešku trenutno (bez AI analize). process_note pokreće pun AI proces (isto kao snimanje u aplikaciji) - analizira tekst, izvlači zadatke i događaje, generiše oznake i ugradnje. Koristi process_note kada želiš da TellDone razmišlja umesto tebe.
• Bez sinhronizacije integracija - stavke kreirane ili ažurirane preko MCP-a ne pokreću webhook automatizacije ni sinhronizacije integracija (Todoist, Notion). Pojaviće se u tvojim aplikacijama pri sledećoj sinhronizaciji.
• Semantička pretraga zavisi od alata - beleške kreirane pomoću process_note dobijaju ugradnje i pojavljuju se u semantičkoj pretrazi. Beleške kreirane pomoću create_note ne dobijaju ugradnje, pa se pojavljuju samo u tekstualnoj pretrazi.
• Odgovori pisanja su minimalni - alati za kreiranje i ažuriranje vraćaju samo id, title i status. Da dobiješ sva polja nakon pisanja, napravi naknadni poziv za čitanje.
• Filteri datuma koriste UTC - parametri date_from/date_to porede se kao UTC vremenske oznake. Za korisnike u vremenskim zonama koje nisu UTC, granični datumi mogu uključiti ili isključiti stavke iz susednih dana.
• Ograničenje brzine - 5 zahteva u sekundi, sa naletima do 20. Za grupne operacije, tempiraj svoje zahteve.

Bezbednost

• Svaki korisnik dobija jedinstven 384-bitni token za povezivanje
• Tvoj token se opoziva trenutno kada onemogućiš MCP ili ga ponovo generišeš
• Svi podaci su strogo izolovani na tvoj nalog - tvoj agent može pristupiti samo tvojim podacima
• Svaki zahtev je ograničen na tvog korisnika - ne postoji način da agent pristupi podacima drugog korisnika
• Veza koristi HTTPS sa ograničenjem brzine (5 zahteva/s, nalet do 20)
• OAuth veze koriste PKCE sa autorizacionim kodovima za jednokratnu upotrebu i kratkotrajnim tokenima pristupa - vezu možeš opozvati u bilo kom trenutku iz aplikacije

Za tehnički detaljan pregled - endpoint-i za otkrivanje, vek trajanja tokena, pun OAuth tok - pogledaj našu referencu konektora otvorenog koda na github.com/exp78/telldone-mcp, ili upituj https://api.telldone.app/.well-known/oauth-protected-resource direktno.

Privatnost i tok podataka

Tvoji podaci se prenose povezanom AI alatu samo kada mu izričito zatražiš da uradi nešto - na primer, kada ga zamoliš da pročita ili izmeni tvoje beleške. Alat prima samo odgovore na konkretne pozive koje pravi, ograničene na dozvole koje si odobrio. Ti si u kontroli: promeni režim čitanja/pisanja svog plana, suzi OAuth opsege koje odobravaš pri prijavi, ili ponovo generiši i onemogući svoj bearer token, sve iz Podešavanja. Pogledaj Politiku privatnosti za pune detalje, ili se obrati na support@telldone.app sa pitanjima.

Rešavanje problema

Simptom	Uzrok / rešenje
Stranica OAuth saglasnosti kaže „Wrong email or password"	Koristi imejl i lozinku svog TellDone naloga (onaj kojim se prijavljuješ u aplikaciju). Ako tvoj nalog ima samo Apple ili Google prijavu i nema lozinku, koristi bearer-token metod umesto toga.
Povezano, ali veštačka inteligencija ne može ništa da kreira ili uređuje	Tvoj plan ili režim je samo za čitanje, ili vezi nisu odobreni opsezi pisanja - poveži ponovo i odobri ih, ili proveri svoj režim u Podešavanjima.
Greška „Insufficient scope" iz alata	OAuth vezi nije odobren taj opseg. Poveži ponovo i odobri dozvolu koja alatu treba.
Alati se uopšte ne pojavljuju	MCP nije omogućen na tvom nalogu (Podešavanja → AI agenti), ili tvoj plan ne uključuje MCP.
Moj klijent mi dozvoljava samo biranje iz liste konektora, a TellDone nije na njoj	TellDone još nije u direktorijumu konektora nijednog klijenta - dodaj ga kao prilagođeni konektor sa MCP URL-om, ili koristi bearer-token metod.

Pogledaj i

• Webhook automatizacije - automatski šalji podatke spoljnim servisima
• Todoist - posvećena dvosmerna sinhronizacija zadataka
• Notion - posvećena Notion integracija