Dostop MCP (agenti AI)

Kaj se je nedavno spremenilo

MCP je zdaj v celoti na voljo na iPhonu (poleg spletne aplikacije). Zaslon iPhona zrcali spletnega in vključuje enake delčke za nastavitev za vse podprte odjemalce AI.

Paket Pro in višji

Dostop MCP zahteva paket Pro ali Ultra. Oba paketa dobita poln dostop za branje + pisanje (27 orodij) in lahko preklopita v način samo za branje, če želita.

MCP (Model Context Protocol) ti omogoča, da pomočnike za kodiranje z AI in orodja za avtomatizacijo povežeš neposredno s svojimi podatki TellDone. Ko je povezan, lahko tvoj agent AI bere tvoje zapiske, opravila, dogodke, poročila, oznake in zgodovino sprememb - ter ustvarja, posodablja, briše in obnavlja elemente. Skupaj je 27 orodij: 10 za branje podatkov in 17 za pisanje.

Na voljo tako v aplikaciji za iPhone (Nastavitve → Integracije → Agenti AI) kot v spletni aplikaciji (Nastavitve → Agenti AI).

Na iPhonu Nastavitve → Integracije → Agenti AI odpre zaslon za nastavitev MCP s tvojim dostopnim žetonom, ki je privzeto zakrit:

In na spletu:

Dva načina povezave

Odjemalca AI lahko overiš na dva načina, oba pa sta v celoti podprta:

1. OAuth 2.1 (priporočeno) - standardni potek privolitve "Prijava z TellDone". To uporabljata povezovalni vmesnik Claude Desktop in Claude.ai. Brez kopiranja žetonov - prijaviš se s svojim računom TellDone in odobriš dovoljenja, ki jih odjemalec zahteva.
2. Žeton bearer - kopiraj svoj osebni dostopni žeton iz Nastavitev in ga prilepi v konfiguracijo svojega odjemalca. Najpreprosteje za skripte, CLI-je in odjemalce, ki nimajo vgrajenega poteka OAuth.

Odjemalec	Priporočeno
Claude Desktop / Cowork	OAuth - dodaj povezovalnik po meri z URL-jem MCP, nato se prijavi
Claude Code (CLI)	Oboje - claude mcp add te vodi skozi OAuth v tvojem brskalniku ali dodaj glavo Bearer za metodo z žetonom
Skripte ali tvoja lastna koda	Žeton bearer - najpreprosteje za avtomatizacijo
Odjemalec, ki podpira samo izbiro iz imenika navedenih povezovalnikov	Za zdaj uporabi žeton bearer ali most mcp-remote - TellDone še ni v nobenem imeniku povezovalnikov

Zahteve paketa

Paket	MCP
Free	Zaklenjeno
Basic	Zaklenjeno
Pro	Branje + pisanje (27 orodij) - lahko preklopi v način samo za branje
Ultra	Branje + pisanje (27 orodij) - lahko preklopi v način samo za branje

Zaslon v aplikaciji

Zaslon Agenti AI ima tri stanja glede na tvoj paket in glede na to, ali je MCP vklopljen.

Zaklenjeno (Free in Basic)

Če si na paketu Free ali Basic, zaslon pojasni, kaj MCP počne, in prikaže gumb Nadgradi. Tap nanj odpre plačilno steno, kjer lahko preideš na Pro ali Ultra.

Onemogočeno (Pro in Ultra, funkcija izklopljena)

Če si na Pro ali Ultra, a MCP še nisi vklopil, zaslon prikaže kratek povzetek tega, kaj tvoj paket zmore (število orodij, način dostopa, kvote) in gumb Omogoči. Tapni ga, da ustvariš svoj povezovalni žeton in začneš integracijo.

Omogočeno

Ko je omogočeno, zaslon prikaže vse, kar potrebuješ za povezavo odjemalca AI:

• Preklop načina - na Ultra lahko preklapljaš med samo za branje in branje + pisanje. Na Pro je način fiksno nastavljen na branje + pisanje.
• Vrstica Dostopni žeton s preklopom v obliki očesa za razkritje ali skritje žetona in gumbom za kopiranje.
• Izbirnik nastavitve z zavihki za Claude Code, Cursor, Windsurf in Other. Ustrezni delček kode se pojavi pod zavihki - samo kopiraj in prilepi ga v svojega odjemalca AI.
• Gumb Ponovno ustvari - takoj zamenja žeton in prekine vse dejavne seje, ki uporabljajo starega.
• Gumb Onemogoči - izklopi MCP in izbriše žeton. Pozneje lahko znova omogočiš, a bo izdan nov žeton.

