MCP pristup (AI agenti)

Šta se nedavno promijenilo

MCP je sada potpuno dostupan na iPhoneu (pored web aplikacije). iPhone ekran preslikava web ekran i uključuje iste isječke za postavljanje za sve podržane AI klijente.

Plan Pro i viši

MCP pristup zahtijeva plan Pro ili Ultra. Oba plana dobijaju potpun pristup čitanje + pisanje (27 alata) i mogu se prebaciti u način 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 s tvojim TellDone podacima. Kada se poveže, tvoj AI agent može čitati tvoje bilješke, zadatke, događaje, izvještaje, oznake i historiju izmjena - i kreirati, ažurirati, brisati i vraćati stavke. Ukupno ima 27 alata: 10 za čitanje podataka i 17 za pisanje.

Dostupno i u iPhone aplikaciji (Postavke → Integracije → AI agenti) i u web aplikaciji (Postavke → AI agenti).

Na iPhoneu, Postavke → Integracije → AI agenti otvara ekran za postavljanje MCP-a s tvojim pristupnim tokenom zadano maskiranim:

A na webu:

Dva načina povezivanja

Postoje dva načina za autentifikaciju AI klijenta i oba su potpuno podržana:

1. OAuth 2.1 (preporučeno) - standardni "Sign in with TellDone" tok saglasnosti. To je ono što koriste UI konektora Claude Desktopa i Claude.ai. Bez kopiranja tokena - prijaviš se svojim TellDone računom i odobriš dozvole koje klijent traži.
2. Bearer token - kopiraj svoj lični pristupni token iz Postavki i zalijepi 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 s MCP URL-om, zatim se prijavi
Claude Code (CLI)	Bilo koji - claude mcp add te vodi kroz OAuth u tvom pregledniku ili dodaj Bearer zaglavlje za metodu s tokenom
Skripte ili tvoj vlastiti kod	Bearer token - najjednostavnije za automatizaciju
Klijent koji podržava samo biranje iz direktorija izlistanih konektora	Za sada koristi bearer-token ili mcp-remote most - TellDone još nije ni u jednom direktoriju konektora

Zahtjevi plana

Plan	MCP
Free	Zaključano
Basic	Zaključano
Pro	Read + Write (27 tools) - can toggle to Read-only mode
Ultra	Read + Write (27 tools) - can toggle to Read-only mode

Ekran u aplikaciji

Ekran AI agenti ima tri stanja ovisno o tvom planu i tome je li MCP uključen.

Zaključano (Free i Basic)

Ako si na planu Free ili Basic, ekran objašnjava šta MCP radi i pokazuje dugme Upgrade. Dodir otvara paywall gdje se možeš prebaciti 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 pokazuje kratak sažetak onoga što tvoj plan može (broj alata, način pristupa, kvote) i dugme Enable. Dodirni ga da generišeš svoj token za povezivanje i pokreneš integraciju.

Omogućeno

Kada je omogućeno, ekran pokazuje sve što ti treba da povežeš AI klijenta:

• Prekidač načina - na Ultra možeš prebacivati između Samo za čitanje i Čitanje + Pisanje. Na Pro je način fiksiran na Čitanje + Pisanje.
• Red Access Token s prekidačem oka za otkrivanje ili skrivanje tokena i dugmetom za kopiranje.
• Birač postavljanja s karticama za Claude Code, Cursor, Windsurf i Other. Odgovarajući isječak koda pojavljuje se ispod kartica - samo ga kopiraj i zalijepi u svog AI klijenta.
• Dugme Regenerate - odmah rotira token i prekida vezu bilo koje aktivne sesije koja koristi stari.
• Dugme Disable - isključuje MCP i briše token. Možeš ga ponovo omogućiti kasnije, ali će biti izdat novi token.

savjet

Drži svoj token za povezivanje privatnim. Bilo ko s tokenom može pristupiti tvojim TellDone podacima. Koristi Regenerate ako ikada posumnjaš da je token procurio.

Kako omogućiti

MCP možeš konfigurisati s bilo koje platforme:

• iPhone: Postavke → Integracije → AI agenti (MCP)
• Web: app.telldone.app → Postavke → AI agenti

Koraci:

1. Dodirni Enable.
2. Odaberi svoj način pristupa (samo Ultra - Pro je uvijek Čitanje + Pisanje).
3. Otkrij i kopiraj svoj token koristeći ikone oka i kopiranja.
4. Odaberi svoj alat u sekciji Setup (Claude Code, Cursor, Windsurf ili Other).
5. Zalijepi isječ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 računom umjesto da kopiraš token okolo.

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

Claude Desktop / Cowork

1. U klijentu odaberi Add custom connector.
2. Unesi URL servera: https://api.telldone.app/mcp/user
3. Klijent otvara TellDoneovu stranicu saglasnosti u tvom pregledniku. Vidjet ćeš koja aplikacija traži pristup, tačne dozvole koje želi i formu za prijavu.
4. Prijavi se svojim TellDone email računom i lozinkom, zatim klikni Allow.
5. Klijent automatski prima pristupni token i povezuje se - bez kopiranja tokena.

napomena

Prijava na stranici saglasnosti koristi tvoj TellDone email račun i lozinku. Ako tvoj račun ima samo Apple ili Google Sign In (bez postavljene lozinke), za sada koristi metodu s bearer-tokenom ispod.

Claude Code

OAuth (otvara prijavu u pregledniku):

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 Codea i odaberi Authenticate da otvoriš prijavu u pregledniku. Nakon toga osvježava tvoj pristupni token umjesto tebe - nema šta održavati.

Bearer token (bez preglednika, dobro za headless postavke):

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

Uzmi svoj YOUR_TOKEN iz aplikacije: Postavke → Integracije → AI agenti → Copy token (pogledaj Kako omogućiti iznad).

Povezivanje putem bearer tokena

Za klijente bez ugrađene OAuth podrške - Cursor, Windsurf i druge - zalijepi svoj lični pristupni token direktno u konfiguraciju klijenta. Zamijeni YOUR_TOKEN tokenom iz svojih postavki u svim primjerima 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" }
    }
  }
}

Other

Koristi ove isječke za klijente koje birač u aplikaciji grupiše pod Other.

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 endpoint https://api.telldone.app/mcp/user/mcp s autorizacionim zaglavljem Bearer YOUR_TOKEN.

Alternativno auth zaglavlje

Ako tvoj klijent ili proxy rezervira zaglavlje Authorization (na primjer, neki Smithery-stil gatewayovi), pošalji token u X-MCP-Token: YOUR_TOKEN umjesto toga. Oba zaglavlja rade; ako su oba prisutna, Authorization pobjeđuje.

Testiranje tvoje veze

Možeš provjeriti radi li tvoj token 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}'

Uspješan odgovor izlistava sve dostupne alate.

Dozvole (scopes)

OAuth veze su ograničene po opsegu - tokom prijave vidiš tačno šta klijent traži i izričito to odobravaš.

