Pređi na glavni sadržaj

AI agenti (MCP)

Dostupno na svakom planu

MCP radi na svim planovima. Free i Basic dobijaju pristup samo za čitanje svih 10 alata za čitanje (Free je ograničen na 100 zahteva dnevno). Pro i Ultra dobijaju pun pristup za čitanje i pisanje (27 alata) i mogu da pređu na režim samo za čitanje ako žele.

MCP (Model Context Protocol) omogućava da AI asistente kao što su ChatGPT i Claude, asistente za programiranje i alate za automatizaciju povežeš direktno sa svojim TellDone podacima. Kada je povezan, tvoj asistent može da čita tvoje beleške, zadatke, događaje, izveštaje, oznake i istoriju promena. Na planu Pro i višim može i da pravi, ažurira, briše i vraća stavke. Postoji 27 alata: 10 za čitanje (svaki plan) i 17 za pisanje (Pro i viši).

Na iPhone-u, Podešavanja > Integracije > AI agenti (MCP) otvara MCP ekran za podešavanje sa tvojim pristupnim tokenom koji je podrazumevano maskiran:

Podešavanja AI agenata na iPhone-u sa maskiranim tokenom

A na vebu:

Podešavanja AI agenata na vebu sa skrivenim pristupnim tokenom

Dva načina povezivanja​

Postoje dva načina da povežeš AI klijent:

  1. Prijava preko TellDone-a (OAuth) (preporučeno) - prijavljuješ se svojim TellDone nalogom i odobravaš šta aplikacija traži. ChatGPT i Claude koriste ovo i nema tokena za kopiranje.
  2. Bearer token - kopiraj svoj pristupni token iz Podešavanja i nalepi ga u konfiguraciju svog klijenta. Najjednostavnije za skripte, alate komandne linije i klijente koji nemaju ugrađen OAuth tok.
KlijentPreporučeno
ChatGPT (chatgpt.com ili ChatGPT aplikacija za računar, ne mobilna aplikacija)OAuth - dodaj prilagođeni MCP server sa MCP URL-om, pa se prijavi
Claude (veb sajt, Desktop, iPhone aplikacija) / CoworkOAuth - dodaj prilagođeni konektor sa MCP URL-om, pa se prijavi
Claude Code (CLI)Bearer token za sada - dodaj zaglavlje Authorization sa svojim tokenom
Skripte ili tvoj sopstveni kodBearer token - najjednostavnije za automatizaciju
Klijent koji dozvoljava samo biranje iz kataloga navedenih konektoraDodaj TellDone kao prilagođeni konektor sa MCP URL-om ili koristi bearer token. TellDone još nije ni u jednom katalogu konektora

Zahtevi plana​

PlanMCP
FreeSamo čitanje (10 alata za čitanje), 100 zahteva dnevno
BasicSamo čitanje (10 alata za čitanje), bez dnevnog ograničenja
ProČitanje i pisanje (27 alata) - može da pređe na režim samo za čitanje
UltraČitanje i pisanje (27 alata) - može da pređe na režim samo za čitanje

Ograničenje od 100 zahteva dnevno na planu Free računa samo pozive alata. Povezivanje, prijava i listanje alata se ne računaju. Dan prati vremensku zonu sačuvanu u tvom nalogu i resetuje se u ponoć. Kada dostigneš ograničenje, tvoj asistent dobija poruku o tome. Alati za pisanje se odbijaju na planovima Free i Basic. Sa pristupnim tokenom odgovaraju da je veza samo za čitanje i da pravljenje i izmena zahtevaju Pro i viši. Sa prijavom (OAuth) većina njih odgovara „Insufficient scope“, jer veze na planovima Free i Basic nikada ne dobijaju dozvole za pisanje.

Ekran u aplikaciji​

Otvori Podešavanja > Integracije, a u odeljku AI agenti dodirni AI agenti (MCP). Ekran kaže „Neka ChatGPT, Claude i drugi AI asistenti rade s tvojim TellDone beleškama, zadacima i događajima.“ i prikazuje tvoj plan:

  • Free: „Tvoj plan: pristup samo za čitanje, 100 zahteva dnevno. Pisanje dolazi uz Pro.“
  • Basic: „Tvoj plan: pristup samo za čitanje“
  • Pro i Ultra: „Tvoj plan: pristup za čitanje i pisanje“

Dok je MCP isključen, dodirni Omogući da ga uključiš.

Kada je uključen, ekran prikazuje:

  • Režim pristupa (Pro i Ultra) - u bilo kom trenutku izaberi Samo za čitanje ili Čitanje i pisanje.
  • Poveži asistenta - koraci za ChatGPT, Claude i Drugi asistent. Prijavljuješ se u TellDone unutar asistenta, pa token nije potreban.
  • Povezane aplikacije - povezani asistenti, svaki sa dugmetom Prekini vezu. Ostaje prazno do prve veze.
  • Za programere (podrazumevano skupljeno) - polje Pristupni token (skriveno, sa Prikaži / Sakrij i Kopiraj), Regeneriši token i prekidač Claude Code / Cursor / Other sa gotovim tekstom i sopstvenim dugmetom Kopiraj. Claude Code daje komandu claude mcp add, Cursor daje JSON za .cursor/mcp.json, a Other navodi adresu servera, opciju prijave preko OAuth-a i zaglavlje Authorization: Bearer. Dok je token skriven, isečci prikazuju YOUR_TOKEN. Dodirni Prikaži i oni sadrže tvoj pravi token.