nasvet

Svoj povezovalni žeton hrani zaseben. Vsak z žetonom lahko dostopa do tvojih podatkov TellDone. Uporabi Ponovno ustvari, če kdaj posumiš, da je žeton pricurljal.

Kako omogočiti

MCP lahko konfiguriraš z ene ali druge platforme:

• iPhone: Nastavitve → Integracije → Agenti AI (MCP)
• Splet: app.telldone.app → Nastavitve → Agenti AI

Koraki:

1. Tapni Omogoči.
2. Izberi svoj način dostopa (samo Ultra - Pro je vedno branje + pisanje).
3. Razkrij in kopiraj svoj žeton z ikonama očesa in kopiranja.
4. Izberi svoje orodje v razdelku Nastavitev (Claude Code, Cursor, Windsurf ali Other).
5. Prilepi delček v konfiguracijo svojega odjemalca AI.

Povezovanje z OAuth

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

URL MCP za OAuth: https://api.telldone.app/mcp/user (brez končnega /mcp - to je drug URL, uporabljen samo za pot z žetonom bearer spodaj)

Claude Desktop / Cowork

1. V odjemalcu izberi Add custom connector.
2. Vnesi URL strežnika: https://api.telldone.app/mcp/user
3. Odjemalec odpre stran za privolitev TellDone v tvojem brskalniku. Videl boš, katera aplikacija zahteva dostop, natančna dovoljenja, ki jih želi, in obrazec za prijavo.
4. Prijavi se z e-poštnim naslovom in geslom svojega računa TellDone, nato klikni Allow.
5. Odjemalec samodejno prejme dostopni žeton in se poveže - brez kopiranja žetonov.

opomba

Prijava na strani za privolitev uporablja e-poštni naslov in geslo tvojega računa TellDone. Če ima tvoj račun samo prijavo z Apple ali Google (brez nastavljenega gesla), za zdaj uporabi spodnjo metodo z žetonom bearer.

Claude Code

OAuth (odpre prijavo v brskalniku):

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

Claude Code samodejno odkrije potek OAuth, a te ob prvem klicu ne prijavi - zaženi /mcp znotraj Claude Code in izberi Authenticate, da odpreš prijavo v brskalniku. Po tem namesto tebe osvežuje tvoj dostopni žeton - ni ničesar za vzdrževati.

Žeton bearer (brez brskalnika, dobro za nastavitve brez glave):

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

Svoj YOUR_TOKEN dobiš v aplikaciji: Nastavitve → Integracije → Agenti AI → Kopiraj žeton (glej Kako omogočiti zgoraj).

Povezovanje z žetonom bearer

Za odjemalce brez vgrajene podpore za OAuth - Cursor, Windsurf in druge - prilepi svoj osebni dostopni žeton neposredno v konfiguracijo odjemalca. V vseh spodnjih primerih zamenjaj YOUR_TOKEN z žetonom iz svojih nastavitev.

Cursor

Dodaj v .cursor/mcp.json:

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

Windsurf

Dodaj v .codeium/windsurf/mcp_config.json:

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

Other

Te delčke uporabi za odjemalce, ki jih izbirnik v aplikaciji združuje pod Other.

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.

Alternativna glava za avtentikacijo

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

Preizkušanje povezave

Delovanje svojega žetona 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 odziv našteje vsa razpoložljiva orodja.

Dovoljenja (obsegi)

Povezave OAuth so obsežene - med prijavo vidiš natanko, kaj odjemalec zahteva, in to izrecno odobriš.