Scope	Omogućava aplikaciji da...
notes:read	Čita tvoje bilješke, pretražuje, otvara potpune detalje bilješke
notes:write	Kreira, uređuje, briše bilješke (i pokreće proces glasovne bilješ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, sedmične, mjesečne i godišnje izvješ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 nisi tu (izdaje refresh token pa se ne moraš prijavljivati svaku sesiju)

Opsezi su gornja granica, a ne garancija - veza samo s notes:read ne može pozvati alat za pisanje bez obzira šta od nje tražiš. Tvoj plan je druga kapija povrh opsega.

Veze s bearer-tokenom nisu ograničene pojedinačno po opsegu - njima upravlja samo način čitanja/pisanja tvog plana.

Šta možeš raditi

Alati za čitanje (10) - Pro i Ultra

Alat	Šta radi
get_notes	Izlistava bilješke s filterima (oznake, raspon datuma, pretraga teksta)
get_note	Prikazuje jednu bilješku s njenim podređenim zadacima, događajima i potpunom transkripcijom
get_notes_full	Dobija više bilješki s ugrađenim zadacima i događajima u jednom pozivu
get_tasks	Izlistava zadatke filtrirane po statusu (za uraditi, gotovo, sve), oznakama ili datumima
get_events	Izlistava događaje u kalendaru, filtrira po rasponu datuma
get_reports	Čita tvoje dnevne, sedmične, mjesečne i godišnje izvještaje (potpuni markdown)
get_tags	Prikazuje sve tvoje oznake sortirane po korištenju
get_profile	Prikazuje informacije o tvom računu i statistiku korištenja
search	Pretražuje kroz bilješke, zadatke i događaje (tekstualna + semantička pretraga za bilješke)
get_change_log	See the edit history of a note, task, or event, and whether each edit has been undone

savjet

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

Alati za pisanje (17) - Pro i Ultra

Alat	Šta radi
process_note	Potpuni AI proces - pošalji tekst ili audio, dobij nazad bilješku sa zadacima, događajima i oznakama
create_note	Dodaje običnu tekstualnu bilješku (bez AI analize)
create_task	Dodaje zadatak s prioritetom, rokom, podsjetnikom i oznakama
create_event	Dodaje događaj u kalendaru s datumom, vremenom, lokacijom, podsjetnicima, učesnicima i ponavljanjem
update_note	Mijenja naslov bilješke, sažetak, tip, oznake, prioritet ili status
update_task	Mijenja naslov zadatka, opis, prioritet, rok, podsjetnik, oznake ili status
complete_task	Označava zadatak kao gotov
update_event	Mijenja detalje događaja, vrijeme, lokaciju, podsjetnike, učesnike, ponavljanje, oznake ili status
delete_note	Briše bilješku i sve njene povezane zadatke i događaje
delete_task	Briše zadatak
delete_event	Briše događaj
undo_change_log_entry	Undo a single tracked edit - AI-made or your own - restoring the field's prior value
restore_entity	Bring back a deleted or archived note, task, or event
create_tag	Create a new tag, or turn an auto-suggested tag into a permanent one
set_tag_pinned	Pin or unpin a tag so it sorts to the top
delete_tag	Remove a tag (can be restored with restore_tag)
restore_tag	Bring back a deleted tag

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

Referenca alata

get_notes

Izlistava bilješke s opcionalnim filtriranjem. Filteri datuma koriste recorded_at (kada si snimio glasovnu bilješku), a ne created_at.

Parametar	Tip	Zadano	Opis
limit	int	20	Broj bilješki za vratiti (maks. 50)
offset	int	0	Preskoči ovoliko bilješki (za paginaciju, maks. 10000)
tags	string	-	Filtriraj po oznakama, odvojeno zarezom (podudara bilo koju)
search	string	-	Pretraga teksta po naslovu i sažetku
date_from	string	-	Početni datum, YYYY-MM-DD (uključivo)
date_to	string	-	Krajnji datum, YYYY-MM-DD (isključivo)
standalone_only	bool	false	When true, hides follow-up notes (notes attached to a parent note/task/event) and returns only standalone notes

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

get_note

Dobija jednu bilješku s njenom potpunom transkripcijom i svim povezanim zadacima i događajima.

Parametar	Tip	Opis
note_id	string	UUID bilješke

Vraća: bilješku s title, summary, transcript, type, tags, priority, status, metadata, created_at, plus nizovi tasks[] i events[].

Also returns transcript_speakers (speaker-labeled transcript turns, for meetings with several speakers - null otherwise), speaker_count (null unless the recording was split by speaker), and parent_note_id/parent_task_id/parent_event_id (set when this note is a follow-up edit of another item). Each tasks[]/events[] entry also includes reminders_at/recurrence_rule (tasks) or reminder_minutes/attendees/recurrence_rule (events).

get_notes_full

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

Parametar	Tip	Zadano	Opis
limit	int	10	Broj bilješki (maks. 20)
offset	int	0	Preskoči ovoliko bilješki
tags	string	-	Filtriraj po oznakama
date_from	string	-	Početni datum, YYYY-MM-DD
date_to	string	-	Krajnji datum, YYYY-MM-DD
standalone_only	bool	false	When true, hides follow-up notes (notes attached to a parent note/task/event) and returns only standalone notes

get_tasks

Izlistava zadatke s filtriranjem.

Parametar	Tip	Zadano	Opis
status	string	"todo"	Filter: todo, done ili all
limit	int	30	Broj zadataka (maks. 100)
offset	int	0	Preskoči ovoliko zadataka
tags	string	-	Filtriraj po oznakama, odvojeno zarezom
date_from	string	-	Početni datum, YYYY-MM-DD (filtrira po roku; zadaci bez roka su isključeni)
date_to	string	-	Krajnji datum, YYYY-MM-DD (filtrira po roku; zadaci bez roka su isključeni)

Returns: list of tasks with id, title, description, status, priority, tags, deadline, reminder_at, reminders_at, completed_at, completed_by, source, created_at. reminder_at mirrors the first entry of reminders_at for backward compatibility - use reminders_at to see all of a task's reminders.

get_events

Izlistava događaje u kalendaru s filtriranjem po rasponu datuma.

Parametar	Tip	Zadano	Opis
limit	int	30	Broj događaja (maks. 100)
offset	int	0	Preskoči ovoliko događaja
date_from	string	-	Početni datum, YYYY-MM-DD (filtrira po vremenu početka događaja)
date_to	string	-	Krajnji datum, YYYY-MM-DD

Returns: list of events with id, title, description, status, start_at, end_at, location, is_all_day, tags, note_id, reminder_minutes, attendees, recurrence_rule, created_at.

get_reports

Dobija tvoje AI izvještaje s potpunim markdown sadržajem.

Parametar	Tip	Zadano	Opis
report_type	string	"daily"	Tip: daily, weekly, monthly ili yearly
limit	int	5	Broj izvještaja (maks. 10)

Vraća: listu izvještaja s id, type, period_start, period_end, content_md, created_at.

napomena

Mjesečni izvještaji mogu imati 3.000-5.000 riječi. Koristi limit=1 ako tvoj AI alat ima uzak kontekstni prozor.

get_tags

Dobija sve tvoje oznake, sortirane prvo po prikvačenim, zatim po broju korištenja.

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

get_profile

Dobija informacije o tvom računu i statistiku korištenja.

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

search

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

Parametar	Tip	Zadano	Opis
query	string	obavezno	Tekst pretrage (maks. 500 znakova)
limit	int	20	Maks. rezultata po tipu (maks. 20)
semantic	bool	true	Uključi semantičku pretragu za bilješ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

See the edit history of a note, task, or event - every AI-made follow-up edit and every manual edit you made yourself, newest first.

Parameter	Type	Default	Description
entity	string	required	notes, tasks, or events
entity_id	string	required	The item's UUID
include_manual	bool	false	Also include your own manual edits, not just AI-made ones

Returns: list of change entries with id (use this as entry_id for undo), field_name, old_value, new_value, source (follow_up, smart_context, or manual), origin_note_id, edited_at, and reverted_at (set once undone).

process_note (Pro i Ultra)

Potpuni AI proces - radi isto kao snimanje u aplikaciji. Pošalji tekst ili audio i TellDone će transkribovati, analizirati uz AI i kreirati strukturiranu bilješku s izdvojenim zadacima, događajima, oznakama i embeddinzima.

Ovaj alat je asinhroni: vraća odmah s audio_id i obrađuje u pozadini. Rezultati stižu putem sinhronizacije u realnom vremenu na tvoje povezane uređaje ili možeš ispitivati s get_notes().

Parametar	Tip	Opis
text	string	Tekst za analizu (preskače transkripciju ako nema audija)
audio_base64	string	Base64-kodirana audio datoteka (do 50MB, pokreće transkripciju)
audio_format	string	m4a, ogg, wav, mp3, aac ili webm (zadano: m4a)
parent_task_id	string	UUID zadatka za koji je ovo naknadni snimak
parent_note_id	string	UUID bilješke za koju je ovo naknadni snimak
parent_event_id	string	UUID događaja za koji je ovo naknadni snimak

Moraš navesti ili text ili audio_base64 (ili oboje - audio ima prioritet za transkripciju).

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

napomena

process_note podliježe kvotama tvog plana (otpremanja dnevno, bilješke mjesečno, maks. dužina teksta). Koristi get_profile da provjeriš svoje trenutno korištenje.

create_note (Pro i Ultra)

Kreira običnu tekstualnu bilješku trenutno. Ne pokreće AI analizu - ne izdvajaju se zadaci ni događaji. Za potpunu AI analizu s izdvajanjem zadataka/događaja, koristi process_note umjesto toga.

Parametar	Tip	Limit	Opis
title	string	200 znakova	Obavezno
summary	string	1000 znakova	Opcionalno. Kratak najavni tekst (1-3 rečenice). Uključeno u upite izvještaja, pa neka bude sažeto
transcript	string	prema planu	Opcionalno. Duže tijelo prikazano u detaljima bilješke. Nije uključeno u izvještaje. Limiti: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000 znakova
type	string	-	Opcionalno. task, idea, info (zadano), status, meeting, event ili reflection
tags	string	20 oznaka	Odvojeno zarezom, opcionalno

create_task (Pro i Ultra)

Kreira novi zadatak.

Parametar	Tip	Limit	Opis
title	string	200 znakova	Obavezno
description	string	2000 znakova	Opcionalno
priority	string	-	low, medium (zadano) ili high
deadline	string	-	YYYY-MM-DD, opcionalno
reminder_at	string	-	ISO 8601 datetime (npr. 2026-04-15T09:00:00Z), opcionalno
tags	string	20 oznaka	Odvojeno zarezom, opcionalno
note_id	string	-	UUID za povezivanje zadatka s nadređenom bilješkom, opcionalno

create_event (Pro i Ultra)

Kreira događaj u kalendaru.

Parametar	Tip	Limit	Opis
title	string	200 znakova	Obavezno
start_at	string	-	ISO 8601 datetime, obavezno
end_at	string	-	ISO 8601 datetime (zadano: početak + 1 sat)
description	string	2000 znakova	Opcionalno
location	string	200 znakova	Opcionalno
is_all_day	bool	-	Zadano: false
tags	string	20 oznaka	Odvojeno zarezom, opcionalno
reminder_minutes	string	-	Minute prije događaja odvojene zarezom (npr. 15,60), opcionalno
attendees	string	-	Imena ili emailovi odvojeni zarezom, opcionalno
recurrence_rule	string	-	RRULE string (npr. FREQ=WEEKLY;BYDAY=MO,WE,FR), opcionalno
note_id	string	-	UUID za povezivanje događaja s nadređenom bilješkom, opcionalno

update_note (Pro i Ultra)

Ažurira jedno ili više polja na postojećoj bilješci. Mijenjaju se samo polja koja navedeš.

Parametar	Tip	Opis
note_id	string	Obavezno, UUID bilješke
title	string	Novi naslov (maks. 200 znakova)
summary	string	Novi sažetak (maks. 1000 znakova, proslijedi razmak " " da obrišeš)
transcript	string	Nova transkripcija (limit prema planu, proslijedi razmak " " da obrišeš)
type	string	task, idea, info, status, meeting, event ili reflection
tags	string	Oznake odvojene zarezom (zamjenjuje sve postojeće oznake, maks. 20)
priority	string	low, medium ili high
status	string	active ili archived

oprez

Za bilješke kreirane glasovnim procesom, transcript je originalni izlaz pretvaranja govora u tekst. Prepisivanje zamjenjuje kanonski izvor - razmisli o dodavanju umjesto toga ako želiš sačuvati original.

update_task (Pro i Ultra)

Ažurira jedno ili više polja na postojećem zadatku. Mijenjaju se samo polja koja navedeš.

Parametar	Tip	Opis
task_id	string	Obavezno, UUID zadatka
title	string	Novi naslov
description	string	Novi opis (proslijedi razmak " " da obrišeš)
priority	string	low, medium ili high
deadline	string	YYYY-MM-DD (proslijedi razmak da obrišeš)
status	string	todo ili done
tags	string	Oznake odvojene zarezom (zamjenjuje sve postojeće oznake, maks. 20)
reminder_at	string	ISO 8601 datetime (proslijedi razmak da obrišeš)

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

complete_task (Pro i Ultra)

Prečica za označavanje zadatka kao gotovog.

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. Mijenjaju se samo polja koja navedeš.

Parametar	Tip	Opis
event_id	string	Obavezno, UUID događaja
title	string	Novi naslov
description	string	Novi opis (proslijedi razmak da obrišeš)
start_at	string	Novo vrijeme početka (ISO 8601)
end_at	string	Novo vrijeme završetka (ISO 8601)
location	string	Nova lokacija (proslijedi razmak da obrišeš)
status	string	confirmed, tentative ili cancelled
tags	string	Oznake odvojene zarezom (zamjenjuje sve postojeće oznake, maks. 20)
is_all_day	string	"true" ili "false"
reminder_minutes	string	Minute prije događaja odvojene zarezom (npr. 15,60)
attendees	string	Imena ili emailovi odvojeni zarezom
recurrence_rule	string	RRULE string (proslijedi razmak da obrišeš)

delete_note (Pro i Ultra)

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

Parametar	Tip	Opis
note_id	string	Obavezno, UUID bilješ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 and Ultra)

