MCP pristup (AI agenti)

Što se nedavno promijenilo

MCP je sad potpuno dostupan na iPhoneu (uz web aplikaciju). Zaslon na iPhoneu zrcali onaj na webu i uključuje iste isječke za postavu za sve podržane AI klijente.

Plan Pro i viši

MCP pristup zahtijeva plan Pro ili Ultra. Oba plana dobivaju puni pristup za čitanje + pisanje (27 alata) i mogu se prebaciti u način samo za čitanje ako to žele.

MCP (Model Context Protocol) omogućuje ti da povežeš AI asistente za kodiranje i alate za automatizaciju izravno sa svojim TellDone podacima. Kad se poveže, tvoj AI agent može čitati tvoje bilješke, zadatke, događaje, izvještaje, oznake i povijest promjena - te stvarati, ažurirati, brisati i vraćati stavke. Ukupno postoji 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 zaslon za postavu MCP-a s tvojim pristupnim tokenom prema zadanome maskiranim:

A na webu:

Dva načina povezivanja

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

1. OAuth 2.1 (preporučeno) - standardni tijek pristanka "Sign in with TellDone". To koristi sučelje konektora u Claude Desktopu i Claude.ai. Bez kopiranja tokena - prijaviš se svojim TellDone računom i odobriš dopuštenja koja klijent traži.
2. Bearer token - kopiraj svoj osobni pristupni token iz Postavki i zalijepi ga u konfiguraciju svog klijenta. Najjednostavnije za skripte, CLI-jeve i klijente koji nemaju ugrađeni OAuth tijek.

Klijent	Preporučeno
Claude Desktop / Cowork	OAuth - dodaj prilagođeni konektor s MCP URL-om, zatim se prijavi
Claude Code (CLI)	Bilo koje - claude mcp add vodi te kroz OAuth u pregledniku ili dodaj Bearer zaglavlje za metodu s tokenom
Skripte ili tvoj vlastiti kôd	Bearer token - najjednostavnije za automatizaciju
Klijent koji podržava samo biranje iz direktorija navedenih konektora	Zasad 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	Čitanje + pisanje (27 alata) - može se prebaciti u način samo za čitanje
Ultra	Čitanje + pisanje (27 alata) - može se prebaciti u način samo za čitanje

Zaslon u aplikaciji

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

Zaključano (Free i Basic)

Ako si na planu Free ili Basic, zaslon objašnjava što MCP radi i prikazuje gumb Nadogradi. Dodir otvara plaćeni zid gdje možeš prijeći na Pro ili Ultra.

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

Ako si na Pro ili Ultra, ali još nisi uključio MCP, zaslon prikazuje kratak sažetak onoga što tvoj plan može (broj alata, način pristupa, kvote) i gumb Omogući. Dodirni ga da generiraš svoj token za povezivanje i pokreneš integraciju.

Omogućeno

Kad je omogućeno, zaslon prikazuje sve što ti treba za povezivanje AI klijenta:

• Prekidač načina - na Ultra možeš prebaciti između Samo za čitanje i Čitanje + pisanje. Na Pro je način fiksno Čitanje + pisanje.
• Redak Pristupni token s prekidačem u obliku oka za prikaz ili skrivanje tokena i gumbom za kopiranje.
• Birač postave s karticama za Claude Code, Cursor, Windsurf i Ostalo. Odgovarajući isječak koda pojavljuje se ispod kartica - samo ga kopiraj i zalijepi u svoj AI klijent.
• Gumb Ponovno generiraj - odmah rotira token i prekida sve aktivne sesije koje koriste stari.
• Gumb Onemogući - isključuje MCP i briše token. Kasnije ga možeš ponovno omogućiti, ali bit će izdan novi token.

savjet

Drži svoj token za povezivanje privatnim. Svatko s tokenom može pristupiti tvojim TellDone podacima. Upotrijebi Ponovno generiraj ako ikad posumnjaš da je token procurio.

Kako omogućiti

MCP možeš konfigurirati s bilo koje platforme:

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

Koraci:

1. Dodirni Omogući.
2. Odaberi svoj način pristupa (samo Ultra - Pro je uvijek Čitanje + pisanje).
3. Prikaži i kopiraj svoj token pomoću ikona oka i kopiranja.
4. Odaberi svoj alat u odjeljku Postava (Claude Code, Cursor, Windsurf ili Ostalo).
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.

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 odaberi Add custom connector.
2. Unesi URL poslužitelja: https://api.telldone.app/mcp/user
3. Klijent otvara TellDoneovu stranicu pristanka u tvom pregledniku. Vidjet ćeš koja aplikacija traži pristup, točna dopuštenja koja želi i obrazac za prijavu.
4. Prijavi se e-mailom i lozinkom svog TellDone računa, zatim klikni Allow.
5. Klijent automatski prima pristupni token i povezuje se - nema tokena za kopiranje.

napomena

Prijava na stranici pristanka koristi e-mail i lozinku tvog TellDone računa. Ako tvoj račun ima samo Apple ili Google Sign In (bez postavljene lozinke), zasad 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 tijek, ali te ne prijavljuje pri prvom pozivu - pokreni /mcp unutar Claude Codea i odaberi Authenticate da otvoriš prijavu u pregledniku. Nakon toga sam osvježava tvoj pristupni token - nema ništa za održavati.

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

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

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

Povezivanje putem bearer tokena

Za klijente bez ugrađene OAuth podrške - Cursor, Windsurf i drugi - zalijepi svoj osobni pristupni token izravno 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" }
    }
  }
}

Ostalo

Koristi ove isječke za klijente koje birač u aplikaciji svrstava 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 točku https://api.telldone.app/mcp/user/mcp sa zaglavljem autorizacije Bearer YOUR_TOKEN.

Alternativno zaglavlje za autentifikaciju

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

Testiranje veze

Možeš provjeriti radi li tvoj token jednostavnom cURL naredbom:

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 navodi sve dostupne alate.

Dopuštenja (opsezi)

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

Opseg	Omogućuje aplikaciji da...
notes:read	Čita tvoje bilješke, pretražuje, otvara sve detalje bilješke
notes:write	Stvara, uređuje, briše bilješke (i pokreće tijek glasovne bilješke)
tasks:read / tasks:write	Čita / stvara, uređuje, dovršava i briše zadatke
events:read / events:write	Čita / stvara, uređuje i briše događaje
reports:read	Čita tvoje dnevne, tjedne, mjesečne i godišnje izvještaje
tags:read / tags:write	Navodi tvoje oznake / stvara i preimenuje oznake
profile:read	Čita tvoj profil i podatke o pretplati
offline_access	Ostaje povezan dok si odsutan (izdaje token za osvježavanje pa se ne moraš prijavljivati svaku sesiju)

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

Veze s bearer tokenom nemaju pojedinačne opsege - njima upravlja samo način čitanja/pisanja tvog plana.

Što možeš raditi

Alati za čitanje (10) - Pro i Ultra

Alat	Što radi
get_notes	Navodi bilješke s filtrima (oznake, raspon datuma, pretraga teksta)
get_note	Prikazuje jednu bilješku s njezinim podređenim zadacima, događajima i cijelim transkriptom
get_notes_full	Dohvaća više bilješki s ugrađenim zadacima i događajima u jednom pozivu
get_tasks	Navodi zadatke filtrirane po statusu (za obaviti, gotovo, sve), oznakama ili datumima
get_events	Navodi događaje u kalendaru, filtrira po rasponu datuma
get_reports	Čita tvoje dnevne, tjedne, mjesečne i godišnje izvještaje (cijeli markdown)
get_tags	Prikazuje sve tvoje oznake sortirane po upotrebi
get_profile	Prikazuje podatke o tvom računu i statistiku potrošnje
search	Pretražuje bilješke, zadatke i događaje (pretraga teksta + semantička pretraga za bilješke)
get_change_log	Prikazuje povijest uređivanja bilješke, zadatka ili događaja i je li svako uređivanje poništeno

savjet

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

Alati za pisanje (17) - Pro i Ultra