Obseg	Aplikaciji omogoča...
notes:read	Branje tvojih zapiskov, iskanje, odpiranje celotnih podrobnosti zapiska
notes:write	Ustvarjanje, urejanje, brisanje zapiskov (in izvajanje poteka glasovnih zapiskov)
tasks:read / tasks:write	Branje / ustvarjanje, urejanje, zaključevanje in brisanje opravil
events:read / events:write	Branje / ustvarjanje, urejanje in brisanje dogodkov
reports:read	Branje tvojih dnevnih, tedenskih, mesečnih in letnih poročil
tags:read / tags:write	Naštevanje tvojih oznak / ustvarjanje in preimenovanje oznak
profile:read	Branje tvojega profila in podatkov o naročnini
offline_access	Ostati povezan, ko te ni (izda žeton za osvežitev, tako da se ti ni treba prijavljati ob vsaki seji)

Obsegi so zgornja meja, ne jamstvo - povezava samo z notes:read ne more klicati orodja za pisanje, ne glede na to, kar ji naročiš. Tvoj paket je drugi filter poleg obsegov.

Povezave z žetonom bearer niso obsežene posamično - urejata jih samo način branja/pisanja tvojega paketa.

Kaj lahko počneš

Orodja za branje (10) - Pro in Ultra

Orodje	Kaj počne
get_notes	Naštej zapiske s filtri (oznake, časovni razpon, iskanje besedila)
get_note	Poglej en zapisek z njegovimi podrejenimi opravili, dogodki in celotnim prepisom
get_notes_full	Pridobi več zapiskov z vgnezdenimi opravili in dogodki v enem klicu
get_tasks	Naštej opravila, filtrirana po stanju (to-do, done, all), oznakah ali datumih
get_events	Naštej koledarske dogodke, filtriraj po časovnem razponu
get_reports	Preberi svoja dnevna, tedenska, mesečna in letna poročila (celoten markdown)
get_tags	Poglej vse svoje oznake, razvrščene po uporabi
get_profile	Poglej podatke o svojem računu in statistiko porabe
search	Išči po zapiskih, opravilih in dogodkih (besedilno + pomensko iskanje za zapiske)
get_change_log	Poglej zgodovino urejanj zapiska, opravila ali dogodka in ali je bilo vsako urejanje razveljavljeno

nasvet

Orodje search podpira pomensko iskanje za zapiske - najde rezultate po pomenu, ne le po ključnih besedah. Na primer, iskanje "sestanki o proračunu" bo našlo zapiske o finančnih razpravah, tudi če ne vsebujejo besede "proračun".

Orodja za pisanje (17) - Pro in Ultra

Orodje	Kaj počne
process_note	Celoten potek AI - pošlji besedilo ali zvok, dobiš nazaj zapisek z opravili, dogodki in oznakami
create_note	Dodaj navaden besedilni zapisek (brez analize AI)
create_task	Dodaj opravilo s prioriteto, rokom, opomnikom in oznakami
create_event	Dodaj koledarski dogodek z datumom, uro, lokacijo, opomniki, udeleženci in ponavljanjem
update_note	Spremeni naslov, povzetek, vrsto, oznake, prioriteto ali stanje zapiska
update_task	Spremeni naslov, opis, prioriteto, rok, opomnik, oznake ali stanje opravila
complete_task	Označi opravilo kot opravljeno
update_event	Spremeni podrobnosti, uro, lokacijo, opomnike, udeležence, ponavljanje, oznake ali stanje dogodka
delete_note	Izbriši zapisek in vsa njegova povezana opravila in dogodke
delete_task	Izbriši opravilo
delete_event	Izbriši dogodek
undo_change_log_entry	Razveljavi eno sledeno urejanje - narejeno z AI ali tvoje lastno - in obnovi prejšnjo vrednost polja
restore_entity	Prikliči nazaj izbrisan ali arhiviran zapisek, opravilo ali dogodek
create_tag	Ustvari novo oznako ali samodejno predlagano oznako spremeni v trajno
set_tag_pinned	Pripni ali odpni oznako, da se razvrsti na vrh
delete_tag	Odstrani oznako (mogoče jo je obnoviti z restore_tag)
restore_tag	Prikliči nazaj izbrisano oznako

Vse operacije pisanja in brisanja se prek sprotne sinhronizacije takoj pojavijo na tvojih povezanih napravah (telefon, spletna aplikacija).

Referenca orodij

get_notes

Naštej zapiske z izbirnim filtriranjem. Filtri datuma uporabljajo recorded_at (kdaj si posnel glasovni zapisek), ne created_at.