Veb ima iste kontrole u drugačijem rasporedu, bez skupljenog odeljka za programere: OAuth adresu sa dugmetom Kopiraj, kontrole tokena, Povezane aplikacije sa Prekini vezu i Manual bearer token setup sa šest izbora klijenata (Claude Code, Cursor, Windsurf, Codex, OpenClaw i cURL). Na vebu isečci uvek sadrže tvoj pravi token, čak i dok je polje tokena skriveno, zato ih tretiraj kao sam token.

  • Dokumentacija - link ka ovoj stranici.
  • Onemogući - isključuje MCP. Potvrđuješ sa „Ovime će se opozvati pristup svim povezanim AI alatima.“ Tvoj token se briše i sve veze prestaju. Ako ponovo omogućiš MCP, dobijaš novi token, a aplikacije povezane prijavom (OAuth) ponovo rade bez ponovne prijave. Da trajno ukloniš aplikaciju, dodirni Prekini vezu pod Povezane aplikacije.
savet

Čuvaj svoj pristupni token privatnim. Ko god ima token može da pristupi tvojim TellDone podacima. Dodirni Regeneriši token ako ikada posumnjaš da je procurio.

Kako da omogućiš​

MCP možeš da podesiš sa obe platforme:

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

Koraci:

  1. Dodirni Omogući.
  2. Na planovima Pro i Ultra izaberi režim pristupa (Samo za čitanje ili Čitanje i pisanje). Free i Basic su samo za čitanje.
  3. Da povežeš ChatGPT ili Claude, dodirni ga pod Poveži asistenta i prati korake (pogledaj ispod). Token nije potreban.
  4. Za klijent za programiranje na iPhone-u otvori Za programere, dodirni Prikaži, izaberi Claude Code, Cursor ili Other i dodirni Kopiraj ispod isečka. Ako kopiraš pre nego što dodirneš Prikaži, isečak ima YOUR_TOKEN umesto tvog tokena. Na vebu izaberi svoj klijent pod Manual bearer token setup i kopiraj isečak; on već sadrži tvoj token.
  5. Nalepi isečak u svoj klijent ili njegovu konfiguracionu datoteku.

Povezivanje preko OAuth-a​

OAuth je preporučeni put za ChatGPT, Claude i Cowork - prijavljuješ se svojim TellDone nalogom umesto kopiranja tokena.

MCP URL za OAuth: https://api.telldone.app/mcp/user

Isti server odgovara i na https://api.telldone.app/mcp/user/mcp, a obe adrese prihvataju bearer token. Za OAuth prijavu koristi prvu.

ChatGPT​

Prilagođeni MCP server možeš da dodaš na chatgpt.com ili u ChatGPT aplikaciji za računar. Mobilna aplikacija ChatGPT ne može da dodaje prilagođene konektore, a aplikacija TellDone to kaže ovako: „Aplikacija ChatGPT dodaje konektore samo iz svog kataloga.“ Dodirni Pošalji uputstvo na moj računar u TellDone-u da dobiješ uputstvo na računaru. Kada se jednom doda tamo, TellDone je dostupan i u mobilnoj aplikaciji ChatGPT.

