Preskoči na glavno vsebino

Agenti UI (MCP)

Na voljo v vsakem paketu

MCP deluje v vseh paketih. Free in Basic dobita dostop samo za branje do vseh 10 orodij za branje (Free je omejen na 100 zahtevkov na dan). Pro in Ultra dobita poln dostop za branje in pisanje (27 orodij) in lahko preklopita v način samo za branje, če jima tako ustreza.

MCP (Model Context Protocol) ti omogoča, da pomočnike UI, kot sta ChatGPT in Claude, pomočnike za programiranje in orodja za avtomatizacijo povežeš neposredno s svojimi podatki TellDone. Ko je povezan, tvoj pomočnik lahko bere tvoje zapiske, opravila, dogodke, poročila, oznake in zgodovino sprememb. Od paketa Pro naprej lahko elemente tudi ustvarja, posodablja, briše in obnavlja. Orodij je 27: 10 za branje (vsak paket) in 17 za pisanje (od paketa Pro naprej).

Na iPhonu Nastavitve > Integracije > Agenti UI (MCP) odpre zaslon za nastavitev MCP s tvojim dostopnim žetonom, ki je privzeto zakrit:

Nastavitve Agenti UI na iPhonu z zakritim žetonom

In na spletu:

Nastavitve Agenti UI na spletu s skritim dostopnim žetonom

Dva načina povezave​

Odjemalca UI lahko povežeš na dva načina:

  1. Prijava s TellDone (OAuth) (priporočeno) - prijaviš se s svojim računom TellDone in odobriš, kar aplikacija zahteva. To uporabljata ChatGPT in Claude, žetona pa ni treba kopirati.
  2. Žeton Bearer - kopiraj svoj dostopni žeton iz Nastavitev in ga prilepi v konfiguracijo svojega odjemalca. Najpreprosteje za skripte, orodja ukazne vrstice in odjemalce, ki nimajo vgrajenega poteka OAuth.
OdjemalecPriporočeno
ChatGPT (chatgpt.com ali namizna aplikacija ChatGPT, ne mobilna aplikacija)OAuth - dodaj strežnik MCP po meri z URL-jem MCP, nato se prijavi
Claude (spletno mesto, Desktop, aplikacija za iPhone) / CoworkOAuth - dodaj povezovalnik po meri z URL-jem MCP, nato se prijavi
Claude Code (CLI)Za zdaj žeton Bearer - dodaj glavo Authorization s svojim žetonom
Skripte ali tvoja lastna kodaŽeton Bearer - najpreprosteje za avtomatizacijo
Odjemalec, ki omogoča samo izbiro s seznama navedenih povezovalnikovTellDone dodaj kot povezovalnik po meri z URL-jem MCP ali uporabi žeton Bearer. TellDone še ni v nobenem imeniku povezovalnikov

Zahteve paketa​

PaketMCP
FreeSamo branje (10 orodij za branje), 100 zahtevkov na dan
BasicSamo branje (10 orodij za branje), brez dnevne omejitve
ProBranje in pisanje (27 orodij) - lahko preklopi v način Samo za branje
UltraBranje in pisanje (27 orodij) - lahko preklopi v način Samo za branje

Omejitev 100 zahtevkov na dan v paketu Free šteje samo klice orodij. Povezovanje, prijava in izpis orodij se ne štejejo. Dan sledi časovnemu pasu, shranjenemu v tvojem računu, in se ponastavi opolnoči. Ko dosežeš omejitev, tvoj pomočnik prejme sporočilo o tem. Orodja za pisanje so v paketih Free in Basic zavrnjena. Z dostopnim žetonom odgovorijo, da je povezava samo za branje in da ustvarjanje in urejanje zahtevata paket Pro ali višji. S prijavo (OAuth) večina odgovori »Insufficient scope«, ker povezave v paketih Free in Basic nikoli ne dobijo dovoljenj za pisanje.

Zaslon v aplikaciji​

Odpri Nastavitve > Integracije in v razdelku Agenti UI tapni Agenti UI (MCP). Zaslon pravi »Naj ChatGPT, Claude in drugi pomočniki UI delajo s tvojimi zapiski, opravili in dogodki v TellDone.« in prikaže tvoj paket:

  • Free: »Tvoj paket: dostop samo za branje, 100 zahtevkov na dan. Pisanje pride s paketom Pro.«
  • Basic: »Tvoj paket: dostop samo za branje«
  • Pro in Ultra: »Tvoj paket: dostop za branje in pisanje«

Dokler je MCP izklopljen, tapni Omogoči, da ga vklopiš.

Ko je omogočen, zaslon prikaže:

  • Način dostopa (Pro in Ultra) - kadar koli izberi Samo za branje ali Branje in pisanje.
  • Poveži pomočnika - koraki za ChatGPT, Claude in Drug pomočnik. V TellDone se prijaviš znotraj pomočnika, zato žeton ni potreben.
  • Povezane aplikacije - pomočniki, ki si jih povezal, vsak z gumbom Prekini povezavo. Dokler ni prve povezave, je prazno.
  • Za razvijalce (privzeto strnjeno) - polje Dostopni žeton (skrito, z gumboma Prikaži / Skrij in Kopiraj), Ustvari nov žeton ter stikalo Claude Code / Cursor / Drugo z že pripravljenim besedilom in lastnim gumbom Kopiraj. Claude Code ti da ukaz claude mcp add, Cursor ti da JSON za .cursor/mcp.json, Drugo pa našteje naslov strežnika, možnost prijave OAuth in glavo Authorization: Bearer. Dokler je žeton skrit, odlomki kažejo YOUR_TOKEN. Tapni Prikaži in vsebujejo tvoj pravi žeton.