Parameter	Tip	Privzeto	Opis
limit	int	20	Število zapiskov za vrnitev (največ 50)
offset	int	0	Preskoči toliko zapiskov (za razčlembo na strani, največ 10000)
tags	string	-	Filtriraj po oznakah, ločenih z vejico (ujema se s katero koli)
search	string	-	Iskanje besedila po naslovu in povzetku
date_from	string	-	Začetni datum, YYYY-MM-DD (vključno)
date_to	string	-	Končni datum, YYYY-MM-DD (izključno)
standalone_only	bool	false	Ko je true, skrije nadaljnje zapiske (zapiske, priložene 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 en zapisek z njegovim celotnim prepisom in vsemi povezanimi opravili in dogodki.

Parameter	Tip	Opis
note_id	string	UUID zapiska

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

Vrne tudi transcript_speakers (prepis, označen po govorcih, 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. Enaki filtri kot get_notes, a vsak zapisek vključuje vgnezdena tasks[] in events[].

Parameter	Tip	Privzeto	Opis
limit	int	10	Število zapiskov (največ 20)
offset	int	0	Preskoči toliko zapiskov
tags	string	-	Filtriraj po oznakah
date_from	string	-	Začetni datum, YYYY-MM-DD
date_to	string	-	Končni datum, YYYY-MM-DD
standalone_only	bool	false	Ko je true, skrije nadaljnje zapiske (zapiske, priložene nadrejenemu zapisku/opravilu/dogodku) in vrne samo samostojne zapiske

get_tasks

Naštej opravila s filtriranjem.

Parameter	Tip	Privzeto	Opis
status	string	"todo"	Filter: todo, done ali all
limit	int	30	Število opravil (največ 100)
offset	int	0	Preskoči toliko opravil
tags	string	-	Filtriraj po oznakah, ločenih z vejico
date_from	string	-	Začetni datum, YYYY-MM-DD (filtrira po roku; opravila brez roka so izključena)
date_to	string	-	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 zaradi združljivosti za nazaj zrcali prvi vnos iz reminders_at - uporabi reminders_at, da vidiš vse opomnike opravila.

get_events

Naštej koledarske dogodke s filtriranjem po časovnem razponu.

Parameter	Tip	Privzeto	Opis
limit	int	30	Število dogodkov (največ 100)
offset	int	0	Preskoči toliko dogodkov
date_from	string	-	Začetni datum, YYYY-MM-DD (filtrira po času začetka dogodka)
date_to	string	-	Končni datum, YYYY-MM-DD

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 ustvari AI, s celotno vsebino markdown.

Parameter	Tip	Privzeto	Opis
report_type	string	"daily"	Vrsta: daily, weekly, monthly ali yearly
limit	int	5	Š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 imajo lahko 3.000-5.000 besed. Uporabi limit=1, če ima tvoje orodje AI 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 statistiko porabe.

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

search

Išči po zapiskih, opravilih in dogodkih naenkrat. Za zapiske podpira tako iskanje besedila kot pomensko iskanje (najde rezultate po pomenu z vdelavami AI).

Parameter	Tip	Privzeto	Opis
query	string	obvezno	Iskalno besedilo (največ 500 znakov)
limit	int	20	Največ rezultatov na vrsto (največ 20)
semantic	bool	true	Omogoči pomensko 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

Poglej zgodovino urejanj zapiska, opravila ali dogodka - vsako nadaljnje urejanje, ki ga je naredil AI, in vsako ročno urejanje, ki si ga naredil sam, najnovejše najprej.

Parameter	Tip	Privzeto	Opis
entity	string	obvezno	notes, tasks ali events
entity_id	string	obvezno	UUID elementa
include_manual	bool	false	Vključi tudi tvoja lastna ročna urejanja, ne le tista, ki jih je naredil AI

Vrne: seznam vnosov sprememb z id (uporabi to kot entry_id za razveljavitev), field_name, old_value, new_value, source (follow_up, smart_context ali manual), origin_note_id, edited_at in reverted_at (nastavljeno, ko je razveljavljeno).

process_note (Pro in Ultra)

Celoten potek AI - deluje enako kot snemanje v aplikaciji. Pošlji besedilo ali zvok in TellDone bo prepisal, analiziral z AI in ustvaril 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 sprotne sinhronizacije na tvoje povezane naprave ali pa jih poizvedeš z get_notes().

Parameter	Tip	Opis
text	string	Besedilo za analizo (preskoči prepis, če ni podanega zvoka)
audio_base64	string	Zvočna datoteka, kodirana v Base64 (do 50 MB, sproži prepis)
audio_format	string	m4a, ogg, wav, mp3, aac ali webm (privzeto: m4a)
parent_task_id	string	UUID opravila, ki mu je to nadaljevanje
parent_note_id	string	UUID zapiska, ki mu je to nadaljevanje
parent_event_id	string	UUID dogodka, ki mu je to nadaljevanje

Podati moraš bodisi text bodisi audio_base64 (ali oboje - zvok ima prednost pri prepisu).

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

opomba

process_note je podvržen kvotam tvojega paketa (nalaganja na dan, zapiski na mesec, največja dolžina besedila). Uporabi get_profile, da preveriš svojo trenutno porabo.

create_note (Pro in Ultra)

Takoj ustvari navaden besedilni zapisek. Ne sproži analize AI - izluščena niso ne opravila ne dogodki. Za celotno analizo AI z izluščenjem opravil/dogodkov namesto tega uporabi process_note.

Parameter	Tip	Omejitev	Opis
title	string	200 znakov	Obvezno
summary	string	1000 znakov	Izbirno. Kratek napovednik (1-3 stavki). Vključen v pozive poročil, zato bodi jedrnat
transcript	string	glede na paket	Izbirno. Daljše telo, prikazano v podrobnostih zapiska. Ni vključeno v poročila. Omejitve: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000 znakov
type	string	-	Izbirno. task, idea, info (privzeto), status, meeting, event ali reflection
tags	string	20 oznak	Ločeno z vejico, izbirno

create_task (Pro in Ultra)

Ustvari novo opravilo.

Parameter	Tip	Omejitev	Opis
title	string	200 znakov	Obvezno
description	string	2000 znakov	Izbirno
priority	string	-	low, medium (privzeto) ali high
deadline	string	-	YYYY-MM-DD, izbirno
reminder_at	string	-	Datum in čas ISO 8601 (npr. 2026-04-15T09:00:00Z), izbirno
tags	string	20 oznak	Ločeno z vejico, izbirno
note_id	string	-	UUID za povezavo opravila z nadrejenim zapiskom, izbirno

create_event (Pro in Ultra)

Ustvari koledarski dogodek.

Parameter	Tip	Omejitev	Opis
title	string	200 znakov	Obvezno
start_at	string	-	Datum in čas ISO 8601, obvezno
end_at	string	-	Datum in čas ISO 8601 (privzeto: začetek + 1 ura)
description	string	2000 znakov	Izbirno
location	string	200 znakov	Izbirno
is_all_day	bool	-	Privzeto: false
tags	string	20 oznak	Ločeno z vejico, izbirno
reminder_minutes	string	-	Minute pred dogodkom, ločene z vejico (npr. 15,60), izbirno
attendees	string	-	Imena ali e-poštni naslovi, ločeni z vejico, izbirno
recurrence_rule	string	-	Niz RRULE (npr. FREQ=WEEKLY;BYDAY=MO,WE,FR), izbirno
note_id	string	-	UUID za povezavo dogodka z nadrejenim zapiskom, izbirno

update_note (Pro in Ultra)

Posodobi eno ali več polj obstoječega zapiska. Spremenijo se samo polja, ki jih podaš.

Parameter	Tip	Opis
note_id	string	Obvezno, UUID zapiska
title	string	Nov naslov (največ 200 znakov)
summary	string	Nov povzetek (največ 1000 znakov, podaj presledek " " za počiščenje)
transcript	string	Nov prepis (omejitev glede na paket, podaj presledek " " za počiščenje)
type	string	task, idea, info, status, meeting, event ali reflection
tags	string	Oznake, ločene z vejico (zamenja vse obstoječe oznake, največ 20)
priority	string	low, medium ali high
status	string	active ali archived

previdno

Pri zapiskih, ki jih ustvari glasovni potek, je transcript izvirni izpis pretvorbe govora v besedilo. Njegovo prepisovanje zamenja kanonični vir - razmisli, da mu raje pripneš vsebino, če želiš ohraniti izvirnik.

update_task (Pro in Ultra)

Posodobi eno ali več polj obstoječega opravila. Spremenijo se samo polja, ki jih podaš.

Parameter	Tip	Opis
task_id	string	Obvezno, UUID opravila
title	string	Nov naslov
description	string	Nov opis (podaj presledek " " za počiščenje)
priority	string	low, medium ali high
deadline	string	YYYY-MM-DD (podaj presledek za počiščenje)
status	string	todo ali done
tags	string	Oznake, ločene z vejico (zamenja vse obstoječe oznake, največ 20)
reminder_at	string	Datum in čas ISO 8601 (podaj presledek za počiščenje)

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.

Parameter	Tip	Opis
task_id	string	Obvezno, 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š.

Parameter	Tip	Opis
event_id	string	Obvezno, UUID dogodka
title	string	Nov naslov
description	string	Nov opis (podaj presledek za počiščenje)
start_at	string	Nov čas začetka (ISO 8601)
end_at	string	Nov čas konca (ISO 8601)
location	string	Nova lokacija (podaj presledek za počiščenje)
status	string	confirmed, tentative ali cancelled
tags	string	Oznake, ločene z vejico (zamenja vse obstoječe oznake, največ 20)
is_all_day	string	"true" ali "false"
reminder_minutes	string	Minute pred dogodkom, ločene z vejico (npr. 15,60)
attendees	string	Imena ali e-poštni naslovi, ločeni z vejico
recurrence_rule	string	Niz RRULE (podaj presledek za počiščenje)

delete_note (Pro in Ultra)

Izbriši zapisek. To izbriše tudi vsa opravila in dogodke, ki so bili ustvarjeni iz tega zapiska.

Parameter	Tip	Opis
note_id	string	Obvezno, UUID zapiska

delete_task (Pro in Ultra)

Izbriši opravilo.

Parameter	Tip	Opis
task_id	string	Obvezno, UUID opravila

delete_event (Pro in Ultra)

Izbriši dogodek.

Parameter	Tip	Opis
event_id	string	Obvezno, UUID dogodka

undo_change_log_entry (Pro in Ultra)

Razveljavi eno sledeno urejanje - obnovi polje na vrednost pred tem urejanjem, naj je bilo urejanje narejeno z AI (iz nadaljnjega posnetka) ali neposredno s tvoje strani.

Parameter	Tip	Opis
entity	string	Obvezno, notes, tasks ali events
entity_id	string	Obvezno, UUID elementa
entry_id	string	Obvezno, id vnosa spremembe iz get_change_log

Vrne: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Dvakratna razveljavitev istega vnosa vrne napako - že je razveljavljen.

restore_entity (Pro in Ultra)

Prikliči nazaj izbrisan ali arhiviran zapisek, opravilo ali dogodek.

Parameter	Tip	Opis
entity	string	Obvezno, notes, tasks ali events
entity_id	string	Obvezno, UUID elementa

Vrne: obnovljeni element kot JSON.

create_tag (Pro in Ultra)

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

Parameter	Tip	Opis
tag	string	Obvezno, 1-50 znakov (shranjeno z malimi črkami)
category	string	Izbirno

set_tag_pinned (Pro in Ultra)

Pripni ali odpni oznako, da se razvrsti na vrh tvojega seznama oznak.

Parameter	Tip	Opis
tag	string	Obvezno
pinned	bool	Obvezno

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

delete_tag (Pro in Ultra)

Odstrani oznako. Mogoče jo je priklicati nazaj z restore_tag.

Parameter	Tip	Opis
tag	string	Obvezno

restore_tag (Pro in Ultra)

Prikliči nazaj izbrisano oznako.

Parameter	Tip	Opis
tag	string	Obvezno

Omejitve vnosa

Polje	Največja dolžina	Uporabljeno v
title	200 znakov	create/update note, task, event
description	2.000 znakov	create/update task, event
summary	1.000 znakov (trda)	create/update note. Vključeno v pozive poročil, kratko, da nadzoruje stroške žetonov
transcript	glede na paket: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000	create/update note. Daljše telo, ni v poročilih
location	200 znakov	create/update event
tags	20 oznak	create/update note, task, event
search query	500 znakov	search
audio_base64 (dekodirano)	50 MB	process_note

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

Obravnava napak

Vsa orodja vrnejo JSON. Napake uporabljajo to obliko:

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

Pogoste napake:

Napaka	Kdaj
"MCP access is read-only..."	Orodje za pisanje klicano v načinu samo za branje
"Invalid note_id format"	Kot ID 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)"	Presežena omejitev vnosa
"Too many tags (max 20)"	Podanih več kot 20 oznak

Napake na ravni HTTP:

Koda	Pomen
401	Neveljaven ali manjkajoč žeton Bearer
403	MCP onemogočen ali paket ne dovoljuje MCP
429	Presežena omejitev hitrosti (5 zahtev/s, sunek do 20)

Primeri uporabe

Vsi primeri uporabljajo cURL s protokolom MCP JSON-RPC. Zamenjaj YOUR_TOKEN s svojim povezovalnim ž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 recurring event with reminders and attendees
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":12,"method":"tools/call",
       "params":{"name":"create_event","arguments":{"title":"Team standup","start_at":"2026-04-12T10:00:00Z","reminder_minutes":"15","attendees":"Katie,John","recurrence_rule":"FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR","tags":"meeting"}}}'