Koraci u aplikaciji:

  1. Na računaru otvori chatgpt.com/plugins, klikni na Add i izaberi Add custom MCP server.
  2. Nazovi ga TellDone, nalepi adresu ispod (https://api.telldone.app/mcp/user) i izaberi OAuth.
  3. Potvrdi i instaliraj ga, zatim se prijavi u TellDone i dozvoli pristup.

Pogledaj OpenAI vodič o prilagođenim MCP serverima ako se nazivi menija promene.

Claude (veb sajt, Desktop, iPhone aplikacija) / Cowork​

Koraci u aplikaciji:

  1. U Claude-u otvori Customize → Connectors i dodirni Add custom connector.
  2. Nalepi adresu ispod (https://api.telldone.app/mcp/user).
  3. Prijavi se u TellDone i dozvoli pristup.

Kada se prijaviš, TellDone stranica za saglasnost prikazuje koja aplikacija traži pristup i tačne dozvole koje želi. Prijavi se svojim TellDone imejlom i lozinkom i klikni na Allow access, ili dodirni Prijavi se preko Apple-a ili Nastavi sa Google-om, čime se pristup odobrava u istom koraku. Claude se povezuje sam - nema tokena za kopiranje.

Ako se nazivi menija promene, pogledaj Anthropic vodič o dodavanju prilagođenog konektora.

Povezivanje pomoću bearer tokena​

Za Claude Code, Cursor i druge klijente bez ugrađene OAuth prijave, nalepi svoj pristupni token direktno u konfiguraciju klijenta. U svim primerima ispod zameni YOUR_TOKEN tokenom iz svojih podešavanja.

Claude Code (bearer token)​

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

Ne moraš ovo da kucaš ručno: u Podešavanja > Integracije > AI agenti (MCP) > Za programere dodirni Prikaži, izaberi Claude Code i dodirni Kopiraj. Kopirana komanda već sadrži tvoj token.

Cursor​

Dodaj u .cursor/mcp.json (ili ga kopiraj iz Za programere > Cursor nakon što dodirneš Prikaži):

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

Drugi klijenti​

Podešavanja za druge MCP klijente:

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​

Može da se poveže svaki alat koji podržava MCP preko HTTP-a. Koristi krajnju tačku https://api.telldone.app/mcp/user/mcp sa zaglavljem autorizacije Bearer YOUR_TOKEN.

Alternativno zaglavlje za autentifikaciju

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

Testiranje veze​

Možeš da proveriš 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 navodi sve dostupne alate.

Dozvole (scopes)​

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

ScopeOmogućava aplikaciji da...
notes:readČita tvoje beleške i otvara sve detalje beleške (alat za pretragu zahteva i tasks:read i events:read)
notes:writePravi, uređuje i briše beleške (process_note zahteva i tasks:write i events:write)
tasks:read / tasks:writeČita / pravi, uređuje, završava i briše zadatke
events:read / events:writeČita / pravi, uređuje i briše događaje
reports:readČita tvoje dnevne, nedeljne, mesečne i godišnje izveštaje
tags:read / tags:writeNavodi tvoje oznake / pravi, prikačuje, briše i vraća oznake
profile:readČita informacije o tvom nalogu i pretplati
offline_accessZadržava prijavu (izdaje refresh token da ne moraš da se prijavljuješ iznova u svakoj sesiji)

Dozvole ograničavaju šta veza može da radi: veza sa samo notes:read ne može da pozove alat za pisanje. Tvoj plan postavlja drugo ograničenje povrh toga.

Veze sa bearer tokenom nemaju pojedinačne dozvole - njima upravlja samo režim čitanja/pisanja tvog plana.

Šta možeš da radiš​

Alati za čitanje (10) - svi planovi​

AlatŠta radi
get_notesNavodi beleške sa filterima (oznake, period, pretraga teksta)
get_notePrikazuje jednu belešku sa njenim zadacima, događajima i punim transkriptom
get_notes_fullVraća više beleški sa ugrađenim zadacima i događajima u jednom pozivu
get_tasksNavodi zadatke filtrirane po statusu (to-do, done, all), oznakama ili datumima
get_eventsNavodi kalendarske događaje, filtriranje po periodu
get_reportsČita tvoje dnevne, nedeljne, mesečne i godišnje izveštaje (ceo markdown)
get_tagsPrikazuje sve tvoje oznake sortirane po korišćenju
get_profilePrikazuje informacije o tvom nalogu i koliko imaš beleški, zadataka i događaja
searchPretražuje beleške, zadatke i događaje (tekst + semantička pretraga za beleške)
get_change_logPrikazuje istoriju izmena beleške, zadatka ili događaja i da li je svaka izmena poništena
savet

Alat search podržava semantičku pretragu beleški - pronalazi rezultate po značenju, a ne samo po ključnim rečima. Na primer, pretraga „meetings about budget“ pronaći će beleške o finansijskim razgovorima čak i ako ne sadrže reč „budget“.

Alati za pisanje (17) - Pro i Ultra​

AlatŠta radi
process_notePotpun AI tok - pošalji tekst ili audio i dobij belešku sa zadacima, događajima i oznakama
create_noteDodaje običnu tekstualnu belešku (bez AI analize)
create_taskDodaje zadatak sa prioritetom, rokom, podsetnikom i oznakama
create_eventDodaje kalendarski događaj sa datumom, vremenom, lokacijom, podsetnicima, učesnicima i pravilom ponavljanja
update_noteMenja naslov, sažetak, vrstu, oznake, prioritet ili status beleške
update_taskMenja naslov, opis, prioritet, rok, podsetnik, oznake ili status zadatka
complete_taskOznačava zadatak kao gotov
update_eventMenja detalje događaja, vreme, lokaciju, podsetnike, učesnike, pravilo ponavljanja, oznake ili status
delete_noteBriše belešku. Njeni zadaci i događaji ostaju
delete_taskBriše zadatak
delete_eventBriše događaj
undo_change_log_entryPoništava jednu praćenu izmenu - bilo da ju je napravio AI ili je uneta ručno - vraćajući prethodnu vrednost polja
restore_entityVraća izbrisanu ili arhiviranu belešku ili zadatak, ili izbrisan ili otkazan događaj
create_tagPravi novu oznaku ili pretvara automatski predloženu oznaku u trajnu
set_tag_pinnedPrikači ili otkači oznaku da se sortira na vrh
delete_tagUklanja oznaku (može da se vrati pomoću restore_tag)
restore_tagVraća izbrisanu oznaku

Sve operacije pisanja i brisanja pojavljuju se odmah na tvojim povezanim uređajima (telefon, veb aplikacija).

Referenca alata​

get_notes​

Navodi beleške uz opciono filtriranje. Filteri datuma koriste recorded_at (kada je snimljena glasovna beleška) ili created_at za belešku koja ga nema.

ParametarTipPodrazumevanoOpis
limitint20Broj beleški koje se vraćaju (maks. 50)
offsetint0Preskoči toliko beleški (za straničenje, maks. 10000)
tagsstring-Filtriraj po oznakama, razdvojenim zarezima (poklapa bilo koju)
searchstring-Pretraga teksta u naslovu i sažetku
date_fromstring-Početni datum, YYYY-MM-DD (uključivo)
date_tostring-Krajnji datum, YYYY-MM-DD (isključivo)
standalone_onlyboolfalseKada je true, sakriva beleške nastavka (beleške vezane za nadređenu belešku/zadatak/događaj) 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​

Vraća jednu belešku sa njenim celim transkriptom i svim povezanim zadacima i događajima.

ParametarTipOpis
note_idstringUUID beleške

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

Vraća i transcript_speakers (transkript sa oznakama govornika, za sastanke sa više govornika - inače null), speaker_count (null osim ako je snimak podeljen po govornicima) i parent_note_id/parent_task_id/parent_event_id (postavljeno kada je ova beleška izmena nastavka druge stavke). Svaki unos u tasks[]/events[] uključuje i reminders_at/recurrence_rule (zadaci) ili reminder_minutes/attendees/recurrence_rule (događaji).

get_notes_full​

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

ParametarTipPodrazumevanoOpis
limitint10Broj beleški (maks. 20)
offsetint0Preskoči toliko beleški
tagsstring-Filtriraj po oznakama
date_fromstring-Početni datum, YYYY-MM-DD
date_tostring-Krajnji datum, YYYY-MM-DD
standalone_onlyboolfalseKada je true, sakriva beleške nastavka (beleške vezane za nadređenu belešku/zadatak/događaj) i vraća samo samostalne beleške

get_tasks​

Navodi zadatke uz filtriranje.

ParametarTipPodrazumevanoOpis
statusstring"todo"Filter: todo, done ili all
limitint30Broj zadataka (maks. 100)
offsetint0Preskoči toliko zadataka
tagsstring-Filtriraj po oznakama, razdvojenim zarezima
date_fromstring-Početni datum, YYYY-MM-DD (filtrira po roku; zadaci bez roka su isključeni)
date_tostring-Krajnji datum, YYYY-MM-DD (filtrira po roku; zadaci bez roka su isključeni)

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 iz reminders_at radi povratne kompatibilnosti - koristi reminders_at da vidiš sve podsetnike zadatka.

get_events​

Navodi kalendarske događaje uz filtriranje po periodu.

ParametarTipPodrazumevanoOpis
limitint30Broj događaja (maks. 100)
offsetint0Preskoči toliko događaja
date_fromstring-Prvi dan, YYYY-MM-DD, u tvojoj vremenskoj zoni (uključivo). Događaji koji se preklapaju sa periodom su uključeni, pa se višednevni događaj prikazuje svakog dana koji pokriva
date_tostring-Poslednji dan, YYYY-MM-DD, u tvojoj vremenskoj zoni (uključivo)

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​

Vraća tvoje izveštaje koje je napravio AI sa celim markdown sadržajem.

ParametarTipPodrazumevanoOpis
report_typestring"daily"Vrsta: daily, weekly, monthly ili yearly
limitint5Broj izveštaja (maks. 10)

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

napomena

Mesečni izveštaji su dugački (često znatno preko 1.000 reči). Koristi limit=1 ako tvoj AI alat ima mali kontekstni prozor.

get_tags​

Vraća sve tvoje oznake, sortirane tako da prikačene idu prve, zatim po broju korišćenja.

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

get_profile​

Vraća informacije o tvom nalogu i koliko imaš beleški, zadataka i događaja.

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

Pretražuje beleške, zadatke i događaje odjednom. Za beleške podržava i pretragu teksta i semantičku pretragu (pronalazi rezultate po značenju pomoću AI embeddings).

ParametarTipPodrazumevanoOpis
querystringrequiredTekst pretrage (maks. 500 znakova)
limitint20Maks. rezultata po vrsti (maks. 20)
semanticbooltrueUključi semantičku pretragu za beleške

Vraća rezultate grupisane po vrsti: 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 izmenu nastavka koju je napravio AI i svaku ručnu izmenu koju napraviš, najnovije prvo.

ParametarTipPodrazumevanoOpis
entitystringrequirednotes, tasks ili events
entity_idstringrequiredUUID stavke
include_manualboolfalseUključi i svoje ručne izmene, ne samo one koje je napravio AI

Vraća: listu unosa promena sa id (koristi ga kao entry_id za poništavanje), field_name, old_value, new_value, source (follow_up, smart_context, correction_sync za ispravku imena koju je TellDone prenela kroz belešku, ili manual), origin_note_id, edited_at i reverted_at (postavljeno kada se poništi).

process_note (Pro i Ultra)​

Potpun AI tok - radi isto kao snimanje u aplikaciji. Pošalji tekst ili audio, a TellDone će ga transkribovati, analizirati pomoću AI-ja i napraviti strukturisanu belešku sa izdvojenim zadacima, događajima, oznakama i embeddings.

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

ParametarTipOpis
textstringObavezno. Tekst za analizu. Ako nije prazan, koristi se kao transkript, a svaki audio koji pošalješ se ne transkribuje; pošalji "" da se audio transkribuje. Ograničenje kada se audio ne šalje: Pro 20.000 / Ultra 50.000 znakova
audio_base64stringAudio datoteka kodirana u Base64. Ceo zahtev je ograničen na 10 MB, pa sam audio može biti oko 7 MB. Transkribuje se samo kada je text prazan
audio_formatstringm4a, ogg, wav, mp3, aac ili webm (podrazumevano: m4a)
parent_task_idstringUUID zadatka čiji je ovo nastavak
parent_note_idstringUUID beleške čiji je ovo nastavak
parent_event_idstringUUID događaja čiji je ovo nastavak

Uvek pošalji text. Da TellDone transkribuje audio, pošalji audio_base64 sa text postavljenim na prazan string (""). Ako text nije prazan, TellDone ga koristi kao transkript i ne transkribuje audio. Postavi najviše jedan od tri ID-a nadređene stavke.

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

napomena

process_note podleže kvotama tvog plana (otpremanja dnevno, beleške mesečno, maks. dužina teksta). get_profile prikazuje samo koliko imaš beleški, zadataka i događaja, a ne tvoja ograničenja. Potrošnju proveri u aplikaciji pod Podešavanja > Korišćenje.

create_note (Pro i Ultra)​

Odmah pravi običnu tekstualnu belešku. Ne pokreće AI analizu - zadaci i događaji se ne izdvajaju. Koristi process_note kada želiš da TellDone pronađe zadatke i događaje umesto tebe.

ParametarTipOgraničenjeOpis
titlestring200 znakovaObavezno
summarystring1000 znakovaOpciono. Kratak uvod (1-3 rečenice). Koristi se u tvojim izveštajima, zato neka bude kratak
transcriptstringzavisi od planaOpciono. Dugačak tekst prikazan u detaljima beleške. Nije uključen u izveštaje. Ograničenja: Pro 20.000 / Ultra 50.000 znakova
typestring-Opciono. task, idea, info (podrazumevano), status, meeting, event ili reflection
tagsstring20 oznakaRazdvojene zarezima, opciono
suppress_external_syncboolean-Opciono, podrazumevano false. Postavi true za uvezene ili masovno dodate stavke: stavka se tada ne šalje u tvoje povezane aplikacije niti automatizacije

create_task (Pro i Ultra)​

Pravi novi zadatak. Zadatak se pravi i u tvom povezanom Todoist-u, Notion-u ili Microsoft To Do-u, a tvoje automatizacije dobijaju task.created. To se ne dešava kada proslediš suppress_external_sync: true.

ParametarTipOgraničenjeOpis
titlestring200 znakovaObavezno
descriptionstring2000 znakovaOpciono
prioritystring-low, medium (podrazumevano) ili high
deadlinestring-YYYY-MM-DD, opciono
reminder_atstring-ISO 8601 datum i vreme (na primer 2026-04-15T09:00:00Z), opciono
tagsstring20 oznakaRazdvojene zarezima, opciono
note_idstring-UUID za povezivanje zadatka sa nadređenom beleškom, opciono
suppress_external_syncboolean-Opciono, podrazumevano false. Postavi true za uvezene ili masovno dodate stavke: stavka se tada ne šalje u tvoje povezane aplikacije niti automatizacije

create_event (Pro i Ultra)​

Pravi kalendarski događaj. Događaj se pravi i u tvom povezanom Notion-u, a tvoje automatizacije dobijaju calendar_event.created. To se ne dešava kada proslediš suppress_external_sync: true.

ParametarTipOgraničenjeOpis
titlestring200 znakovaObavezno
start_atstring-ISO 8601 datum i vreme, obavezno
end_atstring-ISO 8601 datum i vreme (podrazumevano: početak + 1 sat; za celodnevni događaj, jedan dan)
descriptionstring2000 znakovaOpciono
locationstring200 znakovaOpciono
is_all_daybool-Podrazumevano: false
tagsstring20 oznakaRazdvojene zarezima, opciono
reminder_minutesstring-Minuti pre događaja razdvojeni zarezima (na primer 15,60), opciono
attendeesstring-Imena ili imejlovi razdvojeni zarezima, opciono
recurrence_rulestring-RRULE string (na primer FREQ=WEEKLY;BYDAY=MO,WE,FR), opciono. Pravila češća od svakog sata, ili ona koja se nikada ne mogu desiti, se odbijaju
note_idstring-UUID za povezivanje događaja sa nadređenom beleškom, opciono
suppress_external_syncboolean-Opciono, podrazumevano false. Postavi true za uvezene ili masovno dodate stavke: stavka se tada ne šalje u tvoje povezane aplikacije niti automatizacije

update_note (Pro i Ultra)​

Ažurira jedno ili više polja postojeće beleške. Menjaju se samo polja koja navedeš. Ovo radi potpuno isto kao izmena beleške u aplikaciji: njen naslov, sažetak, oznake i vrsta stižu na njenu Notion stranicu, tvoje automatizacije dobijaju note.updated, a izmena se pojavljuje u istoriji promena, gde može da se poništi. Izmena transkripta se čuva i takođe šalje u Notion, ali se ne pojavljuje u istoriji promena.

ParametarTipOpis
note_idstringObavezno, UUID beleške
titlestringNovi naslov (maks. 200 znakova)
summarystringNovi sažetak (maks. 1000 znakova, prosledi razmak " " da obrišeš)
transcriptstringNovi transkript (ograničenje zavisi od plana, prosledi razmak " " da obrišeš)
typestringtask, idea, info, status, meeting, event ili reflection
tagsstringOznake razdvojene zarezima (zamenjuje sve postojeće oznake, maks. 20)
prioritystringlow, medium ili high
statusstringactive ili archived
oprez

Za beleške napravljene glasovnim tokom, transcript je originalni izlaz prepoznavanja govora. Prepisivanje zamenjuje tvoje originalne reči. Da ih sačuvaš, dodaj u transkript umesto da ga zameniš.

update_task (Pro i Ultra)​

Ažurira jedno ili više polja postojećeg zadatka. Menjaju se samo polja koja navedeš. Ovo radi potpuno isto kao izmena zadatka u aplikaciji: promena stiže do njegovih kopija u Todoist-u, Notion-u i Microsoft To Do-u, tvoje automatizacije dobijaju task.updated, a izmena se pojavljuje u istoriji promena zadatka, gde može da se poništi. Postavljanje status na done završava zadatak isto kao complete_task. Rok može biti datum ili pun datum sa vremenom (koristi se njegov datum). Svaka oznaka može imati do 50 znakova.

ParametarTipOpis
task_idstringObavezno, UUID zadatka
titlestringNovi naslov
descriptionstringNovi opis (prosledi razmak " " da obrišeš)
prioritystringlow, medium ili high
deadlinestringYYYY-MM-DD. Ovaj alat ne može da obriše rok; obriši ga u aplikaciji
statusstringtodo ili done
tagsstringOznake razdvojene zarezima (zamenjuje sve postojeće oznake, maks. 20)
reminder_atstringISO 8601 datum i vreme (prosledi razmak da obrišeš)

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

complete_task (Pro i Ultra)​

Prečica za označavanje zadatka kao gotovog.

ParametarTipOpis
task_idstringObavezno, 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 postojećeg događaja. Menjaju se samo polja koja navedeš. Ovo radi potpuno isto kao izmena događaja u aplikaciji: promena stiže na njegovu Notion stranicu, tvoje automatizacije dobijaju calendar_event.updated, a izmena se pojavljuje u istoriji promena, gde može da se poništi.

ParametarTipOpis
event_idstringObavezno, UUID događaja
titlestringNovi naslov
descriptionstringNovi opis (prosledi razmak da obrišeš)
start_atstringNovo vreme početka (ISO 8601)
end_atstringNovo vreme završetka (ISO 8601)
locationstringNova lokacija (prosledi razmak da obrišeš)
statusstringconfirmed, tentative ili cancelled
tagsstringOznake razdvojene zarezima (zamenjuje sve postojeće oznake, maks. 20)
is_all_daystring"true" ili "false"
reminder_minutesstringMinuti pre događaja razdvojeni zarezima (na primer 15,60, prosledi razmak da obrišeš)
attendeesstringImena ili imejlovi razdvojeni zarezima (prosledi razmak da obrišeš)
recurrence_rulestringRRULE string (prosledi razmak da obrišeš)

delete_note (Pro i Ultra)​

Briše belešku. Briše se samo beleška: njeni zadaci i događaji ostaju. Ovo radi isto kao brisanje u aplikaciji: tvoje automatizacije dobijaju note.deleted. Kopija beleške u Notion-u se ne uklanja (ni aplikacija je ne uklanja).

ParametarTipOpis
note_idstringObavezno, UUID beleške

delete_task (Pro i Ultra)​

Briše zadatak. Ovo radi isto kao brisanje u aplikaciji: njegove kopije u Todoist-u, Notion-u i Microsoft To Do-u se takođe brišu, a tvoje automatizacije dobijaju task.deleted. Vrati ga pomoću restore_entity.

ParametarTipOpis
task_idstringObavezno, UUID zadatka

delete_event (Pro i Ultra)​

Briše događaj. Ovo radi isto kao brisanje u aplikaciji: tvoje automatizacije dobijaju calendar_event.deleted. Stranica događaja u Notion-u se ne uklanja (ni aplikacija je ne uklanja).

ParametarTipOpis
event_idstringObavezno, UUID događaja

undo_change_log_entry (Pro i Ultra)​

Poništava jednu praćenu izmenu - vraća polje na vrednost pre te izmene, bez obzira da li ju je napravio AI (iz snimka nastavka) ili ti direktno.

ParametarTipOpis
entitystringObavezno, notes, tasks ili events
entity_idstringObavezno, UUID stavke
entry_idstringObavezno, 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 izbrisanu ili arhiviranu belešku ili zadatak, ili izbrisan ili otkazan događaj.

ParametarTipOpis
entitystringObavezno, notes, tasks ili events
entity_idstringObavezno, UUID stavke

Vraća: vraćenu stavku kao JSON.

create_tag (Pro i Ultra)​

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

ParametarTipOpis
tagstringObavezno, 1-50 znakova (čuva se malim slovima)
categorystringOpciono

set_tag_pinned (Pro i Ultra)​

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

ParametarTipOpis
tagstringObavezno
pinnedboolObavezno

Oznake koje sadrže znak / ne mogu da se prikače.

delete_tag (Pro i Ultra)​

Uklanja oznaku. Može da se vrati pomoću restore_tag.

ParametarTipOpis
tagstringObavezno

restore_tag (Pro i Ultra)​

Vraća izbrisanu oznaku.

ParametarTipOpis
tagstringObavezno

Ograničenja unosa​

PoljeMaks. dužinaKoristi se u
title200 znakovacreate/update note, task, event
description2.000 znakovacreate/update task, event
summary1.000 znakova (čvrsto)create/update note. Koristi se u tvojim izveštajima, zato neka bude kratak
transcriptzavisi od plana: Pro 20.000 / Ultra 50.000create/update note. Dugačak tekst, nije u izveštajima
textzavisi od plana: Pro 20.000 / Ultra 50.000 (kada se audio ne šalje)process_note
location200 znakovacreate/update event
tags20 oznakacreate/update note, task, event
search query500 znakovasearch
audio_base64oko 7 MB audia (ceo zahtev je ograničen na 10 MB)process_note

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

Obrada grešaka​

Većina alata vraća greške kao JSON:

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

Greške plana, dozvola i ograničenja unosa stižu kao greška alata sa istom porukom.

Česte greške:

GreškaKada
"This TellDone connection is read-only. Creating and editing needs the Pro or Ultra plan."Alat za pisanje pozvan u režimu samo za čitanje (Free i Basic, ili Pro i Ultra prebačeni na samo čitanje)
"Daily limit reached: the Free plan includes 100 TellDone requests a day..."Plan Free je potrošio svojih 100 zahteva za taj dan
"Daily limit reached (N/M today)"Danas je preko AI asistenata napravljeno onoliko stavki koliko tvoj plan dozvoljava (process_note, create_note, create_task i create_event se svi računaju)
"Notes limit reached (X/Y this month)"Mesečno ograničenje beleški tvog plana je potrošeno
"Invalid note_id format"Prosleđen string koji nije UUID 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)"Navedeno više od 20 oznaka

Greške na nivou HTTP-a:

KodZnačenje
401Nevažeći, opozvan ili izbrisan token (onemogućavanje MCP-a briše tvoj token, a regenerisanje ga zamenjuje)
429Prekoračeno ograničenje brzine (5 zahteva/s, nalet do 20)

Na planu Free, dostizanje ograničenja od 100 zahteva dnevno prijavljuje se kao poruka o grešci alata (ne kao HTTP kod) i resetuje se u ponoć u vremenskoj zoni sačuvanoj u tvom nalogu.

Primeri korišćenja​

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

Č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 repeating 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": 11,
"result": {
"content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Review PR\",\"status\":\"todo\"}"}]
}
}
napomena