Undo a single tracked edit - restores the field to its value before that edit, whether the edit was made by the AI (from a follow-up recording) or by you directly.

Parameter	Type	Description
entity	string	Required, notes, tasks, or events
entity_id	string	Required, the item's UUID
entry_id	string	Required, the change entry's id from get_change_log

Returns: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Undoing the same entry twice returns an error - it's already undone.

restore_entity (Pro and Ultra)

Bring back a deleted or archived note, task, or event.

Parameter	Type	Description
entity	string	Required, notes, tasks, or events
entity_id	string	Required, the item's UUID

Returns: the restored item as JSON.

create_tag (Pro and Ultra)

Create a new tag, or turn an existing auto-suggested tag into a permanent one.

Parameter	Type	Description
tag	string	Required, 1-50 characters (stored lowercase)
category	string	Optional

set_tag_pinned (Pro and Ultra)

Pin or unpin a tag so it sorts to the top of your tag list.

Parameter	Type	Description
tag	string	Required
pinned	bool	Required

Tags containing a / character can't be pinned.

delete_tag (Pro and Ultra)

Remove a tag. Can be brought back with restore_tag.

Parameter	Type	Description
tag	string	Required

restore_tag (Pro and Ultra)

Bring back a deleted tag.

Parameter	Type	Description
tag	string	Required