Splet ima iste kontrole v drugačni postavitvi, brez strnjenega razdelka za razvijalce: naslov OAuth z gumbom Kopiraj, kontrole za žeton, Povezane aplikacije s Prekini povezavo in Ročna nastavitev žetona Bearer s šestimi izbirami odjemalca (Claude Code, Cursor, Windsurf, Codex, OpenClaw in cURL). Na spletu odlomki vedno vsebujejo tvoj pravi žeton, tudi ko je polje z žetonom skrito, zato z njimi ravnaj kot z žetonom samim.

  • Dokumentacija - povezava na to stran.
  • Onemogoči - izklopi MCP. Potrdiš z »S tem prekličeš dostop za vsa povezana orodja UI.« Tvoj žeton je izbrisan in vse povezave se ustavijo. Če MCP znova omogočiš, dobiš nov žeton, aplikacije, povezane s prijavo (OAuth), pa spet delujejo brez ponovne prijave. Če želiš aplikacijo odstraniti za vedno, tapni Prekini povezavo pod Povezane aplikacije.
nasvet

Svoj dostopni žeton hrani zasebno. Vsak, ki ima žeton, lahko dostopa do tvojih podatkov TellDone. Tapni Ustvari nov žeton, če kdaj sumiš, da je pricurljal.

Kako omogočiti​

MCP lahko nastaviš na obeh platformah:

  • iPhone: Nastavitve > Integracije > Agenti UI (MCP)
  • Splet: app.telldone.app > Nastavitve > Integracije > Agenti UI (MCP)

Koraki:

  1. Tapni Omogoči.
  2. V paketih Pro in Ultra izberi način dostopa (Samo za branje ali Branje in pisanje). Free in Basic sta samo za branje.
  3. Če želiš povezati ChatGPT ali Claude, ga tapni pod Poveži pomočnika in sledi korakom (glej spodaj). Žeton ni potreben.
  4. Za odjemalca za programiranje na iPhonu odpri Za razvijalce, tapni Prikaži, izberi Claude Code, Cursor ali Drugo in tapni Kopiraj pod odlomkom. Če kopiraš, preden tapneš Prikaži, ima odlomek namesto tvojega žetona YOUR_TOKEN. Na spletu pod Ročna nastavitev žetona Bearer izberi svojega odjemalca in kopiraj odlomek; žeton je že v njem.
  5. Odlomek prilepi v svojega odjemalca ali njegovo konfiguracijsko datoteko.

Povezava z OAuth​

OAuth je priporočena pot za ChatGPT, Claude in Cowork - prijaviš se s svojim računom TellDone, namesto da bi kopiral žeton.

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

Isti strežnik odgovarja tudi na https://api.telldone.app/mcp/user/mcp in oba naslova sprejmeta žeton Bearer. Za prijavo z OAuth uporabi prvega.

ChatGPT​

Strežnik MCP po meri lahko dodaš na chatgpt.com ali v namizni aplikaciji ChatGPT. Mobilna aplikacija ChatGPT ne more dodajati povezovalnikov po meri, aplikacija TellDone pa to pove takole: »Aplikacija ChatGPT dodaja samo povezovalnike iz svojega kataloga.« V TellDone tapni Pošlji navodila na moj računalnik, da dobiš navodila na računalnik. Ko je TellDone enkrat dodan tam, je na voljo tudi v mobilni aplikaciji ChatGPT.