Alati za pisanje i ažuriranje vraćaju kratke odgovore, uglavnom id, title i status. Alati za brisanje vraćaju id i deleted. Da dobiješ sve detalje (oznake, prioritet, rok itd.) nakon pisanja, napravi naknadni poziv za čitanje kao get_tasks ili get_note.

Upravljanje tokenom​

RadnjaKako
Prikaz tokenaiPhone Podešavanja > Integracije > AI agenti (MCP) > Za programere (ili na vebu, Podešavanja > Integracije > AI agenti (MCP)), dodirni Prikaži
Kopiranje tokenaDodirni Kopiraj pored tokena
RegenerisanjeDodirni Regeneriši token i potvrdi. Stari token odmah prestaje da radi. Asistenti povezani prijavom preko OAuth-a nisu pogođeni; prekini njihovu vezu pod Povezane aplikacije
Promena režimaPro i Ultra: izaberi Samo za čitanje ili Čitanje i pisanje. Free i Basic su uvek Samo za čitanje
OnemogućavanjeDodirni Onemogući i potvrdi („Ovime će se opozvati pristup svim povezanim AI alatima.“). Tvoj token se briše i sve veze prestaju. Ako ponovo omogućiš MCP, dobijaš novi token, a aplikacije povezane prijavom (OAuth) ponovo rade bez ponovne prijave. Da trajno ukloniš aplikaciju, dodirni Prekini vezu pod Povezane aplikacije