Limiti unosa

Polje	Maks. dužina	Koristi se u
title	200 znakova	create/update note, task, event
description	2.000 znakova	create/update task, event
summary	1.000 znakova (tvrdo)	create/update note. Uključeno u upite izvještaja, drži se kratkim da kontroliše cijenu tokena
transcript	prema planu: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000	create/update note. Duže tijelo, nije u izvještajima
location	200 znakova	create/update event
tags	20 oznaka	create/update note, task, event
search query	500 znakova	search
audio_base64 (dekodirano)	50 MB	process_note

Ako pređeš limit, alat vraća poruku greške 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 načinu samo za čitanje
"Invalid note_id format"	Ne-UUID string proslijeđ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čen limit unosa
"Too many tags (max 20)"	Navedeno 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 zahtjeva/s, prasak do 20)

Primjeri korištenja

Svi primjeri koriste cURL s MCP JSON-RPC protokolom. Zamijeni 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>"}}}'

Uspješ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 samo s id, title i status. Da dobiješ potpune detalje (oznake, prioritet, rok itd.) nakon pisanja, napravi naknadni poziv za čitanje poput get_tasks ili get_note.

Upravljanje tokenom

Akcija	Kako
Prikaži token	iPhone Postavke → Integracije → AI agenti (ili web Postavke → AI agenti), dodirni ikonu oka
Kopiraj token	Dodirni ikonu kopiranja pored tokena
Regeneriši	Dodirni Regenerate i potvrdi. Stari token odmah prestaje raditi i bilo koje aktivne sesije se prekidaju
Promijeni način	Samo Ultra - prebaci između Samo za čitanje i Čitanje + Pisanje. Na Pro je način fiksiran na Čitanje + Pisanje
Onemogući	Dodirni Disable i potvrdi. Token se briše i sve veze se prekidaju. Možeš ponovo omogućiti kasnije (bit će izdat novi token)