# Complete a task
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":13,"method":"tools/call",
       "params":{"name":"complete_task","arguments":{"task_id":"<task-uuid>"}}}'

Uspešen odziv izgleda takole:

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

opomba

Orodja za pisanje in posodabljanje vrnejo minimalne odzive samo z id, title in status. Za celotne podrobnosti (oznake, prioriteta, rok itd.) po pisanju izvedi nadaljnji klic za branje, kot je get_tasks ali get_note.

Upravljanje žetona

Dejanje	Kako
Poglej žeton	iPhone Nastavitve → Integracije → Agenti AI (ali splet Nastavitve → Agenti AI), tapni ikono očesa
Kopiraj žeton	Tapni ikono za kopiranje poleg žetona
Ponovno ustvari	Tapni Ponovno ustvari in potrdi. Stari žeton takoj preneha delovati in vse dejavne seje se prekinejo
Spremeni način	Samo Ultra - preklopi med samo za branje in branje + pisanje. Na Pro je način fiksno nastavljen na branje + pisanje
Onemogoči	Tapni Onemogoči in potrdi. Žeton se izbriše in vse povezave se ustavijo. Pozneje lahko znova omogočiš (izdan bo nov žeton)

Kaj lahko vprašaš svojega agenta AI

Ko je povezan, vprašaj svoje orodje AI stvari, kot so:

Preglej svoj dan:

• "Na čem sem danes delal?"
• "Pokaži mi moje zapiske iz tega tedna"
• "Katera opravila so zapadla?"

Upravljaj opravila:

• "Ustvari opravilo: preglej četrtletno poročilo, visoka prioriteta, rok petek"
• "Označi opravilo Figma kot opravljeno"
• "Na katerih opravilih delam?"

Išči in analiziraj:

• "Najdi vse zapiske o marketinški strategiji"
• "Katere dogodke imam naslednji teden?"
• "Povzemi moja dnevna poročila iz prejšnjega tedna"

Načrtuj vnaprej:

• "Ustvari dogodek: sestanek ekipe jutri ob 10.00"
• "Kaj imam ta teden v koledarju?"
• "Pokaži mi moje najboljše oznake - na kaj porabim največ časa?"

Agent AI ima poln dostop do tvojih zapiskov, opravil, dogodkov in poročil. Bere, ustvarja, posodablja in briše podatke ter odgovarja na zapletena vprašanja z združevanjem informacij iz več orodij.

Pomembne opombe

• Dva načina ustvarjanja zapiskov - create_note takoj ustvari navaden besedilni zapisek (brez analize AI). process_note izvede celoten potek AI (enako kot snemanje v aplikaciji) - analizira besedilo, izlušči opravila in dogodke, ustvari oznake in vdelave. Uporabi process_note, ko želiš, da TellDone razmišlja namesto tebe.
• Brez sinhronizacije integracij - elementi, ustvarjeni ali posodobljeni prek MCP, ne sprožijo avtomatizacij z webhooki ali sinhronizacij integracij (Todoist, Notion). V tvojih aplikacijah se bodo pojavili ob naslednji sinhronizaciji.
• Pomensko iskanje je odvisno od orodja - zapiski, ustvarjeni z process_note, dobijo vdelave in se pojavijo v pomenskem iskanju. Zapiski, ustvarjeni z create_note, ne dobijo vdelav, zato se pojavijo samo v iskanju besedila.
• Odzivi na pisanje so minimalni - orodja za ustvarjanje in posodabljanje vrnejo samo id, title in status. Za vsa polja po pisanju izvedi nadaljnji klic za branje.
• Filtri datuma uporabljajo UTC - parametra date_from/date_to se primerjata kot časovni žigi UTC. Za uporabnike v časovnih pasovih zunaj UTC lahko mejni datumi vključijo ali izključijo elemente iz sosednjih dni.
• Omejitev hitrosti - 5 zahtev na sekundo, s sunki do 20. Za množične operacije uravnaj tempo svojih zahtev.