Alat	Što radi
process_note	Cijeli AI tijek - pošalji tekst ili audio, vrati bilješku sa zadacima, događajima i oznakama
create_note	Dodaj običnu tekstualnu bilješku (bez AI analize)
create_task	Dodaj zadatak s prioritetom, rokom, podsjetnikom i oznakama
create_event	Dodaj događaj u kalendar s datumom, vremenom, lokacijom, podsjetnicima, sudionicima i ponavljanjem
update_note	Promijeni naslov bilješke, sažetak, vrstu, oznake, prioritet ili status
update_task	Promijeni naslov zadatka, opis, prioritet, rok, podsjetnik, oznake ili status
complete_task	Označi zadatak gotovim
update_event	Promijeni detalje događaja, vrijeme, lokaciju, podsjetnike, sudionike, ponavljanje, oznake ili status
delete_note	Izbriši bilješku i sve njezine povezane zadatke i događaje
delete_task	Izbriši zadatak
delete_event	Izbriši događaj
undo_change_log_entry	Poništi pojedinačno praćeno uređivanje - koje je napravio AI ili ti sam - vraćajući prethodnu vrijednost polja
restore_entity	Vrati izbrisanu ili arhiviranu bilješku, zadatak ili događaj
create_tag	Stvori novu oznaku ili pretvori automatski predloženu oznaku u trajnu
set_tag_pinned	Prikvači ili otkvači oznaku da se sortira na vrh
delete_tag	Ukloni oznaku (može se vratiti pomoću restore_tag)
restore_tag	Vrati izbrisanu oznaku

Sve operacije pisanja i brisanja odmah se pojavljuju na tvojim povezanim uređajima (telefon, web aplikacija) putem sinkronizacije u stvarnom vremenu.

Referenca alata

get_notes

Navodi bilješke s neobaveznim filtriranjem. Filtri datuma koriste recorded_at (kad si snimio glasovnu bilješku), a ne created_at.

Parametar	Vrsta	Zadano	Opis
limit	int	20	Broj bilješki za vraćanje (najviše 50)
offset	int	0	Preskoči ovoliko bilješki (za straničenje, najviše 10000)
tags	string	-	Filtriraj po oznakama, odvojenima zarezom (podudara se s bilo kojom)
search	string	-	Pretraga teksta po naslovu i sažetku
date_from	string	-	Početni datum, YYYY-MM-DD (uključivo)
date_to	string	-	Završni datum, YYYY-MM-DD (isključivo)
standalone_only	bool	false	Kad je true, skriva naknadne bilješke (bilješke priložene nadređenoj bilješci/zadatku/događaju) i vraća samo samostalne bilješke

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

get_note

Dohvaća jednu bilješku s njezinim cijelim transkriptom i svim povezanim zadacima i događajima.

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

Također vraća transcript_speakers (izmjene transkripta označene govornikom, za sastanke s nekoliko govornika - inače null), speaker_count (null osim ako je snimka podijeljena po govorniku) i parent_note_id/parent_task_id/parent_event_id (postavljeno kad je ova bilješka naknadno uređivanje druge stavke). Svaki unos tasks[]/events[] također uključuje reminders_at/recurrence_rule (zadaci) ili reminder_minutes/attendees/recurrence_rule (događaji).

get_notes_full

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