Šta možeš pitati svog AI agenta

Kada se poveže, pitaj svoj AI alat stvari poput:

Pregledaj svoj dan:

• "Na čemu sam danas radio?"
• "Pokaži mi moje bilješke iz ove sedmice"
• "Koji zadaci su zakašnjeli?"

Upravljaj zadacima:

• "Kreiraj zadatak: pregledaj kvartalni izvještaj, visok prioritet, rok petak"
• "Označi Figma zadatak kao gotov"
• "Na kojim zadacima radim?"

Pretraži i analiziraj:

• "Pronađi sve bilješke o marketing strategiji"
• "Koje događaje imam sljedeće sedmice?"
• "Sažmi moje dnevne izvještaje iz prošle sedmice"

Planiraj unaprijed:

• "Kreiraj događaj: timski standup sutra u 10h"
• "Šta imam u kalendaru ove sedmice?"
• "Pokaži mi moje top oznake - na šta trošim najviše vremena?"

AI agent ima potpuni pristup tvojim bilješkama, zadacima, događajima i izvještajima. Može čitati, kreirati, ažurirati i brisati podatke i odgovarati na složena pitanja kombinujući informacije iz više alata.

Važne napomene

• Dva načina kreiranja bilješki - create_note kreira običnu tekstualnu bilješku trenutno (bez AI analize). process_note pokreće potpuni AI proces (isto kao snimanje u aplikaciji) - analizira tekst, izdvaja zadatke i događaje, generiše oznake i embeddinge. Koristi process_note kada želiš da TellDone razmišlja umjesto tebe.
• Bez sinhronizacije integracija - stavke kreirane ili ažurirane putem MCP-a ne pokreću webhook automatizacije ni sinhronizacije integracija (Todoist, Notion). Pojavit će se u tvojim aplikacijama pri sljedećoj sinhronizaciji.
• Semantička pretraga ovisi o alatu - bilješke kreirane s process_note dobijaju embeddinge i pojavljuju se u semantičkoj pretrazi. Bilješke kreirane s create_note ne dobijaju embeddinge, 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 upoređuju se kao UTC vremenske oznake. Za korisnike u ne-UTC vremenskim zonama, granični datumi mogu uključiti ili isključiti stavke iz susjednih dana.
• Ograničenje brzine - 5 zahtjeva u sekundi, s praskovima do 20. Za masovne operacije, tempiraj svoje zahtjeve.