Varnost

• Vsak uporabnik dobi enolični 384-bitni povezovalni žeton
• Tvoj žeton je takoj preklican, ko onemogočiš MCP ali ga ponovno ustvariš
• Vsi podatki so strogo izolirani na tvoj račun - tvoj agent lahko dostopa samo do tvojih podatkov
• Vsaka zahteva je obsežena na tvojega uporabnika - ni načina, da bi agent dostopal do podatkov drugega uporabnika
• Povezava uporablja HTTPS z omejevanjem hitrosti (5 zahtev/s, sunek do 20)
• Povezave OAuth uporabljajo PKCE z enkratnimi avtorizacijskimi kodami in kratkoživimi dostopnimi žetoni - povezavo lahko kadar koli prekličeš iz aplikacije

Za tehnično poglobitev - končne točke za odkrivanje, življenjske dobe žetonov, celoten potek OAuth - glej naš odprtokodni sklic povezovalnika na github.com/exp78/telldone-mcp ali neposredno poizvedi https://api.telldone.app/.well-known/oauth-protected-resource.

Zasebnost in pretok podatkov

Tvoji podatki se posredujejo povezanemu orodju AI samo, ko ga izrecno prosiš, naj nekaj naredi - na primer, ko ga prosiš, naj prebere ali spremeni tvoje zapiske. Orodje prejme samo odzive na določene klice, ki jih izvede, obsežene na dovoljenja, ki si jih odobril. Ti imaš nadzor: spremeni način branja/pisanja svojega paketa, zoži obsege OAuth, ki jih odobriš ob prijavi, ali ponovno ustvari in onemogoči svoj žeton bearer, vse iz Nastavitev. Za vse podrobnosti glej Pravilnik o zasebnosti ali se z vprašanji obrni na support@telldone.app.