Parametar	Vrsta	Zadano	Opis
limit	int	10	Broj bilješki (najviše 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	-	Završni datum, YYYY-MM-DD
standalone_only	bool	false	Kad je true, skriva naknadne bilješke (bilješke priložene nadređenoj bilješci/zadatku/događaju) i vraća samo samostalne bilješke

get_tasks

Navodi zadatke s filtriranjem.

Parametar	Vrsta	Zadano	Opis
status	string	"todo"	Filtar: todo, done ili all
limit	int	30	Broj zadataka (najviše 100)
offset	int	0	Preskoči ovoliko zadataka
tags	string	-	Filtriraj po oznakama, odvojenima zarezom
date_from	string	-	Početni datum, YYYY-MM-DD (filtrira po roku; zadaci bez roka se isključuju)
date_to	string	-	Završni datum, YYYY-MM-DD (filtrira po roku; zadaci bez roka se isključuju)

Vraća: popis zadataka s id, title, description, status, priority, tags, deadline, reminder_at, reminders_at, completed_at, completed_by, source, created_at. reminder_at zrcali prvi unos iz reminders_at radi kompatibilnosti unatrag - koristi reminders_at da vidiš sve podsjetnike zadatka.

get_events

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

Parametar	Vrsta	Zadano	Opis
limit	int	30	Broj događaja (najviše 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	-	Završni datum, YYYY-MM-DD

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

get_reports

Dohvaća tvoje izvještaje generirane AI-jem s cijelim markdown sadržajem.

Parametar	Vrsta	Zadano	Opis
report_type	string	"daily"	Vrsta: daily, weekly, monthly ili yearly
limit	int	5	Broj izvještaja (najviše 10)

Vraća: popis 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

Dohvaća sve tvoje oznake, sortirane prvo po prikvačenima, zatim po broju upotreba.

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

get_profile

Dohvaća podatke o tvom računu i statistiku potrošnje.

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 bilješke, zadatke i događaje odjednom. Za bilješke podržava i pretragu teksta i semantičku pretragu (pronalazi rezultate po značenju pomoću AI ugrađivanja).

Parametar	Vrsta	Zadano	Opis
query	string	obavezno	Tekst pretrage (najviše 500 znakova)
limit	int	20	Najviše rezultata po vrsti (najviše 20)
semantic	bool	true	Omogući semantičku pretragu za bilješke

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

Postavi semantic=false za bržu pretragu samo po tekstu.

get_change_log

Prikazuje povijest uređivanja bilješke, zadatka ili događaja - svako naknadno uređivanje koje je napravio AI i svako ručno uređivanje koje si napravio sam, najnovija prva.

Parametar	Vrsta	Zadano	Opis
entity	string	obavezno	notes, tasks ili events
entity_id	string	obavezno	UUID stavke
include_manual	bool	false	Uključi i tvoja vlastita ručna uređivanja, ne samo ona koja je napravio AI

Vraća: popis unosa promjena s id (koristi ga 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 kad je poništeno).

process_note (Pro i Ultra)

Cijeli AI tijek - radi jednako kao snimanje u aplikaciji. Pošalji tekst ili audio, a TellDone će transkribirati, analizirati pomoću AI-ja i stvoriti strukturiranu bilješku s izdvojenim zadacima, događajima, oznakama i ugrađivanjima.

Ovaj alat je asinkroni: vraća se odmah s audio_id i obrađuje u pozadini. Rezultati stižu putem sinkronizacije u stvarnom vremenu na tvoje povezane uređaje ili možeš provjeravati pomoću get_notes().

Parametar	Vrsta	Opis
text	string	Tekst za analizu (preskače transkripciju ako nije priložen audio)
audio_base64	string	Audiodatoteka kodirana u Base64 (do 50 MB, pokreće transkripciju)
audio_format	string	m4a, ogg, wav, mp3, aac ili webm (zadano: m4a)
parent_task_id	string	UUID zadatka kojem je ovo nastavak
parent_note_id	string	UUID bilješke kojoj je ovo nastavak
parent_event_id	string	UUID događaja kojem je ovo nastavak

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 priložen audio.

napomena

process_note podliježe kvotama tvog plana (učitavanja na dan, bilješke po mjesecu, najveća duljina teksta). Koristi get_profile da provjeriš svoju trenutnu potrošnju.

create_note (Pro i Ultra)

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

Parametar	Vrsta	Ograničenje	Opis
title	string	200 znakova	Obavezno
summary	string	1000 znakova	Neobavezno. Kratak najavni tekst (1-3 rečenice). Uključen u upite izvještaja, pa neka bude sažeto
transcript	string	ovisi o planu	Neobavezno. Duže tijelo prikazano u detalju bilješke. Nije uključeno u izvještaje. Ograničenja: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000 znakova
type	string	-	Neobavezno. task, idea, info (zadano), status, meeting, event ili reflection
tags	string	20 oznaka	Odvojene zarezom, neobavezno

create_task (Pro i Ultra)

Stvara novi zadatak.

Parametar	Vrsta	Ograničenje	Opis
title	string	200 znakova	Obavezno
description	string	2000 znakova	Neobavezno
priority	string	-	low, medium (zadano) ili high
deadline	string	-	YYYY-MM-DD, neobavezno
reminder_at	string	-	ISO 8601 datum i vrijeme (npr. 2026-04-15T09:00:00Z), neobavezno
tags	string	20 oznaka	Odvojene zarezom, neobavezno
note_id	string	-	UUID za povezivanje zadatka s nadređenom bilješkom, neobavezno

create_event (Pro i Ultra)

Stvara događaj u kalendaru.

Parametar	Vrsta	Ograničenje	Opis
title	string	200 znakova	Obavezno
start_at	string	-	ISO 8601 datum i vrijeme, obavezno
end_at	string	-	ISO 8601 datum i vrijeme (zadano: početak + 1 sat)
description	string	2000 znakova	Neobavezno
location	string	200 znakova	Neobavezno
is_all_day	bool	-	Zadano: false
tags	string	20 oznaka	Odvojene zarezom, neobavezno
reminder_minutes	string	-	Minute prije događaja odvojene zarezom (npr. 15,60), neobavezno
attendees	string	-	Imena ili e-mailovi odvojeni zarezom, neobavezno
recurrence_rule	string	-	RRULE niz (npr. FREQ=WEEKLY;BYDAY=MO,WE,FR), neobavezno
note_id	string	-	UUID za povezivanje događaja s nadređenom bilješkom, neobavezno

update_note (Pro i Ultra)

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

Parametar	Vrsta	Opis
note_id	string	Obavezno, UUID bilješke
title	string	Novi naslov (najviše 200 znakova)
summary	string	Novi sažetak (najviše 1000 znakova, proslijedi razmak " " za brisanje)
transcript	string	Novi transkript (ograničenje ovisi o planu, proslijedi razmak " " za brisanje)
type	string	task, idea, info, status, meeting, event ili reflection
tags	string	Oznake odvojene zarezom (zamjenjuje sve postojeće oznake, najviše 20)
priority	string	low, medium ili high
status	string	active ili archived

oprez

Za bilješke stvorene glasovnim tijekom transcript je izvorni izlaz pretvaranja govora u tekst. Prepisivanje zamjenjuje kanonski izvor - razmisli o dodavanju na njega ako želiš sačuvati izvornik.

update_task (Pro i Ultra)

Ažurira jedno ili više polja postojećeg zadatka. Mijenjaju se samo polja koja navedeš.

Parametar	Vrsta	Opis
task_id	string	Obavezno, UUID zadatka
title	string	Novi naslov
description	string	Novi opis (proslijedi razmak " " za brisanje)
priority	string	low, medium ili high
deadline	string	YYYY-MM-DD (proslijedi razmak za brisanje)
status	string	todo ili done
tags	string	Oznake odvojene zarezom (zamjenjuje sve postojeće oznake, najviše 20)
reminder_at	string	ISO 8601 datum i vrijeme (proslijedi razmak za brisanje)

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

complete_task (Pro i Ultra)

Prečac za označavanje zadatka gotovim.

Parametar	Vrsta	Opis
task_id	string	Obavezno, UUID zadatka

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

update_event (Pro i Ultra)

Ažurira jedno ili više polja postojećeg događaja. Mijenjaju se samo polja koja navedeš.

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

delete_note (Pro i Ultra)

Briše bilješku. Time se brišu i svi zadaci i događaji stvoreni iz te bilješke.

Parametar	Vrsta	Opis
note_id	string	Obavezno, UUID bilješke

delete_task (Pro i Ultra)

Briše zadatak.

Parametar	Vrsta	Opis
task_id	string	Obavezno, UUID zadatka

delete_event (Pro i Ultra)

Briše događaj.

Parametar	Vrsta	Opis
event_id	string	Obavezno, UUID događaja

undo_change_log_entry (Pro i Ultra)

Poništava pojedinačno praćeno uređivanje - vraća polje na vrijednost prije tog uređivanja, bez obzira je li uređivanje napravio AI (iz naknadne snimke) ili ti izravno.

Parametar	Vrsta	Opis
entity	string	Obavezno, notes, tasks ili events
entity_id	string	Obavezno, UUID stavke
entry_id	string	Obavezno, id unosa promjene 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 izbrisanu ili arhiviranu bilješku, zadatak ili događaj.

Parametar	Vrsta	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)

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

Parametar	Vrsta	Opis
tag	string	Obavezno, 1-50 znakova (pohranjeno malim slovima)
category	string	Neobavezno

set_tag_pinned (Pro i Ultra)

Prikvačuje ili otkvačuje oznaku da se sortira na vrh tvog popisa oznaka.

Parametar	Vrsta	Opis
tag	string	Obavezno
pinned	bool	Obavezno

Oznake koje sadrže znak / ne mogu se prikvačiti.

delete_tag (Pro i Ultra)

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

Parametar	Vrsta	Opis
tag	string	Obavezno

restore_tag (Pro i Ultra)

Vraća izbrisanu oznaku.

Parametar	Vrsta	Opis
tag	string	Obavezno

Ograničenja unosa

Polje	Najveća duljina	Koristi se u
title	200 znakova	create/update note, task, event
description	2.000 znakova	create/update task, event
summary	1.000 znakova (čvrsto)	create/update note. Uključeno u upite izvještaja, kratko radi kontrole troška tokena
transcript	ovisi o 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 prekoračiš ograničenje, alat vraća poruku o grešci poput "title too long (max 200 chars, got 250)".

Obrada grešaka

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"	Kao ID proslijeđen niz koji nije UUID
"Note not found"	ID ne postoji ili pripada drugom korisniku
"Task not found or already completed"	complete_task na nepostojećem ili već dovršenom zadatku
"title too long (max 200 chars, got N)"	Prekoračeno ograničenje unosa
"Too many tags (max 20)"	Navedeno više od 20 oznaka

Greške na razini HTTP-a:

Kôd	Značenje
401	Nevažeći ili nedostajući Bearer token
403	MCP onemogućen ili plan ne dopušta MCP
429	Prekoračeno ograničenje brzine (5 zahtj./s, rafal do 20)

Primjeri upotrebe

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š sve detalje (oznake, prioritet, rok itd.) nakon pisanja, napravi naknadni poziv čitanja poput get_tasks ili get_note.

Upravljanje tokenom

Radnja	Kako
Prikaži token	Postavke iPhonea → Integracije → AI agenti (ili web Postavke → AI agenti), dodirni ikonu oka
Kopiraj token	Dodirni ikonu kopiranja pokraj tokena
Ponovno generiraj	Dodirni Ponovno generiraj i potvrdi. Stari token odmah prestaje raditi i sve aktivne sesije se prekidaju
Promijeni način	Samo Ultra - prebaci između Samo za čitanje i Čitanje + pisanje. Na Pro je način fiksno Čitanje + pisanje
Onemogući	Dodirni Onemogući i potvrdi. Token se briše i sve veze prestaju. Kasnije ga možeš ponovno omogućiti (bit će izdan novi token)

Što možeš pitati svog AI agenta

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

Pregledaj svoj dan:

• "Na čemu sam danas radio?"
• "Prikaži mi bilješke iz ovog tjedna"
• "Koji zadaci kasne?"

Upravljaj zadacima:

• "Stvori zadatak: pregledati kvartalni izvještaj, visok prioritet, rok petak"
• "Označi Figma zadatak gotovim"
• "Na kojim zadacima radim?"

Pretraži i analiziraj:

• "Pronađi sve bilješke o marketinškoj strategiji"
• "Koje događaje imam sljedeći tjedan?"
• "Sažmi moje dnevne izvještaje od prošlog tjedna"

Planiraj unaprijed:

• "Stvori događaj: sastanak tima sutra u 10 h"
• "Što imam u kalendaru ovaj tjedan?"
• "Prikaži mi moje najčešće oznake - na što trošim najviše vremena?"

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

Važne napomene

• Dva načina stvaranja bilješki - create_note odmah stvara običnu tekstualnu bilješku (bez AI analize). process_note pokreće cijeli AI tijek (isto kao snimanje u aplikaciji) - analizira tekst, izdvaja zadatke i događaje, generira oznake i ugrađivanja. Koristi process_note kad želiš da TellDone razmišlja umjesto tebe.
• Bez sinkronizacije integracija - stavke stvorene ili ažurirane putem MCP-a ne pokreću webhook automatizacije ni sinkronizacije integracija (Todoist, Notion). Pojavit će se u tvojim aplikacijama pri sljedećoj sinkronizaciji.
• Semantička pretraga ovisi o alatu - bilješke stvorene s process_note dobivaju ugrađivanja i pojavljuju se u semantičkoj pretrazi. Bilješke stvorene s create_note ne dobivaju ugrađivanja pa se pojavljuju samo u pretrazi teksta.
• Odgovori pisanja su minimalni - alati za stvaranje i ažuriranje vraćaju samo id, title i status. Da dobiješ sva polja nakon pisanja, napravi naknadni poziv čitanja.
• Filtri datuma koriste UTC - parametri date_from/date_to uspoređuju se kao UTC vremenske oznake. Za korisnike u zonama izvan UTC-a rubni datumi mogu uključiti ili isključiti stavke iz susjednih dana.
• Ograničenje brzine - 5 zahtjeva u sekundi, s rafalima do 20. Za skupne operacije rasporedi svoje zahtjeve.

Sigurnost

• Svaki korisnik dobiva jedinstveni 384-bitni token za povezivanje
• Tvoj se token odmah opoziva kad onemogućiš MCP ili ga ponovno generiraš
• Svi su podaci strogo izolirani na tvoj račun - tvoj agent može pristupiti samo tvojim podacima
• Svaki je zahtjev ograničen na tvog korisnika - agent nema načina pristupiti podacima drugog korisnika
• Veza koristi HTTPS s ograničenjem brzine (5 zahtj./s, rafal do 20)
• OAuth veze koriste PKCE s jednokratnim autorizacijskim kodovima i kratkotrajnim pristupnim tokenima - vezu možeš opozvati bilo kad iz aplikacije

Za tehnički pregled u detalje - krajnje točke otkrivanja, vijek trajanja tokena, cijeli OAuth tijek - pogledaj našu referencu konektora otvorenog koda na github.com/exp78/telldone-mcp ili izravno upitaj https://api.telldone.app/.well-known/oauth-protected-resource.

Privatnost i tijek podataka

Tvoji se podaci prenose povezanom AI alatu samo kad ga izričito zatražiš da nešto napravi - na primjer, kad ga zatražiš da pročita ili izmijeni tvoje bilješke. Alat prima samo odgovore na konkretne pozive koje napravi, ograničene na dopuštenja koja si odobrio. Ti si na kontroli: promijeni način čitanja/pisanja svog plana, suzi OAuth opsege koje odobriš pri prijavi ili ponovno generiraj i onemogući svoj bearer token, sve iz Postavki. Za sve detalje pogledaj Pravila privatnosti ili se obrati na support@telldone.app s pitanjima.

Rješavanje problema

Simptom	Uzrok / rješenje
Stranica OAuth pristanka kaže "Wrong email or password"	Koristi e-mail i lozinku svog TellDone računa (onu kojom se prijavljuješ u aplikaciju). Ako tvoj račun ima samo Apple ili Google Sign In bez lozinke, umjesto toga koristi metodu s bearer tokenom.
Povezano, ali AI ne može ništa stvoriti ni urediti	Tvoj plan ili način je samo za čitanje ili vezi nisu odobreni opsezi pisanja - ponovno se poveži i odobri ih ili provjeri svoj način u Postavkama.
Greška "Insufficient scope" iz alata	OAuth vezi nije odobren taj opseg. Ponovno se poveži i odobri dopuštenje koje alat treba.
Alati se uopće ne pojavljuju	MCP nije omogućen na tvom računu (Postavke → AI agenti) ili tvoj plan ne uključuje MCP.
Moj klijent dopušta samo biranje s popisa konektora, a TellDone nije na njemu	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 i

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