Šta možeš da pitaš svog AI agenta​

Kada je veza uspostavljena, pitaj svoj AI alat stvari kao što su:

Pregledaj svoj dan:

  • „What did I work on today?“
  • „Show me my notes from this week“
  • „What tasks are overdue?“

Upravljaj zadacima:

  • „Create a task: review quarterly report, high priority, deadline Friday“
  • „Mark the Figma task as done“
  • „What tasks am I working on?“

Pretražuj i analiziraj:

  • „Find all notes about the marketing strategy“
  • „What events do I have next week?“
  • „Summarize my daily reports from last week“

Planiraj unapred:

  • „Create an event: team standup tomorrow at 10am“
  • „What's on my calendar this week?“
  • „Show me my top tags - what do I spend most time on?“

Tvoj asistent može da čita tvoje beleške, zadatke, događaje i izveštaje i da odgovara na složena pitanja kombinovanjem informacija iz nekoliko alata. Na planovima Pro i Ultra sa uključenim Čitanje i pisanje, može i da ih pravi, ažurira i briše.

Dobro je znati​

  • Integracije i automatizacije - process_note radi kao snimak, pa njegova beleška, zadaci i događaji idu u tvoje povezane integracije i webhook automatizacije. Stavke koje napraviš, izmeniš ili izbrišeš ostalim alatima za pisanje ponašaju se potpuno isto kao u aplikaciji: stižu u tvoje povezane integracije (događaji i izmene beleški stižu samo u Notion) i u tvoje automatizacije. Vraćanje zadatka pomoću restore_entity ili poništavanje njegovog završetka pomoću undo_change_log_entry takođe ga ponovo otvara u integracijama sa kojima je bio sinhronizovan.
  • Izmene AI asistenta - u istoriji promena stavke označene su kao izmene asistenta. Ne koriste se za učenje TellDone prepoznavanja govora i ne prenose se na ostale stavke iz iste beleške. Izmene preko asistenta dele ograničenje aplikacije od 30 izmena u minuti.
  • Semantička pretraga - beleške napravljene pomoću process_note ili create_note obe dobijaju embeddings, pa se nakon kratkog odlaganja pojavljuju u semantičkoj pretrazi.
  • Filteri datuma - za beleške, datumi su UTC dani. Za događaje, datumi su tvoji lokalni dani, a događaj koji se preklapa sa periodom je uključen. Za zadatke, filter je datum roka.