Odpravljanje težav

Simptom	Vzrok / popravek
Stran za privolitev OAuth pravi "Wrong email or password"	Uporabi e-poštni naslov in geslo svojega računa TellDone (tista, s katerima se prijaviš v aplikacijo). Če ima tvoj račun samo prijavo z Apple ali Google in nima gesla, namesto tega uporabi metodo z žetonom bearer.
Povezan, a AI ne more ničesar ustvariti ali urediti	Tvoj paket ali način je samo za branje ali pa povezavi niso bili dodeljeni obsegi pisanja - znova se poveži in jih odobri ali preveri svoj način v Nastavitvah.
Napaka "Insufficient scope" iz orodja	Povezavi OAuth ta obseg ni bil dodeljen. Znova se poveži in odobri dovoljenje, ki ga orodje potrebuje.
Orodja se sploh ne pojavijo	MCP na tvojem računu ni omogočen (Nastavitve → Agenti AI) ali pa tvoj paket ne vključuje MCP.
Moj odjemalec mi dovoli izbiro le s seznama povezovalnikov, TellDone pa ga ni	TellDone še ni v imeniku povezovalnikov nobenega odjemalca - dodaj ga kot povezovalnik po meri z URL-jem MCP ali uporabi metodo z žetonom bearer.

Glej tudi

• Avtomatizacije z webhooki - samodejno pošlji podatke zunanjim storitvam
• Todoist - namenska dvosmerna sinhronizacija opravil
• Notion - namenska integracija Notion