Sigurnost

• Svaki korisnik dobija jedinstven 384-bitni token za povezivanje
• Tvoj token se opoziva trenutno kada onemogućiš MCP ili ga regenerišeš
• Svi podaci su strogo izolovani na tvoj račun - tvoj agent može pristupiti samo tvojim podacima
• Svaki zahtjev je ograničen na tvog korisnika - ne postoji način da agent pristupi podacima drugog korisnika
• Veza koristi HTTPS s ograničavanjem brzine (5 zahtjeva/s, prasak do 20)
• OAuth veze koriste PKCE s jednokratnim autorizacionim kodovima i kratkotrajnim pristupnim tokenima - vezu možeš opozvati u bilo kojem trenutku iz aplikacije

Za tehnički detaljan pregled - endpointi otkrivanja, vijek trajanja tokena, potpuni OAuth tok - pogledaj našu open-source referencu konektora na github.com/exp78/telldone-mcp ili direktno upitaj https://api.telldone.app/.well-known/oauth-protected-resource.

Privatnost i tok podataka

Tvoji podaci se prenose povezanom AI alatu samo kada ga izričito zatražiš da nešto uradi - na primjer, kada ga zatražiš da pročita ili izmijeni tvoje bilješke. Alat prima samo odgovore na konkretne pozive koje napravi, ograničene na dozvole koje si odobrio. Ti si taj koji ima kontrolu: promijeni način čitanja/pisanja svog plana, suzi OAuth opsege koje odobravaš pri prijavi ili regeneriši i onemogući svoj bearer token, sve iz Postavki. Pogledaj Politiku privatnosti za sve detalje ili se javi na support@telldone.app s pitanjima.

Rješavanje problema

Simptom	Uzrok / rješenje
Stranica OAuth saglasnosti kaže "Wrong email or password"	Koristi svoj TellDone email račun i lozinku (onu kojom se prijavljuješ u aplikaciju). Ako tvoj račun ima samo Apple ili Google Sign In i bez lozinke, koristi metodu s bearer-tokenom umjesto toga.
Povezan, ali AI ne može ništa kreirati ni uređivati	Tvoj plan ili način je samo za čitanje ili vezi nisu odobreni opsezi pisanja - poveži se ponovo i odobri ih ili provjeri svoj način u Postavkama.
Greška "Insufficient scope" od alata	OAuth vezi nije odobren taj opseg. Poveži se ponovo i odobri dozvolu koja alatu treba.
Alati se uopšte ne pojavljuju	MCP nije omogućen na tvom računu (Postavke → AI agenti) ili tvoj plan ne uključuje MCP.
Moj klijent mi dozvoljava samo biranje iz liste konektora, a TellDonea nema na njoj	TellDone još nije u direktoriju konektora nijednog klijenta - dodaj ga kao prilagođeni konektor s MCP URL-om ili koristi metodu s bearer-tokenom.

Pogledaj također

• Webhook automatizacije - automatski šalji podatke vanjskim uslugama
• Todoist - namjenska dvosmjerna sinhronizacija zadataka
• Notion - namjenska Notion integracija