Bezbednost​

  • Svaki korisnik dobija jedinstveni 384-bitni pristupni token
  • Tvoj token se odmah opoziva kada onemogućiš MCP ili ga regenerišeš
  • Svaki zahtev je ograničen na tvoj nalog, pa tvoj agent može da pristupi samo tvojim podacima
  • Veza koristi HTTPS sa ograničenjem brzine (5 zahteva/s, nalet do 20)
  • OAuth veze koriste PKCE sa jednokratnim autorizacionim kodovima i kratkotrajnim pristupnim tokenima - vezu možeš da opozoveš u bilo kom trenutku iz aplikacije

Za dublje tehničke detalje - krajnje tačke za otkrivanje, trajanje tokena, ceo 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​

Povezani AI alat dobija tvoje podatke samo kada pozove TellDone, obično zato što ga nešto pitaš. Prima samo odgovore na te pozive, u okviru dozvola koje odobriš. Da ograničiš pristup, pređi na Samo za čitanje, prekini vezu aplikacije pod Povezane aplikacije ili regeneriši ili onemogući svoj pristupni token u Podešavanjima. Pogledaj Politiku privatnosti za sve detalje ili piši na support@telldone.app ako imaš pitanja.

Rešavanje problema​

SimptomUzrok / rešenje
OAuth stranica za saglasnost kaže „Wrong email or password“Koristi imejl i lozinku kojima se prijavljuješ u aplikaciju ili izaberi Prijavi se preko Apple-a / Nastavi sa Google-om na istoj stranici.
Povezano je, ali AI ne može ništa da napravi niti urediTvoj plan je Free ili Basic (samo čitanje), tvoj režim je samo čitanje ili veza nema dozvole za pisanje. Ako je veza napravljena pre nadogradnje, prekini vezu aplikacije pod Povezane aplikacije i poveži je ponovo. Režim možeš da proveriš u Podešavanjima.
Greška „Insufficient scope“ iz alataVeza nema tu dozvolu. Na planovima Free i Basic dozvole za pisanje se nikada ne dodeljuju, pa pravljenje i uređivanje zahtevaju Pro ili Ultra. Ako je veza napravljena pre nadogradnje, prekini vezu aplikacije pod Povezane aplikacije i poveži je ponovo.
Kopirani isečak kaže YOUR_TOKEN i klijent ne može da se povežeKopirano je dok je token bio skriven. U Za programere dodirni Prikaži, pa ponovo kopiraj isečak.
Alati se uopšte ne pojavljujuMCP nije omogućen na tvom nalogu (Podešavanja > Integracije > AI agenti (MCP) > Omogući).
„Daily limit reached“Dva ograničenja koriste ovu poruku. „Daily limit reached: the Free plan includes 100 TellDone requests a day“ je ograničenje zahteva za Free. „Daily limit reached (N/M today)“ znači da je danas preko AI asistenata napravljeno onoliko stavki koliko tvoj plan dozvoljava: process_note, create_note, create_task i create_event se svi računaju, i na planovima Pro i Ultra. Oba se resetuju u ponoć u vremenskoj zoni sačuvanoj u tvom nalogu.
Moj klijent dozvoljava samo biranje sa liste konektora, a TellDone nije na njojTellDone još nije u katalogu konektora nijednog klijenta - dodaj ga kao prilagođeni konektor sa MCP URL-om ili koristi metodu bearer tokena.

Pogledaj i​