Koraki v aplikaciji:

  1. Na računalniku odpri chatgpt.com/plugins, klikni Add in izberi Add custom MCP server.
  2. Poimenuj ga TellDone, prilepi spodnji naslov (https://api.telldone.app/mcp/user) in izberi OAuth.
  3. Potrdi in ga namesti, nato se prijavi v TellDone in dovoli dostop.

Če se imena menijev spremenijo, glej OpenAIjev vodnik o strežnikih MCP po meri.

Claude (spletno mesto, Desktop, aplikacija za iPhone) / Cowork​

Koraki v aplikaciji:

  1. V Claude odpri Customize → Connectors in tapni Add custom connector.
  2. Prilepi spodnji naslov (https://api.telldone.app/mcp/user).
  3. Prijavi se v TellDone in dovoli dostop.

Ko se prijaviš, stran s privolitvijo TellDone pokaže, katera aplikacija zahteva dostop in katera natančna dovoljenja želi. Prijavi se z e-pošto in geslom za TellDone ter klikni Allow access ali tapni Sign in with Apple oziroma Sign in with Google, kar odobri dostop v istem koraku. Claude se poveže sam - žetona ni treba kopirati.

Če se imena menijev spremenijo, glej Anthropicov vodnik o dodajanju povezovalnika po meri.

Povezava z žetonom Bearer​

Za Claude Code, Cursor in druge odjemalce brez vgrajene prijave OAuth prilepi svoj dostopni žeton neposredno v konfiguracijo odjemalca. V vseh spodnjih primerih zamenjaj YOUR_TOKEN z žetonom iz svojih nastavitev.

Claude Code (žeton Bearer)​

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

Tega ti ni treba vtipkati sam: v Nastavitve > Integracije > Agenti UI (MCP) > Za razvijalce tapni Prikaži, izberi Claude Code in tapni Kopiraj. Kopiran ukaz že vsebuje tvoj žeton.

Cursor​

Dodaj v .cursor/mcp.json (ali ga kopiraj iz Za razvijalce > Cursor, ko tapneš Prikaži):

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

Drugi odjemalci​

Nastavitve za druge odjemalce MCP:

Codex​

Dodaj v 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 odjemalci MCP​

Poveže se lahko vsako orodje, ki podpira MCP prek HTTP. Uporabi končno točko https://api.telldone.app/mcp/user/mcp z avtorizacijsko glavo Bearer YOUR_TOKEN.

Nadomestna avtorizacijska glava

Če tvoj odjemalec ali posrednik rezervira glavo Authorization (na primer nekateri prehodi v slogu Smithery), namesto tega pošlji žeton v X-MCP-Token: YOUR_TOKEN. Delujeta obe glavi; če sta prisotni obe, prevlada Authorization.

Preizkus povezave​

Da deluje tvoj žeton, lahko preveriš s preprostim ukazom cURL:

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šen odgovor našteje vsa razpoložljiva orodja.

Dovoljenja (scopes)​

Povezave OAuth imajo omejen obseg - med prijavo natančno vidiš, kaj odjemalec zahteva, in to izrecno odobriš.

ScopeAplikaciji omogoči, da...
notes:readBere tvoje zapiske in odpre celotne podrobnosti zapiska (orodje search potrebuje tudi tasks:read in events:read)
notes:writeUstvarja, ureja in briše zapiske (process_note potrebuje tudi tasks:write in events:write)
tasks:read / tasks:writeBere / ustvarja, ureja, dokončuje in briše opravila
events:read / events:writeBere / ustvarja, ureja in briše dogodke
reports:readBere tvoja dnevna, tedenska, mesečna in letna poročila
tags:read / tags:writeNašteje tvoje oznake / ustvarja, pripenja, briše in obnavlja oznake
profile:readBere podatke o tvojem računu in naročnini
offline_accessOstane prijavljena (izda osvežilni žeton, da se ti ni treba prijaviti znova ob vsaki seji)

Scopes omejujejo, kaj lahko povezava naredi: povezava samo z notes:read ne more poklicati orodja za pisanje. Tvoj paket postavlja še drugo omejitev povrhu.

Povezave z žetonom Bearer nimajo posamičnih scopes - urejata jih samo način branja/pisanja tvojega paketa.

Kaj lahko narediš​

Orodja za branje (10) - vsi paketi​

OrodjeKaj naredi
get_notesNašteje zapiske s filtri (oznake, časovno obdobje, besedilno iskanje)
get_notePrikaže posamezen zapisek z njegovimi podrejenimi opravili, dogodki in celotnim prepisom
get_notes_fullPridobi več zapiskov z vdelanimi opravili in dogodki v enem klicu
get_tasksNašteje opravila, filtrirana po stanju (odprta, opravljena, vsa), oznakah ali datumih
get_eventsNašteje koledarske dogodke, filtrirane po časovnem obdobju
get_reportsBere tvoja dnevna, tedenska, mesečna in letna poročila (celoten markdown)
get_tagsPrikaže vse tvoje oznake, razvrščene po uporabi
get_profilePokaže podatke o tvojem računu in koliko zapiskov, opravil in dogodkov imaš
searchIšče po zapiskih, opravilih in dogodkih (besedilno + semantično iskanje za zapiske)
get_change_logPokaže zgodovino urejanj zapiska, opravila ali dogodka in ali je bilo posamezno urejanje razveljavljeno
nasvet

Orodje search podpira semantično iskanje za zapiske - najde rezultate po pomenu, ne le po ključnih besedah. Na primer, iskanje »sestanki o proračunu« najde zapiske o finančnih razpravah, tudi če ne vsebujejo besede »proračun«.

Orodja za pisanje (17) - Pro in Ultra​

OrodjeKaj naredi
process_noteCeloten cevovod UI - pošlji besedilo ali zvok in dobiš zapisek z opravili, dogodki in oznakami
create_noteDoda navaden besedilni zapisek (brez analize UI)
create_taskDoda opravilo s prioriteto, rokom, opomnikom in oznakami
create_eventDoda koledarski dogodek z datumom, uro, lokacijo, opomniki, udeleženci in pravilom ponavljanja
update_noteSpremeni naslov, povzetek, vrsto, oznake, prioriteta ali stanje zapiska
update_taskSpremeni naslov, opis, prioriteta, rok, opomnik, oznake ali stanje opravila
complete_taskOznači opravilo kot opravljeno
update_eventSpremeni podrobnosti dogodka, čas, lokacijo, opomnike, udeležence, pravilo ponavljanja, oznake ali stanje
delete_noteIzbriše zapisek. Njegova opravila in dogodki ostanejo
delete_taskIzbriše opravilo
delete_eventIzbriše dogodek
undo_change_log_entryRazveljavi eno sledeno urejanje - ki ga je naredil UI ali ti sam - in polju povrne prejšnjo vrednost
restore_entityPovrne izbrisan ali arhiviran zapisek ali opravilo ali izbrisan ali preklican dogodek
create_tagUstvari novo oznako ali samodejno predlagano oznako spremeni v stalno
set_tag_pinnedPripne ali odpne oznako, da se razvrsti na vrh
delete_tagOdstrani oznako (lahko se povrne z restore_tag)
restore_tagPovrne izbrisano oznako

Vsa pisanja in brisanja se takoj pokažejo na tvojih povezanih napravah (telefon, spletna aplikacija).

Referenca orodij​

get_notes​

Našteje zapiske z neobveznim filtriranjem. Filtri datuma uporabljajo recorded_at (ko si posnel glasovni zapisek) ali created_at za zapisek, ki ga nima.

ParameterTypeDefaultDescription
limitint20Število zapiskov za vrnitev (največ 50)
offsetint0Preskoči toliko zapiskov (za oštevilčenje strani, največ 10000)
tagsstring-Filtriraj po oznakah, ločenih z vejicami (ujema se katera koli)
searchstring-Besedilno iskanje po naslovu in povzetku
date_fromstring-Začetni datum, YYYY-MM-DD (vključno)
date_tostring-Končni datum, YYYY-MM-DD (brez)
standalone_onlyboolfalseKo je true, skrije nadaljnje zapiske (zapiske, pripete nadrejenemu zapisku/opravilu/dogodku) in vrne samo samostojne zapiske

Vrne: seznam zapiskov z id, title, summary, type, tags, priority, status, recorded_at, created_at.

get_note​

Pridobi posamezen zapisek z njegovim celotnim prepisom in vsemi povezanimi opravili in dogodki.

ParameterTypeDescription
note_idstringUUID zapiska

Vrne: zapisek z title, summary, transcript, type, tags, priority, status, metadata, created_at ter polji tasks[] in events[].

Vrne tudi transcript_speakers (obrati prepisa z oznakami govorcev, za sestanke z več govorci - sicer null), speaker_count (null, razen če je bil posnetek razdeljen po govorcih) in parent_note_id/parent_task_id/parent_event_id (nastavljeno, ko je ta zapisek nadaljnje urejanje drugega elementa). Vsak vnos tasks[]/events[] vključuje tudi reminders_at/recurrence_rule (opravila) ali reminder_minutes/attendees/recurrence_rule (dogodki).

get_notes_full​

Pridobi več zapiskov z njihovimi opravili in dogodki v enem klicu. Isti filtri kot get_notes, razen search, vsak zapisek pa vključuje vdelana tasks[] in events[].

ParameterTypeDefaultDescription
limitint10Število zapiskov (največ 20)
offsetint0Preskoči toliko zapiskov
tagsstring-Filtriraj po oznakah
date_fromstring-Začetni datum, YYYY-MM-DD
date_tostring-Končni datum, YYYY-MM-DD
standalone_onlyboolfalseKo je true, skrije nadaljnje zapiske (zapiske, pripete nadrejenemu zapisku/opravilu/dogodku) in vrne samo samostojne zapiske

get_tasks​

Našteje opravila s filtriranjem.

ParameterTypeDefaultDescription
statusstring"todo"Filter: todo, done ali all
limitint30Število opravil (največ 100)
offsetint0Preskoči toliko opravil
tagsstring-Filtriraj po oznakah, ločenih z vejicami
date_fromstring-Začetni datum, YYYY-MM-DD (filtrira po roku; opravila brez roka so izključena)
date_tostring-Končni datum, YYYY-MM-DD (filtrira po roku; opravila brez roka so izključena)

Vrne: seznam opravil z id, title, description, status, priority, tags, deadline, reminder_at, reminders_at, completed_at, completed_by, source, created_at. reminder_at zrcali prvi vnos reminders_at zaradi združljivosti za nazaj - uporabi reminders_at, da vidiš vse opomnike opravila.

get_events​

Našteje koledarske dogodke s filtriranjem po časovnem obdobju.

ParameterTypeDefaultDescription
limitint30Število dogodkov (največ 100)
offsetint0Preskoči toliko dogodkov
date_fromstring-Prvi dan, YYYY-MM-DD, v tvojem časovnem pasu (vključno). Dogodki, ki se prekrivajo z obdobjem, so vključeni, zato se večdnevni dogodek pokaže na vsak dan, ki ga zajema
date_tostring-Zadnji dan, YYYY-MM-DD, v tvojem časovnem pasu (vključno)

Vrne: seznam dogodkov z id, title, description, status, start_at, end_at, location, is_all_day, tags, note_id, reminder_minutes, attendees, recurrence_rule, created_at.

get_reports​

Pridobi svoja poročila, ki jih je ustvaril UI, s celotno vsebino v markdownu.

ParameterTypeDefaultDescription
report_typestring"daily"Vrsta: daily, weekly, monthly ali yearly
limitint5Število poročil (največ 10)

Vrne: seznam poročil z id, type, period_start, period_end, content_md, created_at.

opomba

Mesečna poročila so dolga (pogosto precej čez 1.000 besed). Uporabi limit=1, če ima tvoje orodje UI ozko kontekstno okno.

get_tags​

Pridobi vse svoje oznake, razvrščene najprej po pripetih, nato po številu uporab.

Brez parametrov. Vrne do 100 oznak, vsako z tag, usage_count, is_pinned, is_manual.

get_profile​

Pridobi podatke o svojem računu in koliko zapiskov, opravil in dogodkov imaš.

Brez parametrov. Vrne email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at in stats (števila zapiskov/opravil/dogodkov).

Išče hkrati po zapiskih, opravilih in dogodkih. Za zapiske podpira besedilno in semantično iskanje (najde rezultate po pomenu z vdelavami UI).

ParameterTypeDefaultDescription
querystringrequiredIskalno besedilo (največ 500 znakov)
limitint20Največ rezultatov na vrsto (največ 20)
semanticbooltrueOmogoči semantično iskanje za zapiske

Vrne rezultate, razvrščene po vrsti: notes[], tasks[], events[]. Vsak rezultat ima id, type, title, detail, created_at.

Nastavi semantic=false za hitrejše iskanje samo po besedilu.

get_change_log​

Pokaže zgodovino urejanj zapiska, opravila ali dogodka - vsako nadaljnje urejanje, ki ga je naredil UI, in vsako ročno urejanje, ki si ga naredil sam, od najnovejšega.

ParameterTypeDefaultDescription
entitystringrequirednotes, tasks ali events
entity_idstringrequiredUUID elementa
include_manualboolfalseVključi tudi svoja ročna urejanja, ne samo tistih, ki jih je naredil UI

Vrne: seznam vnosov sprememb z id (uporabi ga kot entry_id za razveljavitev), field_name, old_value, new_value, source (follow_up, smart_context, correction_sync za popravek imena, ki ga je TellDone prenesel čez zapisek, ali manual), origin_note_id, edited_at in reverted_at (nastavljeno, ko je razveljavljeno).

process_note (Pro in Ultra)​

Celoten cevovod UI - deluje enako kot snemanje v aplikaciji. Pošlji besedilo ali zvok, TellDone pa ga prepiše, analizira z UI in ustvari strukturiran zapisek z izluščenimi opravili, dogodki, oznakami in vdelavami.

To orodje je asinhrono: takoj vrne audio_id in obdeluje v ozadju. Rezultati prispejo prek sinhronizacije v realnem času na tvoje povezane naprave ali pa lahko poizveduješ s get_notes().

ParameterTypeDescription
textstringObvezno. Besedilo za analizo. Če ni prazno, se uporabi kot prepis in poslani zvok se ne prepisuje; pošlji "", če želiš, da se zvok prepiše. Omejitev, ko zvok ni poslan: Pro 20.000 / Ultra 50.000 znakov
audio_base64stringZvočna datoteka, kodirana v Base64. Celoten zahtevek je omejen na 10 MB, zato je zvok sam lahko velik približno 7 MB. Prepiše se samo, če je text prazen
audio_formatstringm4a, ogg, wav, mp3, aac ali webm (privzeto: m4a)
parent_task_idstringUUID opravila, katerega nadaljevanje je to
parent_note_idstringUUID zapiska, katerega nadaljevanje je to
parent_event_idstringUUID dogodka, katerega nadaljevanje je to

Vedno pošlji text. Če želiš, da TellDone prepiše zvok, pošlji audio_base64 z text, nastavljenim na prazen niz (""). Če text ni prazen, ga TellDone uporabi kot prepis in zvoka ne prepisuje. Nastavi največ enega od treh nadrejenih ID-jev.

Vrne: {"audio_id": "...", "status": "processing", "mode": "text-only"} ali "mode": "audio+stt", če je bil zvok poslan.

opomba

process_note podleže kvotam tvojega paketa (nalaganja na dan, zapiski na mesec, največja dolžina besedila). get_profile kaže samo, koliko zapiskov, opravil in dogodkov imaš, ne tvojih omejitev. Porabo preveriš v aplikaciji pod Nastavitve > Poraba.

create_note (Pro in Ultra)​

Takoj ustvari navaden besedilni zapisek. Ne sproži analize UI - opravila ali dogodki se ne izluščijo. Uporabi process_note, kadar želiš, da TellDone sam najde opravila in dogodke.

ParameterTypeLimitDescription
titlestring200 charsObvezno
summarystring1000 charsNeobvezno. Kratek uvod (1-3 stavki). Uporabi se v tvojih poročilih, zato naj bo kratek
transcriptstringplan-basedNeobvezno. Dolgo telo, prikazano v podrobnostih zapiska. Ni vključeno v poročila. Omejitve: Pro 20.000 / Ultra 50.000 znakov
typestring-Neobvezno. task, idea, info (privzeto), status, meeting, event ali reflection
tagsstring20 tagsLočene z vejicami, neobvezno
suppress_external_syncboolean-Neobvezno, privzeto false. Nastavi na true pri uvoženih ali množičnih elementih: element se takrat ne pošlje v tvoje povezane aplikacije ali avtomatizacije

create_task (Pro in Ultra)​

Ustvari novo opravilo. Opravilo se ustvari tudi v tvojih povezanih aplikacijah Todoist, Notion ali Microsoft To Do, tvoje avtomatizacije pa prejmejo task.created. To se ne zgodi, če podaš suppress_external_sync: true.

ParameterTypeLimitDescription
titlestring200 charsObvezno
descriptionstring2000 charsNeobvezno
prioritystring-low, medium (privzeto) ali high
deadlinestring-YYYY-MM-DD, neobvezno
reminder_atstring-Datum in čas ISO 8601 (na primer 2026-04-15T09:00:00Z), neobvezno
tagsstring20 tagsLočene z vejicami, neobvezno
note_idstring-UUID za povezavo opravila z nadrejenim zapiskom, neobvezno
suppress_external_syncboolean-Neobvezno, privzeto false. Nastavi na true pri uvoženih ali množičnih elementih: element se takrat ne pošlje v tvoje povezane aplikacije ali avtomatizacije

create_event (Pro in Ultra)​

Ustvari koledarski dogodek. Dogodek se ustvari tudi v tvoji povezani aplikaciji Notion, tvoje avtomatizacije pa prejmejo calendar_event.created. To se ne zgodi, če podaš suppress_external_sync: true.

ParameterTypeLimitDescription
titlestring200 charsObvezno
start_atstring-Datum in čas ISO 8601, obvezno
end_atstring-Datum in čas ISO 8601 (privzeto: začetek + 1 ura; pri celodnevnem dogodku en dan)
descriptionstring2000 charsNeobvezno
locationstring200 charsNeobvezno
is_all_daybool-Privzeto: false
tagsstring20 tagsLočene z vejicami, neobvezno
reminder_minutesstring-Minute pred dogodkom, ločene z vejicami (na primer 15,60), neobvezno
attendeesstring-Imena ali e-poštni naslovi, ločeni z vejicami, neobvezno
recurrence_rulestring-Niz RRULE (na primer FREQ=WEEKLY;BYDAY=MO,WE,FR), neobvezno. Pravila, pogostejša od urnih, ali pravila, ki se nikoli ne zgodijo, so zavrnjena
note_idstring-UUID za povezavo dogodka z nadrejenim zapiskom, neobvezno
suppress_external_syncboolean-Neobvezno, privzeto false. Nastavi na true pri uvoženih ali množičnih elementih: element se takrat ne pošlje v tvoje povezane aplikacije ali avtomatizacije

update_note (Pro in Ultra)​

Posodobi eno ali več polj obstoječega zapiska. Spremenijo se samo polja, ki jih podaš. To deluje povsem enako kot urejanje zapiska v aplikaciji: naslov, povzetek, oznake in vrsta pridejo na njegovo stran v Notionu, tvoje avtomatizacije prejmejo note.updated, urejanje pa se pokaže v zgodovini sprememb, kjer ga lahko razveljaviš. Sprememba prepisa se shrani in prav tako pošlje v Notion, vendar je ni v zgodovini sprememb.

ParameterTypeDescription
note_idstringObvezno, UUID zapiska
titlestringNov naslov (največ 200 znakov)
summarystringNov povzetek (največ 1000 znakov, za brisanje podaj presledek " ")
transcriptstringNov prepis (omejitev glede na paket, za brisanje podaj presledek " ")
typestringtask, idea, info, status, meeting, event ali reflection
tagsstringOznake, ločene z vejicami (zamenja vse obstoječe oznake, največ 20)
prioritystringlow, medium ali high
statusstringactive ali archived
previdno

Pri zapiskih, ustvarjenih z glasovnim cevovodom, je transcript izvirni izpis pretvorbe govora v besedilo. Če ga prepišeš, nadomestiš svoje izvirne besede. Če jih želiš ohraniti, prepisu dodaj, namesto da ga zamenjaš.

update_task (Pro in Ultra)​

Posodobi eno ali več polj obstoječega opravila. Spremenijo se samo polja, ki jih podaš. To deluje povsem enako kot urejanje opravila v aplikaciji: sprememba pride do njegovih kopij v aplikacijah Todoist, Notion in Microsoft To Do, tvoje avtomatizacije prejmejo task.updated, urejanje pa se pokaže v zgodovini sprememb opravila, kjer ga lahko razveljaviš. Nastavitev status na done opravilo dokonča enako kot complete_task. Rok je lahko datum ali celoten datum s časom (upošteva se njegov datum). Vsaka oznaka ima lahko največ 50 znakov.

ParameterTypeDescription
task_idstringObvezno, UUID opravila
titlestringNov naslov
descriptionstringNov opis (za brisanje podaj presledek " ")
prioritystringlow, medium ali high
deadlinestringYYYY-MM-DD. To orodje ne more počistiti roka; počisti ga v aplikaciji
statusstringtodo ali done
tagsstringOznake, ločene z vejicami (zamenja vse obstoječe oznake, največ 20)
reminder_atstringDatum in čas ISO 8601 (za brisanje podaj presledek)

Nastavitev status na done zabeleži tudi, kdaj in kako je bilo opravilo dokončano.

complete_task (Pro in Ultra)​

Bližnjica za označitev opravila kot opravljenega.

ParameterTypeDescription
task_idstringObvezno, UUID opravila

Vrne napako, če opravilo ne obstaja ali je že dokončano.

update_event (Pro in Ultra)​

Posodobi eno ali več polj obstoječega dogodka. Spremenijo se samo polja, ki jih podaš. To deluje povsem enako kot urejanje dogodka v aplikaciji: sprememba pride na njegovo stran v Notionu, tvoje avtomatizacije prejmejo calendar_event.updated, urejanje pa se pokaže v zgodovini sprememb, kjer ga lahko razveljaviš.

ParameterTypeDescription
event_idstringObvezno, UUID dogodka
titlestringNov naslov
descriptionstringNov opis (za brisanje podaj presledek)
start_atstringNov začetni čas (ISO 8601)
end_atstringNov končni čas (ISO 8601)
locationstringNova lokacija (za brisanje podaj presledek)
statusstringconfirmed, tentative ali cancelled
tagsstringOznake, ločene z vejicami (zamenja vse obstoječe oznake, največ 20)
is_all_daystring"true" ali "false"
reminder_minutesstringMinute pred dogodkom, ločene z vejicami (na primer 15,60, za brisanje podaj presledek)
attendeesstringImena ali e-poštni naslovi, ločeni z vejicami (za brisanje podaj presledek)
recurrence_rulestringNiz RRULE (za brisanje podaj presledek)

delete_note (Pro in Ultra)​

Izbriše zapisek. Izbriše se samo zapisek: njegova opravila in dogodki ostanejo. To deluje povsem enako kot brisanje v aplikaciji: tvoje avtomatizacije prejmejo note.deleted. Kopija zapiska v Notionu se ne odstrani (tudi aplikacija je ne odstrani).

ParameterTypeDescription
note_idstringObvezno, UUID zapiska

delete_task (Pro in Ultra)​

Izbriše opravilo. To deluje povsem enako kot brisanje v aplikaciji: izbrišejo se tudi njegove kopije v aplikacijah Todoist, Notion in Microsoft To Do, tvoje avtomatizacije pa prejmejo task.deleted. Vrneš ga z restore_entity.

ParameterTypeDescription
task_idstringObvezno, UUID opravila

delete_event (Pro in Ultra)​

Izbriše dogodek. To deluje povsem enako kot brisanje v aplikaciji: tvoje avtomatizacije prejmejo calendar_event.deleted. Stran dogodka v Notionu se ne odstrani (tudi aplikacija je ne odstrani).

ParameterTypeDescription
event_idstringObvezno, UUID dogodka

undo_change_log_entry (Pro in Ultra)​

Razveljavi eno sledeno urejanje - polju povrne vrednost pred tem urejanjem, ne glede na to, ali ga je naredil UI (iz nadaljnjega posnetka) ali ti neposredno.

ParameterTypeDescription
entitystringObvezno, notes, tasks ali events
entity_idstringObvezno, UUID elementa
entry_idstringObvezno, id vnosa spremembe iz get_change_log

Vrne: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Če isti vnos razveljaviš dvakrat, vrne napako - že je razveljavljen.

restore_entity (Pro in Ultra)​

Povrne izbrisan ali arhiviran zapisek ali opravilo ali izbrisan ali preklican dogodek.

ParameterTypeDescription
entitystringObvezno, notes, tasks ali events
entity_idstringObvezno, UUID elementa

Vrne: obnovljeni element kot JSON.

create_tag (Pro in Ultra)​

Ustvari novo oznako ali obstoječo samodejno predlagano oznako spremeni v stalno.

ParameterTypeDescription
tagstringObvezno, 1-50 znakov (shranjeno z malimi črkami)
categorystringNeobvezno

set_tag_pinned (Pro in Ultra)​

Pripne ali odpne oznako, da se razvrsti na vrh tvojega seznama oznak.

ParameterTypeDescription
tagstringObvezno
pinnedboolObvezno

Oznak, ki vsebujejo znak /, ni mogoče pripeti.

delete_tag (Pro in Ultra)​

Odstrani oznako. Lahko se povrne z restore_tag.

ParameterTypeDescription
tagstringObvezno

restore_tag (Pro in Ultra)​

Povrne izbrisano oznako.

ParameterTypeDescription
tagstringObvezno

Omejitve vnosa​

FieldMax lengthUsed in
title200 znakovcreate/update note, task, event
description2.000 znakovcreate/update task, event
summary1.000 znakov (stroga)create/update note. Uporabi se v tvojih poročilih, zato naj bo kratek
transcriptglede na paket: Pro 20.000 / Ultra 50.000create/update note. Dolgo telo, ni v poročilih
textglede na paket: Pro 20.000 / Ultra 50.000 (ko zvok ni poslan)process_note
location200 znakovcreate/update event
tags20 oznakcreate/update note, task, event
search query500 znakovsearch
audio_base64približno 7 MB zvoka (celoten zahtevek je omejen na 10 MB)process_note

Če omejitev presežeš, orodje vrne sporočilo o napaki, kot je "title too long (max 200 chars, got 250)".

Obravnava napak​

Večina orodij vrne napake kot JSON:

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

Napake paketa, scope in omejitev vnosa pridejo kot napaka orodja z istim sporočilom.

Pogoste napake:

ErrorWhen
"This TellDone connection is read-only. Creating and editing needs the Pro or Ultra plan."Orodje za pisanje poklicano v načinu samo za branje (Free in Basic ali Pro in Ultra, preklopljena na samo za branje)
"Daily limit reached: the Free plan includes 100 TellDone requests a day..."Paket Free je porabil svojih 100 zahtevkov za dan
"Daily limit reached (N/M today)"Danes si prek pomočnikov UI ustvaril toliko elementov, kolikor jih dovoljuje tvoj paket (process_note, create_note, create_task in create_event se štejejo vsak)
"Notes limit reached (X/Y this month)"Mesečna omejitev zapiskov tvojega paketa je porabljena
"Invalid note_id format"Kot ID je podan niz, ki ni UUID
"Note not found"ID ne obstaja ali pripada drugemu uporabniku
"Task not found or already completed"complete_task na neobstoječem ali že opravljenem opravilu
"title too long (max 200 chars, got N)"Omejitev vnosa presežena
"Too many tags (max 20)"Podanih več kot 20 oznak

Napake na ravni HTTP:

CodeMeaning
401Neveljaven, preklican ali izbrisan žeton (z onemogočitvijo MCP se tvoj žeton izbriše, z ustvarjanjem novega pa zamenja)
429Presežena omejitev hitrosti (5 zahtevkov/s, konica do 20)

V paketu Free je doseganje omejitve 100 zahtevkov na dan sporočeno kot sporočilo o napaki orodja (ne kot koda HTTP) in se ponastavi opolnoči v časovnem pasu, shranjenem v tvojem računu.

Primeri uporabe​

Vsi primeri uporabljajo cURL s protokolom MCP JSON-RPC. YOUR_TOKEN zamenjaj s svojim dostopnim žetonom.

Branje podatkov​

# 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 podatkov (Pro in 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šen odgovor izgleda takole:

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

Orodja za pisanje in posodabljanje vrnejo kratke odgovore, večinoma id, title in status. Orodja za brisanje vrnejo id in deleted. Če želiš po pisanju dobiti polne podrobnosti (oznake, prioriteta, rok itd.), opravi nadaljnji klic za branje, na primer get_tasks ali get_note.

Upravljanje žetona​

DejanjeKako
Ogled žetonaiPhone Nastavitve > Integracije > Agenti UI (MCP) > Za razvijalce (ali na spletu Nastavitve > Integracije > Agenti UI (MCP)), tapni Prikaži
Kopiranje žetonaTapni Kopiraj poleg žetona
Ustvarjanje novegaTapni Ustvari nov žeton in potrdi. Stari žeton preneha delovati takoj. Pomočnikov, povezanih s prijavo OAuth, to ne prizadene; prekini njihovo povezavo pod Povezane aplikacije
Sprememba načinaPro in Ultra: izberi Samo za branje ali Branje in pisanje. Free in Basic sta vedno samo za branje
OnemogočitevTapni Onemogoči in potrdi (»S tem prekličeš dostop za vsa povezana orodja UI.«). Tvoj žeton je izbrisan in vse povezave se ustavijo. Če MCP znova omogočiš, dobiš nov žeton, aplikacije, povezane s prijavo (OAuth), pa spet delujejo brez ponovne prijave. Če želiš aplikacijo odstraniti za vedno, tapni Prekini povezavo pod Povezane aplikacije

Kaj lahko vprašaš svojega agenta UI​

Ko je povezan, svoje orodje UI vprašaj na primer:

Oglej si svoj dan:

  • »Pri čem sem danes delal?«
  • »Pokaži mi moje zapiske s tega tedna«
  • »Katera opravila so zamujena?«

Upravljaj opravila:

  • »Ustvari opravilo: pregled četrtletnega poročila, visoka prioriteta, rok petek«
  • »Označi opravilo Figma kot opravljeno«
  • »Pri katerih opravilih trenutno delam?«

Išči in analiziraj:

  • »Najdi vse zapiske o marketinški strategiji«
  • »Kateri dogodki me čakajo naslednji teden?«
  • »Povzemi moja dnevna poročila iz prejšnjega tedna«

Načrtuj naprej:

  • »Ustvari dogodek: jutri ob 10h sestanek ekipe«
  • »Kaj je v mojem koledarju ta teden?«
  • »Pokaži mi moje najpogostejše oznake - čemu posvečam največ časa?«

Tvoj pomočnik lahko bere tvoje zapiske, opravila, dogodke in poročila ter odgovarja na zahtevna vprašanja s kombiniranjem informacij iz več orodij. V paketih Pro in Ultra z vklopljenim načinom Branje in pisanje jih lahko tudi ustvarja, posodablja in briše.

Dobro je vedeti​

  • Integracije in avtomatizacije - process_note deluje kot snemanje, zato njegov zapisek, opravila in dogodki gredo v tvoje povezane integracije in avtomatizacije z webhooki. Elementi, ki jih z drugimi orodji za pisanje ustvariš, urediš ali izbrišeš, se obnašajo povsem enako kot v aplikaciji: pridejo v tvoje povezane integracije (dogodki in urejanja zapiskov samo v Notion) in v tvoje avtomatizacije. Obnovitev opravila z restore_entity ali razveljavitev njegovega dokončanja z undo_change_log_entry opravilo znova odpre tudi v integracijah, s katerimi je bilo usklajeno.
  • Urejanja pomočnika UI - v zgodovini sprememb elementa so označena, da jih je naredil pomočnik. Ne uporabljajo se za učenje prepoznavanja govora v TellDone in se ne prenesejo na druge elemente zapiska. Urejanja prek pomočnika si z aplikacijo delijo omejitev 30 urejanj na minuto.
  • Semantično iskanje - zapiski, ustvarjeni s process_note ali create_note, oba dobita vdelave, zato se po kratkem zamiku pokažejo v semantičnem iskanju.
  • Filtri datuma - pri zapiskih so datumi dnevi UTC. Pri dogodkih so datumi tvoji lokalni dnevi, dogodek, ki se prekriva z obdobjem, pa je vključen. Pri opravilih je filter datum roka.

Varnost​

  • Vsak uporabnik dobi enolični 384-bitni dostopni žeton
  • Tvoj žeton je preklican takoj, ko MCP onemogočiš ali ustvariš nov žeton
  • Vsak zahtevek je omejen na tvoj račun, zato tvoj agent lahko dostopa samo do tvojih podatkov
  • Povezava uporablja HTTPS z omejevanjem hitrosti (5 zahtevkov/s, konica do 20)
  • Povezave OAuth uporabljajo PKCE z enkratnimi avtorizacijskimi kodami in kratkotrajnimi dostopnimi žetoni - povezavo lahko kadar koli prekličeš v aplikaciji

Za tehnični podrobni pregled - končne točke za odkrivanje, življenjske dobe žetonov, celoten potek OAuth - glej našo odprtokodno referenco povezovalnika na github.com/exp78/telldone-mcp ali neposredno poizveduj na https://api.telldone.app/.well-known/oauth-protected-resource.

Zasebnost in tok podatkov​

Povezano orodje UI dobi tvoje podatke samo, ko pokliče TellDone, običajno zato, ker si ga nekaj vprašal. Prejme samo odgovore na te klice, v okviru dovoljenj, ki si jih odobril. Če želiš omejiti dostop, preklopi na Samo za branje, prekini povezavo aplikacije pod Povezane aplikacije ali pa v Nastavitvah ustvari nov dostopni žeton ali ga onemogoči. Vse podrobnosti najdeš v Pravilniku o zasebnosti, za vprašanja pa piši na support@telldone.app.

Odpravljanje težav​

SimptomVzrok / rešitev
Stran s privolitvijo OAuth pravi »Wrong email or password«Uporabi e-pošto in geslo, s katerima se prijavljaš v aplikacijo, ali na isti strani izberi Sign in with Apple / Sign in with Google.
Povezano, vendar UI ne more ničesar ustvariti ali ureditiTvoj paket je Free ali Basic (samo branje), tvoj način je samo branje ali pa povezava nima dovoljenj za pisanje. Če si se povezal, preden si nadgradil, prekini povezavo aplikacije pod Povezane aplikacije in jo poveži znova. Svoj način lahko preveriš v Nastavitvah.
Napaka »Insufficient scope« iz orodjaPovezava nima tega dovoljenja. V paketih Free in Basic dovoljenja za pisanje niso nikoli odobrena, zato ustvarjanje in urejanje zahtevata Pro ali Ultra. Če si se povezal, preden si nadgradil, prekini povezavo aplikacije pod Povezane aplikacije in jo poveži znova.
Kopiran odlomek pravi YOUR_TOKEN in odjemalec se ne more povezatiKopiral si ga, ko je bil žeton skrit. V Za razvijalce tapni Prikaži in odlomek kopiraj znova.
Orodij sploh niMCP ni omogočen v tvojem računu (Nastavitve > Integracije > Agenti UI (MCP) > Omogoči).
»Daily limit reached«To sporočilo uporabljata dve omejitvi. »Daily limit reached: the Free plan includes 100 TellDone requests a day« je omejitev zahtevkov v paketu Free. »Daily limit reached (N/M today)« pomeni, da si danes prek pomočnikov UI ustvaril toliko elementov, kolikor jih dovoljuje tvoj paket: process_note, create_note, create_task in create_event se štejejo vsak, tudi v paketih Pro in Ultra. Obe se ponastavita opolnoči v časovnem pasu, shranjenem v tvojem računu.
Moj odjemalec dovoljuje samo izbiro s seznama povezovalnikov, TellDone pa ni na njemTellDone ni v nobenem imeniku povezovalnikov odjemalcev - dodaj ga kot povezovalnik po meri z URL-jem MCP ali uporabi metodo z žetonom Bearer.

Glej tudi​