MCP Access (AI agents)

Τι άλλαξε πρόσφατα

Το MCP είναι τώρα πλήρως διαθέσιμο σε iPhone (επιπλέον της web εφαρμογής). Η οθόνη iPhone αντικατοπτρίζει τη web και περιλαμβάνει τα ίδια setup snippets για όλους τους υποστηριζόμενους AI clients.

Πλάνο Pro και πάνω

Το MCP Access απαιτεί πλάνο Pro ή Ultra. Και τα δύο πλάνα παίρνουν πλήρη πρόσβαση read + write (27 εργαλεία) και μπορούν να μεταβούν σε read-only mode αν το προτιμάς.

Το MCP (Model Context Protocol) σου επιτρέπει να συνδέσεις AI coding assistants και εργαλεία αυτοματισμού απευθείας στα δεδομένα TellDone σου. Μόλις συνδεθούν, ο AI agent σου μπορεί να διαβάσει σημειώσεις, εργασίες, εκδηλώσεις, αναφορές, ετικέτες και ιστορικό αλλαγών - και να δημιουργήσει, να ενημερώσει, να διαγράψει και να επαναφέρει στοιχεία. Υπάρχουν 27 εργαλεία συνολικά: 10 για ανάγνωση δεδομένων και 17 για εγγραφή.

Διαθέσιμο και στην εφαρμογή iPhone (Ρυθμίσεις -> Ενσωματώσεις -> AI Agents) και στη web εφαρμογή (Ρυθμίσεις -> AI Agents).

Δύο τρόποι σύνδεσης

Υπάρχουν δύο τρόποι να πιστοποιήσεις έναν AI client, και υποστηρίζονται πλήρως και οι δύο:

OAuth 2.1 (προτεινόμενο) - η τυπική ροή συγκατάθεσης "Sign in with TellDone". Αυτό χρησιμοποιούν το connector UI του Claude Desktop και το Claude.ai. Δεν αντιγράφεις tokens - συνδέεσαι με τον λογαριασμό TellDone σου και εγκρίνεις τις άδειες που ζητάει ο client.
Bearer token - αντιγράφεις το προσωπικό access token σου από τις Ρυθμίσεις και το επικολλάς στη διαμόρφωση του client σου. Ο απλούστερος τρόπος για scripts, CLIs και clients χωρίς ενσωματωμένη ροή OAuth.

Client	Προτεινόμενο
Claude Desktop / Cowork	OAuth - πρόσθεσε custom connector με το MCP URL και μετά συνδέσου
Claude Code (CLI)	Οποιοδήποτε από τα δύο - το `claude mcp add` σε καθοδηγεί στο OAuth μέσα από τον browser, ή πρόσθεσε μια κεφαλίδα `Bearer` για τη μέθοδο με token
Scripts ή δικός σου κώδικας	Bearer token - ο απλούστερος για αυτοματοποίηση
Client που επιτρέπει μόνο επιλογή από κατάλογο έτοιμων connectors	Χρησιμοποίησε προς το παρόν το bearer token ή τη γέφυρα `mcp-remote` - το TellDone δεν βρίσκεται ακόμη σε κανέναν κατάλογο connectors

Απαιτήσεις πλάνου

Πλάνο	MCP
Free	Κλειδωμένο
Basic	Κλειδωμένο
Pro	Read + Write (27 εργαλεία) - μπορεί να μεταβεί σε Read-only mode
Ultra	Read + Write (27 εργαλεία) - μπορεί να μεταβεί σε Read-only mode

Η οθόνη εντός εφαρμογής

Η οθόνη AI Agents έχει τρεις καταστάσεις ανάλογα με το πλάνο σου και αν το MCP είναι ενεργοποιημένο.

Κλειδωμένο (Free και Basic)

Αν είσαι σε πλάνο Free ή Basic, η οθόνη εξηγεί τι κάνει το MCP και δείχνει ένα κουμπί Upgrade. Πατώντας το ανοίγει το paywall όπου μπορείς να μεταβείς σε Pro ή Ultra.

Απενεργοποιημένο (Pro και Ultra, λειτουργία off)

Αν είσαι σε Pro ή Ultra αλλά δεν έχεις ενεργοποιήσει το MCP ακόμη, η οθόνη δείχνει μια σύντομη περίληψη του τι μπορεί να κάνει το πλάνο σου (αριθμός εργαλείων, mode πρόσβασης, όρια) και ένα κουμπί Enable. Πάτησέ το για να παράγει το token σύνδεσής σου και να ξεκινήσει η ενσωμάτωση.

Ενεργοποιημένο

Μόλις ενεργοποιηθεί, η οθόνη δείχνει όλα όσα χρειάζεσαι για να συνδέσεις έναν AI client:

Διακόπτης mode - σε Ultra μπορείς να εναλλάσσεις ανάμεσα σε Read-only και Read + Write. Σε Pro το mode είναι σταθερό σε Read + Write.
Γραμμή Access Token με διακόπτη ματιού για αποκάλυψη ή απόκρυψη του token και κουμπί αντιγραφής.
Setup picker με καρτέλες για Claude Code, Cursor, Windsurf και Other. Το αντίστοιχο code snippet εμφανίζεται κάτω από τις καρτέλες - απλώς αντιγράφεις και επικολλάς στον AI client σου.
Κουμπί Regenerate - εναλλάσσει το token αμέσως και αποσυνδέει τυχόν ενεργές συνεδρίες που χρησιμοποιούν το παλιό.
Κουμπί Disable - απενεργοποιεί το MCP και διαγράφει το token. Μπορείς να το ξαναενεργοποιήσεις αργότερα, αλλά θα εκδοθεί νέο token.

συμβουλή

Κράτα το token σύνδεσής σου ιδιωτικό. Όποιος έχει το token μπορεί να αποκτήσει πρόσβαση στα δεδομένα TellDone σου. Χρησιμοποίησε Regenerate αν υποψιάζεσαι ποτέ ότι το token διέρρευσε.

Πώς να ενεργοποιήσεις

Μπορείς να διαμορφώσεις το MCP από οποιαδήποτε πλατφόρμα:

iPhone: Ρυθμίσεις -> Ενσωματώσεις -> AI Agents (MCP)
Web: app.telldone.app -> Ρυθμίσεις -> AI Agents

Βήματα:

Πάτα Enable.
Διάλεξε mode πρόσβασης (μόνο Ultra - το Pro είναι πάντα Read + Write).
Αποκάλυψε και αντίγραψε το token σου χρησιμοποιώντας τα εικονίδια ματιού και αντιγραφής.
Διάλεξε το εργαλείο σου στην ενότητα Setup (Claude Code, Cursor, Windsurf ή Other).
Επικόλλησε το snippet στη διαμόρφωση του AI client σου.

Σύνδεση με OAuth

Το OAuth είναι ο προτεινόμενος δρόμος για Claude Desktop, Claude.ai, Cowork και Claude Code - συνδέεσαι με τον λογαριασμό TellDone σου αντί να μεταφέρεις ένα token από εδώ κι από εκεί.

MCP URL για OAuth: https://api.telldone.app/mcp/user (χωρίς /mcp στο τέλος - αυτό είναι άλλο URL, που χρησιμοποιείται μόνο για τη μέθοδο με bearer token παρακάτω)

Claude Desktop / Cowork

Στον client, διάλεξε Add custom connector.
Βάλε το URL του server: https://api.telldone.app/mcp/user
Ο client ανοίγει τη σελίδα συγκατάθεσης του TellDone στον browser σου. Θα δεις ποια εφαρμογή ζητάει πρόσβαση, τις ακριβείς άδειες που θέλει και μια φόρμα σύνδεσης.
Συνδέσου με το email και τον κωδικό του λογαριασμού TellDone σου και μετά πάτα Allow.
Ο client παίρνει αυτόματα ένα access token και συνδέεται - δεν χρειάζεται να αντιγράψεις κανένα token.

σημείωση

Η σύνδεση στη σελίδα συγκατάθεσης γίνεται με το email και τον κωδικό του λογαριασμού TellDone σου. Αν ο λογαριασμός σου έχει μόνο Apple ή Google Sign In (χωρίς ορισμένο κωδικό), χρησιμοποίησε προς το παρόν τη μέθοδο με bearer token παρακάτω.

Claude Code

OAuth (ανοίγει σύνδεση μέσα από τον browser):

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

Το Claude Code εντοπίζει αυτόματα τη ροή OAuth, αλλά δεν σε συνδέει με την πρώτη κλήση - τρέξε /mcp μέσα στο Claude Code και διάλεξε Authenticate για να ανοίξει η σύνδεση στον browser. Μετά από αυτό ανανεώνει μόνο του το access token σου - δεν χρειάζεται καμία συντήρηση.

Bearer token (χωρίς browser, βολικό για headless setups):

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

Πάρε το YOUR_TOKEN σου από την εφαρμογή: Ρυθμίσεις -> Ενσωματώσεις -> AI Agents -> Copy token (δες Πώς να ενεργοποιήσεις παραπάνω).

Σύνδεση με bearer token

Για clients χωρίς ενσωματωμένη υποστήριξη OAuth - Cursor, Windsurf και άλλους - επικόλλησε το προσωπικό access token σου απευθείας στη διαμόρφωση του client. Αντικατέστησε το YOUR_TOKEN με το token από τις ρυθμίσεις σου σε όλα τα παρακάτω παραδείγματα.

Cursor

Πρόσθεσε στο .cursor/mcp.json:

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

Windsurf

Πρόσθεσε στο .codeium/windsurf/mcp_config.json:

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

Other

Χρησιμοποίησε αυτά τα snippets για clients που ο εντός εφαρμογής picker ομαδοποιεί κάτω από Other.

Codex

Πρόσθεσε στο 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

Άλλοι MCP clients

Οποιοδήποτε εργαλείο υποστηρίζει MCP πάνω από HTTP μπορεί να συνδεθεί. Χρησιμοποίησε το endpoint https://api.telldone.app/mcp/user/mcp με μια κεφαλίδα authorization Bearer YOUR_TOKEN.

Εναλλακτική κεφαλίδα auth

Αν ο client ή proxy σου κρατάει την κεφαλίδα Authorization (για παράδειγμα, μερικά Smithery-style gateways), στείλε το token στο X-MCP-Token: YOUR_TOKEN αντί γι' αυτό. Και οι δύο κεφαλίδες δουλεύουν· αν είναι παρούσες και οι δύο, νικάει το Authorization.

Δοκιμή της σύνδεσής σου

Μπορείς να επαληθεύσεις ότι το token σου δουλεύει με μια απλή εντολή 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}'

Μια επιτυχημένη απάντηση παραθέτει όλα τα διαθέσιμα εργαλεία.

Άδειες (scopes)

Οι συνδέσεις OAuth είναι scoped - κατά τη σύνδεση βλέπεις ακριβώς τι ζητάει ο client και το εγκρίνεις ρητά.

Scope	Επιτρέπει στην εφαρμογή να...
`notes:read`	Διαβάζει τις σημειώσεις σου, να κάνει αναζήτηση, να ανοίγει πλήρεις λεπτομέρειες σημείωσης
`notes:write`	Δημιουργεί, επεξεργάζεται και διαγράφει σημειώσεις (και να τρέχει τη διαδικασία επεξεργασίας φωνητικών σημειώσεων)
`tasks:read` / `tasks:write`	Διαβάζει / δημιουργεί, επεξεργάζεται, ολοκληρώνει και διαγράφει εργασίες
`events:read` / `events:write`	Διαβάζει / δημιουργεί, επεξεργάζεται και διαγράφει εκδηλώσεις
`reports:read`	Διαβάζει τις ημερήσιες, εβδομαδιαίες, μηνιαίες και ετήσιες αναφορές σου
`tags:read` / `tags:write`	Παραθέτει τις ετικέτες σου / δημιουργεί και μετονομάζει ετικέτες
`profile:read`	Διαβάζει το προφίλ και τις πληροφορίες συνδρομής σου
`offline_access`	Παραμένει συνδεδεμένη όσο λείπεις (εκδίδει refresh token ώστε να μη χρειάζεται να συνδέεσαι σε κάθε συνεδρία)

Τα scopes είναι ανώτατο όριο, όχι εγγύηση - μια σύνδεση που έχει μόνο notes:read δεν μπορεί να καλέσει εργαλείο εγγραφής, ό,τι κι αν της ζητήσεις. Το πλάνο σου είναι ένα δεύτερο φίλτρο πάνω από τα scopes.

Οι συνδέσεις με bearer token δεν έχουν ξεχωριστά scopes - διέπονται μόνο από το read/write mode του πλάνου σου.

Τι μπορείς να κάνεις

Read tools (10) - Pro και Ultra

Εργαλείο	Τι κάνει
get_notes	Παράθεση σημειώσεων με φίλτρα (ετικέτες, εύρος ημερομηνιών, αναζήτηση κειμένου)
get_note	Δες μια μεμονωμένη σημείωση με τις θυγατρικές της εργασίες, εκδηλώσεις και πλήρη μεταγραφή
get_notes_full	Πάρε πολλαπλές σημειώσεις με ενσωματωμένες εργασίες και εκδηλώσεις σε μία κλήση
get_tasks	Παράθεση εργασιών φιλτραρισμένων ανά κατάσταση (to-do, done, all), ετικέτες ή ημερομηνίες
get_events	Παράθεση εκδηλώσεων ημερολογίου, φιλτράρισμα ανά εύρος ημερομηνιών
get_reports	Διάβασε τις ημερήσιες, εβδομαδιαίες, μηνιαίες και ετήσιες αναφορές σου (πλήρες markdown)
get_tags	Δες όλες τις ετικέτες σου ταξινομημένες κατά χρήση
get_profile	Δες τις πληροφορίες λογαριασμού και τα στατιστικά χρήσης σου
search	Αναζήτησε σε σημειώσεις, εργασίες και εκδηλώσεις (text + semantic search για σημειώσεις)
get_change_log	Δες το ιστορικό επεξεργασιών μιας σημείωσης, εργασίας ή εκδήλωσης, και αν κάθε επεξεργασία έχει αναιρεθεί

συμβουλή

Το εργαλείο search υποστηρίζει semantic search για σημειώσεις - βρίσκει αποτελέσματα με βάση το νόημα, όχι μόνο λέξεις-κλειδιά. Για παράδειγμα, αναζητώντας "meetings about budget" θα βρει σημειώσεις για οικονομικές συζητήσεις ακόμη και αν δεν περιέχουν τη λέξη "budget".

Write tools (17) - Pro και Ultra

Εργαλείο	Τι κάνει
process_note	Πλήρης διαδικασία επεξεργασίας AI - στείλε κείμενο ή ήχο, πάρε πίσω μια σημείωση με εργασίες, εκδηλώσεις και ετικέτες
create_note	Πρόσθεσε μια απλή σημείωση κειμένου (χωρίς ανάλυση AI)
create_task	Πρόσθεσε μια εργασία με προτεραιότητα, προθεσμία, υπενθύμιση και ετικέτες
create_event	Πρόσθεσε μια εκδήλωση ημερολογίου με ημερομηνία, ώρα, τοποθεσία, υπενθυμίσεις, συμμετέχοντες και επανάληψη
update_note	Άλλαξε τίτλο σημείωσης, περίληψη, τύπο, ετικέτες, προτεραιότητα ή κατάσταση
update_task	Άλλαξε τίτλο εργασίας, περιγραφή, προτεραιότητα, προθεσμία, υπενθύμιση, ετικέτες ή κατάσταση
complete_task	Σημείωσε μια εργασία ως ολοκληρωμένη
update_event	Άλλαξε λεπτομέρειες εκδήλωσης, ώρα, τοποθεσία, υπενθυμίσεις, συμμετέχοντες, επανάληψη, ετικέτες ή κατάσταση
delete_note	Διάγραψε μια σημείωση και όλες τις συνδεδεμένες εργασίες και εκδηλώσεις της
delete_task	Διάγραψε μια εργασία
delete_event	Διάγραψε μια εκδήλωση
undo_change_log_entry	Αναίρεσε μια μεμονωμένη καταγεγραμμένη επεξεργασία - από το AI ή δική σου - επαναφέροντας την προηγούμενη τιμή του πεδίου
restore_entity	Επανάφερε μια διαγραμμένη ή αρχειοθετημένη σημείωση, εργασία ή εκδήλωση
create_tag	Δημιούργησε μια νέα ετικέτα, ή μετέτρεψε μια αυτόματα προτεινόμενη ετικέτα σε μόνιμη
set_tag_pinned	Καρφίτσωσε ή ξεκαρφίτσωσε μια ετικέτα ώστε να ταξινομείται στην κορυφή
delete_tag	Αφαίρεσε μια ετικέτα (μπορεί να επαναφερθεί με restore_tag)
restore_tag	Επανάφερε μια διαγραμμένη ετικέτα

Όλες οι λειτουργίες εγγραφής και διαγραφής εμφανίζονται αμέσως στις συνδεδεμένες συσκευές σου (τηλέφωνο, web app) μέσω συγχρονισμού πραγματικού χρόνου.

Αναφορά εργαλείων

get_notes

Παράθεση σημειώσεων με προαιρετικό φιλτράρισμα. Τα φίλτρα ημερομηνίας χρησιμοποιούν recorded_at (πότε έκανες εγγραφή της ηχητικής σημείωσης), όχι created_at.

Παράμετρος	Τύπος	Default	Περιγραφή
`limit`	int	20	Αριθμός σημειώσεων προς επιστροφή (max 50)
`offset`	int	0	Παράλειψε τόσες σημειώσεις (για pagination, max 10000)
`tags`	string	-	Φιλτράρισμα ανά ετικέτες, διαχωρισμένες με κόμμα (ταιριάζει σε οποιαδήποτε)
`search`	string	-	Αναζήτηση κειμένου σε τίτλο και περίληψη
`date_from`	string	-	Ημερομηνία έναρξης, YYYY-MM-DD (συμπεριλαμβανομένης)
`date_to`	string	-	Ημερομηνία λήξης, YYYY-MM-DD (αποκλειστική)
`standalone_only`	bool	false	Όταν είναι true, κρύβει τις σημειώσεις follow-up (σημειώσεις συνδεδεμένες με γονική σημείωση/εργασία/εκδήλωση) και επιστρέφει μόνο ανεξάρτητες σημειώσεις

Επιστρέφει: λίστα σημειώσεων με id, title, summary, type, tags, priority, status, recorded_at, created_at.

get_note

Πάρε μια μεμονωμένη σημείωση με την πλήρη μεταγραφή της και όλες τις συνδεδεμένες εργασίες και εκδηλώσεις.

Παράμετρος	Τύπος	Περιγραφή
`note_id`	string	Το UUID της σημείωσης

Επιστρέφει: σημείωση με title, summary, transcript, type, tags, priority, status, metadata, created_at, συν tasks[] και events[] arrays.

Επιστρέφει επίσης transcript_speakers (σειρές μεταγραφής με ετικέτα ομιλητή, για συναντήσεις με πολλούς ομιλητές - διαφορετικά null), speaker_count (null εκτός αν η εγγραφή διαχωρίστηκε ανά ομιλητή), και parent_note_id/parent_task_id/parent_event_id (ορίζονται όταν αυτή η σημείωση είναι follow-up επεξεργασία άλλου στοιχείου). Κάθε καταχώριση tasks[]/events[] περιλαμβάνει επίσης reminders_at/recurrence_rule (εργασίες) ή reminder_minutes/attendees/recurrence_rule (εκδηλώσεις).

get_notes_full

Πάρε πολλαπλές σημειώσεις με τις εργασίες και εκδηλώσεις τους σε μία κλήση. Ίδια φίλτρα με get_notes, αλλά κάθε σημείωση περιλαμβάνει ενσωματωμένα tasks[] και events[].

Παράμετρος	Τύπος	Default	Περιγραφή
`limit`	int	10	Αριθμός σημειώσεων (max 20)
`offset`	int	0	Παράλειψε τόσες σημειώσεις
`tags`	string	-	Φιλτράρισμα ανά ετικέτες
`date_from`	string	-	Ημερομηνία έναρξης, YYYY-MM-DD
`date_to`	string	-	Ημερομηνία λήξης, YYYY-MM-DD
`standalone_only`	bool	false	Όταν είναι true, κρύβει τις σημειώσεις follow-up (σημειώσεις συνδεδεμένες με γονική σημείωση/εργασία/εκδήλωση) και επιστρέφει μόνο ανεξάρτητες σημειώσεις

get_tasks

Παράθεση εργασιών με φιλτράρισμα.

Παράμετρος	Τύπος	Default	Περιγραφή
`status`	string	"todo"	Φίλτρο: `todo`, `done` ή `all`
`limit`	int	30	Αριθμός εργασιών (max 100)
`offset`	int	0	Παράλειψε τόσες εργασίες
`tags`	string	-	Φιλτράρισμα ανά ετικέτες, διαχωρισμένες με κόμμα
`date_from`	string	-	Ημερομηνία έναρξης, YYYY-MM-DD (φιλτράρισμα κατά προθεσμία· εργασίες χωρίς προθεσμία εξαιρούνται)
`date_to`	string	-	Ημερομηνία λήξης, YYYY-MM-DD (φιλτράρισμα κατά προθεσμία· εργασίες χωρίς προθεσμία εξαιρούνται)

Επιστρέφει: λίστα εργασιών με id, title, description, status, priority, tags, deadline, reminder_at, reminders_at, completed_at, completed_by, source, created_at. Το reminder_at αντικατοπτρίζει την πρώτη καταχώριση του reminders_at για συμβατότητα προς τα πίσω - χρησιμοποίησε το reminders_at για να δεις όλες τις υπενθυμίσεις μιας εργασίας.

get_events

Παράθεση εκδηλώσεων ημερολογίου με φιλτράρισμα εύρους ημερομηνιών.

Παράμετρος	Τύπος	Default	Περιγραφή
`limit`	int	30	Αριθμός εκδηλώσεων (max 100)
`offset`	int	0	Παράλειψε τόσες εκδηλώσεις
`date_from`	string	-	Ημερομηνία έναρξης, YYYY-MM-DD (φιλτράρει ανά ώρα έναρξης εκδήλωσης)
`date_to`	string	-	Ημερομηνία λήξης, YYYY-MM-DD

Επιστρέφει: λίστα εκδηλώσεων με id, title, description, status, start_at, end_at, location, is_all_day, tags, note_id, reminder_minutes, attendees, recurrence_rule, created_at.

get_reports

Πάρε τις παραγμένες από AI αναφορές σου με πλήρες περιεχόμενο markdown.

Παράμετρος	Τύπος	Default	Περιγραφή
`report_type`	string	"daily"	Τύπος: `daily`, `weekly`, `monthly` ή `yearly`
`limit`	int	5	Αριθμός αναφορών (max 10)

Επιστρέφει: λίστα αναφορών με id, type, period_start, period_end, content_md, created_at.

σημείωση

Οι μηνιαίες αναφορές μπορεί να είναι 3.000-5.000 λέξεις. Χρησιμοποίησε limit=1 αν το AI εργαλείο σου έχει στενό context window.

get_tags

Πάρε όλες τις ετικέτες σου, ταξινομημένες με τις pinned πρώτες, μετά κατά αριθμό χρήσης.

Χωρίς παραμέτρους. Επιστρέφει έως 100 ετικέτες, καθεμία με tag, usage_count, is_pinned, is_manual.

get_profile

Πάρε τις πληροφορίες λογαριασμού και τα στατιστικά χρήσης σου.

Χωρίς παραμέτρους. Επιστρέφει email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at και stats (αριθμοί σημειώσεων/εργασιών/εκδηλώσεων).

search

Αναζήτηση σε σημειώσεις, εργασίες και εκδηλώσεις ταυτόχρονα. Για σημειώσεις, υποστηρίζει και αναζήτηση κειμένου και semantic search (βρίσκει αποτελέσματα με βάση το νόημα χρησιμοποιώντας AI embeddings).

Παράμετρος	Τύπος	Default	Περιγραφή
`query`	string	required	Κείμενο αναζήτησης (max 500 χαρακτήρες)
`limit`	int	20	Max αποτελέσματα ανά τύπο (max 20)
`semantic`	bool	true	Ενεργοποίηση semantic search για σημειώσεις

Επιστρέφει αποτελέσματα ομαδοποιημένα κατά τύπο: notes[], tasks[], events[]. Κάθε αποτέλεσμα έχει id, type, title, detail, created_at.

Όρισε semantic=false για πιο γρήγορη αναζήτηση μόνο κειμένου.

get_change_log

Δες το ιστορικό επεξεργασιών μιας σημείωσης, εργασίας ή εκδήλωσης - κάθε follow-up επεξεργασία από το AI και κάθε χειροκίνητη επεξεργασία που έκανες εσύ, με τις πιο πρόσφατες πρώτα.

Παράμετρος	Τύπος	Default	Περιγραφή
`entity`	string	required	`notes`, `tasks` ή `events`
`entity_id`	string	required	Το UUID του στοιχείου
`include_manual`	bool	false	Συμπερίληψε και τις δικές σου χειροκίνητες επεξεργασίες, όχι μόνο αυτές από το AI

Επιστρέφει: λίστα καταχωρίσεων αλλαγών με id (χρησιμοποίησέ το ως entry_id για αναίρεση), field_name, old_value, new_value, source (follow_up, smart_context ή manual), origin_note_id, edited_at και reverted_at (ορίζεται μόλις αναιρεθεί).

process_note (Pro και Ultra)

Πλήρης διαδικασία επεξεργασίας AI - δουλεύει το ίδιο όπως η εγγραφή στην εφαρμογή. Στείλε κείμενο ή ήχο και το TellDone θα μεταγράψει, θα αναλύσει με AI και θα δημιουργήσει μια δομημένη σημείωση με εξαγμένες εργασίες, εκδηλώσεις, ετικέτες και embeddings.

Αυτό το εργαλείο είναι ασύγχρονο: επιστρέφει αμέσως με ένα audio_id και επεξεργάζεται στο παρασκήνιο. Τα αποτελέσματα φτάνουν μέσω συγχρονισμού πραγματικού χρόνου στις συνδεδεμένες συσκευές σου, ή μπορείς να ρωτάς με get_notes().

Παράμετρος	Τύπος	Περιγραφή
`text`	string	Κείμενο προς ανάλυση (παραλείπει τη μεταγραφή αν δεν παρέχεται ήχος)
`audio_base64`	string	Base64-encoded αρχείο ήχου (έως 50MB, ενεργοποιεί μεταγραφή)
`audio_format`	string	`m4a`, `ogg`, `wav`, `mp3`, `aac` ή `webm` (default: m4a)
`parent_task_id`	string	UUID μιας εργασίας στην οποία αυτό είναι follow-up
`parent_note_id`	string	UUID μιας σημείωσης στην οποία αυτό είναι follow-up
`parent_event_id`	string	UUID μιας εκδήλωσης στην οποία αυτό είναι follow-up

Πρέπει να παρέχεις είτε text είτε audio_base64 (ή και τα δύο - ο ήχος έχει προτεραιότητα για μεταγραφή).

Επιστρέφει: {"audio_id": "...", "status": "processing", "mode": "text-only"} ή "mode": "audio+stt" αν παρασχέθηκε ήχος.

σημείωση

Το process_note υπόκειται στα όρια του πλάνου σου (uploads ανά μέρα, σημειώσεις ανά μήνα, μέγιστο μήκος κειμένου). Χρησιμοποίησε get_profile για να ελέγξεις την τρέχουσα χρήση σου.

create_note (Pro και Ultra)

Δημιούργησε μια απλή σημείωση κειμένου αμέσως. Δεν ενεργοποιεί ανάλυση AI - δεν εξάγονται εργασίες ή εκδηλώσεις. Για πλήρη ανάλυση AI με εξαγωγή εργασιών/εκδηλώσεων, χρησιμοποίησε process_note αντί γι' αυτό.

Παράμετρος	Τύπος	Όριο	Περιγραφή
`title`	string	200 χαρακτήρες	Required
`summary`	string	1000 χαρακτήρες	Προαιρετικό. Σύντομο teaser (1-3 προτάσεις). Περιλαμβάνεται στα prompts αναφορών, οπότε κράτα το σύντομο
`transcript`	string	βάσει πλάνου	Προαιρετικό. Long-form σώμα που εμφανίζεται στη λεπτομέρεια σημείωσης. Δεν περιλαμβάνεται σε αναφορές. Όρια: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000 χαρακτήρες
`type`	string	-	Προαιρετικό. `task`, `idea`, `info` (default), `status`, `meeting`, `event` ή `reflection`
`tags`	string	20 tags	Διαχωρισμένα με κόμμα, προαιρετικά

create_task (Pro και Ultra)

Δημιούργησε μια νέα εργασία.

Παράμετρος	Τύπος	Όριο	Περιγραφή
`title`	string	200 χαρακτήρες	Required
`description`	string	2000 χαρακτήρες	Προαιρετικό
`priority`	string	-	`low`, `medium` (default) ή `high`
`deadline`	string	-	YYYY-MM-DD, προαιρετικό
`reminder_at`	string	-	ISO 8601 datetime (π.χ. `2026-04-15T09:00:00Z`), προαιρετικό
`tags`	string	20 tags	Διαχωρισμένα με κόμμα, προαιρετικά
`note_id`	string	-	UUID για να συνδεθεί η εργασία με μια γονική σημείωση, προαιρετικό

create_event (Pro και Ultra)

Δημιούργησε μια εκδήλωση ημερολογίου.

Παράμετρος	Τύπος	Όριο	Περιγραφή
`title`	string	200 χαρακτήρες	Required
`start_at`	string	-	ISO 8601 datetime, required
`end_at`	string	-	ISO 8601 datetime (default: start + 1 ώρα)
`description`	string	2000 χαρακτήρες	Προαιρετικό
`location`	string	200 χαρακτήρες	Προαιρετικό
`is_all_day`	bool	-	Default: false
`tags`	string	20 tags	Διαχωρισμένα με κόμμα, προαιρετικά
`reminder_minutes`	string	-	Διαχωρισμένα με κόμμα λεπτά πριν την εκδήλωση (π.χ. `15,60`), προαιρετικά
`attendees`	string	-	Διαχωρισμένα με κόμμα ονόματα ή emails, προαιρετικά
`recurrence_rule`	string	-	RRULE string (π.χ. `FREQ=WEEKLY;BYDAY=MO,WE,FR`), προαιρετικό
`note_id`	string	-	UUID για να συνδεθεί η εκδήλωση με γονική σημείωση, προαιρετικό

update_note (Pro και Ultra)

Ενημέρωσε ένα ή περισσότερα πεδία σε μια υπάρχουσα σημείωση. Αλλάζουν μόνο τα πεδία που παρέχεις.

Παράμετρος	Τύπος	Περιγραφή
`note_id`	string	Required, το UUID της σημείωσης
`title`	string	Νέος τίτλος (max 200 χαρακτήρες)
`summary`	string	Νέα περίληψη (max 1000 χαρακτήρες, πέρασε ένα κενό `" "` για καθαρισμό)
`transcript`	string	Νέα μεταγραφή (όριο βάσει πλάνου, πέρασε ένα κενό `" "` για καθαρισμό)
`type`	string	`task`, `idea`, `info`, `status`, `meeting`, `event` ή `reflection`
`tags`	string	Διαχωρισμένες με κόμμα ετικέτες (αντικαθιστά όλες τις υπάρχουσες, max 20)
`priority`	string	`low`, `medium` ή `high`
`status`	string	`active` ή `archived`

προσοχή

Για σημειώσεις που δημιουργήθηκαν από τη διαδικασία επεξεργασίας φωνής, το transcript είναι η πρωτότυπη έξοδος speech-to-text. Η αντικατάστασή του αντικαθιστά την κανονική πηγή - σκέψου να κάνεις append σε αυτό αν θες να διατηρήσεις το πρωτότυπο.

update_task (Pro και Ultra)

Ενημέρωσε ένα ή περισσότερα πεδία σε μια υπάρχουσα εργασία. Αλλάζουν μόνο τα πεδία που παρέχεις.

Παράμετρος	Τύπος	Περιγραφή
`task_id`	string	Required, το UUID της εργασίας
`title`	string	Νέος τίτλος
`description`	string	Νέα περιγραφή (πέρασε ένα κενό `" "` για καθαρισμό)
`priority`	string	`low`, `medium` ή `high`
`deadline`	string	YYYY-MM-DD (πέρασε ένα κενό για καθαρισμό)
`status`	string	`todo` ή `done`
`tags`	string	Διαχωρισμένες με κόμμα ετικέτες (αντικαθιστά όλες τις υπάρχουσες, max 20)
`reminder_at`	string	ISO 8601 datetime (πέρασε ένα κενό για καθαρισμό)

Ο ορισμός status σε done καταγράφει επίσης πότε και πώς ολοκληρώθηκε η εργασία.

complete_task (Pro και Ultra)

Συντόμευση για να σημειώσεις μια εργασία ως ολοκληρωμένη.

Παράμετρος	Τύπος	Περιγραφή
`task_id`	string	Required, το UUID της εργασίας

Επιστρέφει σφάλμα αν η εργασία δεν υπάρχει ή είναι ήδη ολοκληρωμένη.

update_event (Pro και Ultra)

Ενημέρωσε ένα ή περισσότερα πεδία σε μια υπάρχουσα εκδήλωση. Αλλάζουν μόνο τα πεδία που παρέχεις.

Παράμετρος	Τύπος	Περιγραφή
`event_id`	string	Required, το UUID της εκδήλωσης
`title`	string	Νέος τίτλος
`description`	string	Νέα περιγραφή (πέρασε ένα κενό για καθαρισμό)
`start_at`	string	Νέα ώρα έναρξης (ISO 8601)
`end_at`	string	Νέα ώρα λήξης (ISO 8601)
`location`	string	Νέα τοποθεσία (πέρασε ένα κενό για καθαρισμό)
`status`	string	`confirmed`, `tentative` ή `cancelled`
`tags`	string	Διαχωρισμένες με κόμμα ετικέτες (αντικαθιστά όλες τις υπάρχουσες, max 20)
`is_all_day`	string	`"true"` ή `"false"`
`reminder_minutes`	string	Διαχωρισμένα με κόμμα λεπτά πριν την εκδήλωση (π.χ. `15,60`)
`attendees`	string	Διαχωρισμένα με κόμμα ονόματα ή emails
`recurrence_rule`	string	RRULE string (πέρασε ένα κενό για καθαρισμό)

delete_note (Pro και Ultra)

Διάγραψε μια σημείωση. Αυτό διαγράφει επίσης όλες τις εργασίες και εκδηλώσεις που δημιουργήθηκαν από αυτή τη σημείωση.

Παράμετρος	Τύπος	Περιγραφή
`note_id`	string	Required, το UUID της σημείωσης

delete_task (Pro και Ultra)

Διάγραψε μια εργασία.

Παράμετρος	Τύπος	Περιγραφή
`task_id`	string	Required, το UUID της εργασίας

delete_event (Pro και Ultra)

Διάγραψε μια εκδήλωση.

Παράμετρος	Τύπος	Περιγραφή
`event_id`	string	Required, το UUID της εκδήλωσης

undo_change_log_entry (Pro και Ultra)

Αναίρεσε μια μεμονωμένη καταγεγραμμένη επεξεργασία - επαναφέρει το πεδίο στην τιμή που είχε πριν από εκείνη την επεξεργασία, είτε η επεξεργασία έγινε από το AI (από μια follow-up εγγραφή) είτε από εσένα απευθείας.

Παράμετρος	Τύπος	Περιγραφή
`entity`	string	Required, `notes`, `tasks` ή `events`
`entity_id`	string	Required, το UUID του στοιχείου
`entry_id`	string	Required, το `id` της καταχώρισης αλλαγής από `get_change_log`

Επιστρέφει: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Η αναίρεση της ίδιας καταχώρισης δύο φορές επιστρέφει σφάλμα - έχει ήδη αναιρεθεί.

restore_entity (Pro και Ultra)

Επανάφερε μια διαγραμμένη ή αρχειοθετημένη σημείωση, εργασία ή εκδήλωση.

Παράμετρος	Τύπος	Περιγραφή
`entity`	string	Required, `notes`, `tasks` ή `events`
`entity_id`	string	Required, το UUID του στοιχείου

Επιστρέφει: το επαναφερμένο στοιχείο ως JSON.

create_tag (Pro και Ultra)

Δημιούργησε μια νέα ετικέτα, ή μετέτρεψε μια υπάρχουσα αυτόματα προτεινόμενη ετικέτα σε μόνιμη.

Παράμετρος	Τύπος	Περιγραφή
`tag`	string	Required, 1-50 χαρακτήρες (αποθηκεύεται με πεζά)
`category`	string	Προαιρετικό

set_tag_pinned (Pro και Ultra)

Καρφίτσωσε ή ξεκαρφίτσωσε μια ετικέτα ώστε να ταξινομείται στην κορυφή της λίστας ετικετών σου.

Παράμετρος	Τύπος	Περιγραφή
`tag`	string	Required
`pinned`	bool	Required

Ετικέτες που περιέχουν χαρακτήρα / δεν μπορούν να καρφιτσωθούν.

delete_tag (Pro και Ultra)

Αφαίρεσε μια ετικέτα. Μπορεί να επαναφερθεί με restore_tag.

Παράμετρος	Τύπος	Περιγραφή
`tag`	string	Required

restore_tag (Pro και Ultra)

Επανάφερε μια διαγραμμένη ετικέτα.

Παράμετρος	Τύπος	Περιγραφή
`tag`	string	Required

Όρια εισόδου

Πεδίο	Μέγιστο μήκος	Χρησιμοποιείται σε
title	200 χαρακτήρες	create/update note, task, event
description	2.000 χαρακτήρες	create/update task, event
summary	1.000 χαρακτήρες (hard)	create/update note. Περιλαμβάνεται σε prompts αναφορών, κρατείται σύντομο για έλεγχο κόστους token
transcript	βάσει πλάνου: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000	create/update note. Long-form σώμα, όχι σε αναφορές
location	200 χαρακτήρες	create/update event
tags	20 tags	create/update note, task, event
search query	500 χαρακτήρες	search
audio_base64 (decoded)	50 MB	process_note

Αν υπερβείς ένα όριο, το εργαλείο επιστρέφει μήνυμα σφάλματος όπως "title too long (max 200 chars, got 250)".

Χειρισμός σφαλμάτων

Όλα τα εργαλεία επιστρέφουν JSON. Τα σφάλματα χρησιμοποιούν αυτή τη μορφή:

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

Συνηθισμένα σφάλματα:

Σφάλμα	Πότε
`"MCP access is read-only..."`	Κλήθηκε εργαλείο εγγραφής σε read-only mode
`"Invalid note_id format"`	Πέρασε string που δεν είναι UUID ως ID
`"Note not found"`	Το ID δεν υπάρχει ή ανήκει σε άλλον χρήστη
`"Task not found or already completed"`	`complete_task` σε ανύπαρκτη ή ήδη ολοκληρωμένη εργασία
`"title too long (max 200 chars, got N)"`	Όριο εισόδου ξεπεράστηκε
`"Too many tags (max 20)"`	Παρασχέθηκαν περισσότερα από 20 tags

Σφάλματα HTTP-level:

Code	Σημασία
401	Άκυρο ή λείπει το Bearer token
403	MCP απενεργοποιημένο ή το πλάνο δεν επιτρέπει MCP
429	Όριο ρυθμού ξεπεράστηκε (5 req/s, burst έως 20)

Παραδείγματα χρήσης

Όλα τα παραδείγματα χρησιμοποιούν cURL με το πρωτόκολλο MCP JSON-RPC. Αντικατέστησε YOUR_TOKEN με το token σύνδεσής σου.

Ανάγνωση δεδομένων

# 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}}}'

Εγγραφή δεδομένων (Pro και 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>"}}}'

Μια επιτυχημένη απάντηση μοιάζει έτσι:

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

σημείωση

Τα εργαλεία εγγραφής και ενημέρωσης επιστρέφουν ελάχιστες απαντήσεις με μόνο id, title και status. Για να πάρεις πλήρεις λεπτομέρειες (tags, προτεραιότητα, προθεσμία κλπ.) μετά από εγγραφή, κάνε μια follow-up κλήση ανάγνωσης όπως get_tasks ή get_note.

Διαχείριση token

Ενέργεια	Πώς
Δες το token	iPhone Ρυθμίσεις -> Ενσωματώσεις -> AI Agents (ή web Ρυθμίσεις -> AI Agents), πάτα το εικονίδιο ματιού
Αντίγραψε το token	Πάτα το εικονίδιο αντιγραφής δίπλα στο token
Regenerate	Πάτα Regenerate και επιβεβαίωσε. Το παλιό token σταματά να δουλεύει αμέσως και τυχόν ενεργές συνεδρίες αποσυνδέονται
Άλλαξε mode	Μόνο Ultra - εναλλαγή ανάμεσα σε Read-only και Read + Write. Σε Pro το mode είναι σταθερό σε Read + Write
Disable	Πάτα Disable και επιβεβαίωσε. Το token διαγράφεται και όλες οι συνδέσεις σταματάνε. Μπορείς να το ξαναενεργοποιήσεις αργότερα (θα εκδοθεί νέο token)

Τι μπορείς να ζητήσεις από τον AI agent σου

Μόλις συνδεθεί, ζήτα από το AI εργαλείο σου πράγματα όπως:

Ανασκόπηση της μέρας σου:

"Σε τι δούλεψα σήμερα;"
"Δείξε μου τις σημειώσεις μου από αυτή την εβδομάδα"
"Ποιες εργασίες είναι καθυστερημένες;"

Διαχείριση εργασιών:

"Δημιούργησε μια εργασία: ανασκόπηση τριμηνιαίας αναφοράς, υψηλή προτεραιότητα, προθεσμία Παρασκευή"
"Σημείωσε την εργασία Figma ως ολοκληρωμένη"
"Σε ποιες εργασίες δουλεύω;"

Αναζήτηση και ανάλυση:

"Βρες όλες τις σημειώσεις για τη στρατηγική marketing"
"Ποιες εκδηλώσεις έχω την επόμενη εβδομάδα;"
"Συνόψισε τις ημερήσιες αναφορές μου από την περασμένη εβδομάδα"

Σχεδίασε μπροστά:

"Δημιούργησε εκδήλωση: team standup αύριο στις 10πμ"
"Τι έχω στο ημερολόγιό μου αυτή την εβδομάδα;"
"Δείξε μου τα top tags μου - σε τι ξοδεύω τον περισσότερο χρόνο;"

Ο AI agent έχει πλήρη πρόσβαση στις σημειώσεις, εργασίες, εκδηλώσεις και αναφορές σου. Μπορεί να διαβάσει, να δημιουργήσει, να ενημερώσει και να διαγράψει δεδομένα και να απαντήσει σε σύνθετες ερωτήσεις συνδυάζοντας πληροφορίες από πολλά εργαλεία.

Σημαντικές σημειώσεις

Δύο τρόποι δημιουργίας σημειώσεων - το create_note δημιουργεί μια απλή σημείωση κειμένου αμέσως (χωρίς ανάλυση AI). Το process_note τρέχει την πλήρη διαδικασία επεξεργασίας AI (το ίδιο με την εγγραφή στην εφαρμογή) - αναλύει το κείμενο, εξάγει εργασίες και εκδηλώσεις, παράγει tags και embeddings. Χρησιμοποίησε process_note όταν θέλεις το TellDone να σκεφτεί για σένα.
Καμία ενσωμάτωση συγχρονισμού - στοιχεία που δημιουργούνται ή ενημερώνονται μέσω MCP δεν ενεργοποιούν webhook automations ή συγχρονισμούς ενσωμάτωσης (Todoist, Notion). Θα εμφανιστούν στις εφαρμογές σου στον επόμενο συγχρονισμό.
Το semantic search εξαρτάται από το εργαλείο - σημειώσεις που δημιουργούνται με process_note παίρνουν embeddings και εμφανίζονται σε semantic search. Σημειώσεις που δημιουργούνται με create_note δεν παίρνουν embeddings, οπότε εμφανίζονται μόνο σε αναζήτηση κειμένου.
Οι απαντήσεις εγγραφής είναι ελάχιστες - τα εργαλεία create και update επιστρέφουν μόνο id, title και status. Για να πάρεις όλα τα πεδία μετά από εγγραφή, κάνε μια follow-up κλήση ανάγνωσης.
Τα φίλτρα ημερομηνίας χρησιμοποιούν UTC - οι παράμετροι date_from/date_to συγκρίνονται ως UTC timestamps. Για χρήστες σε non-UTC ζώνες ώρας, οι οριακές ημερομηνίες μπορεί να συμπεριλαμβάνουν ή να αποκλείουν στοιχεία από γειτονικές ημέρες.
Όριο ρυθμού - 5 αιτήματα ανά δευτερόλεπτο, με bursts έως 20. Για bulk λειτουργίες, ρύθμισε τον ρυθμό των αιτημάτων σου.

Ασφάλεια

Κάθε χρήστης παίρνει ένα μοναδικό token σύνδεσης 384-bit
Το token σου ανακαλείται αμέσως όταν απενεργοποιείς το MCP ή το αναγεννάς
Όλα τα δεδομένα είναι αυστηρά απομονωμένα στον λογαριασμό σου - ο agent σου μπορεί να αποκτήσει πρόσβαση μόνο στα δικά σου δεδομένα
Κάθε αίτημα είναι περιορισμένο στον χρήστη σου - δεν υπάρχει τρόπος ένας agent να αποκτήσει πρόσβαση σε δεδομένα άλλου χρήστη
Η σύνδεση χρησιμοποιεί HTTPS με όριο ρυθμού (5 req/s, burst έως 20)
Οι συνδέσεις OAuth χρησιμοποιούν PKCE με authorization codes μίας χρήσης και access tokens μικρής διάρκειας - μπορείς να ανακαλέσεις μια σύνδεση ανά πάσα στιγμή από την εφαρμογή

Για τεχνική εμβάθυνση - discovery endpoints, διάρκεια ζωής token, πλήρης ροή OAuth - δες την ανοιχτού κώδικα αναφορά connector μας στο github.com/exp78/telldone-mcp, ή ρώτησε απευθείας το https://api.telldone.app/.well-known/oauth-protected-resource.

Απόρρητο και ροή δεδομένων

Τα δεδομένα σου μεταδίδονται σε ένα συνδεδεμένο AI εργαλείο μόνο όταν του ζητήσεις ρητά να κάνει κάτι - για παράδειγμα, όταν του ζητάς να διαβάσει ή να τροποποιήσει τις σημειώσεις σου. Το εργαλείο λαμβάνει μόνο τις απαντήσεις στις συγκεκριμένες κλήσεις που κάνει, περιορισμένες στις άδειες που ενέκρινες. Εσύ έχεις τον έλεγχο: άλλαξε το read/write mode του πλάνου σου, περιόρισε τα scopes OAuth που εγκρίνεις κατά τη σύνδεση, ή αναγέννησε και απενεργοποίησε το bearer token σου, όλα από τις Ρυθμίσεις. Δες την Πολιτική Απορρήτου για πλήρεις λεπτομέρειες, ή γράψε στο support@telldone.app για απορίες.

Επίλυση προβλημάτων

Σύμπτωμα	Αιτία / λύση
Η σελίδα συγκατάθεσης OAuth λέει "Wrong email or password"	Χρησιμοποίησε το email και τον κωδικό του λογαριασμού TellDone σου (αυτά με τα οποία μπαίνεις στην εφαρμογή). Αν ο λογαριασμός σου έχει μόνο Apple ή Google Sign In χωρίς κωδικό, χρησιμοποίησε τη μέθοδο με bearer token.
Συνδέθηκε, αλλά το AI δεν μπορεί να δημιουργήσει ή να επεξεργαστεί τίποτα	Το πλάνο ή το mode σου είναι read-only, ή η σύνδεση δεν πήρε scopes εγγραφής - συνδέσου ξανά και ενέκρινέ τα, ή έλεγξε το mode σου στις Ρυθμίσεις.
Σφάλμα "Insufficient scope" από κάποιο εργαλείο	Η σύνδεση OAuth δεν πήρε αυτό το scope. Συνδέσου ξανά και ενέκρινε την άδεια που χρειάζεται το εργαλείο.
Δεν εμφανίζονται καθόλου εργαλεία	Το MCP δεν είναι ενεργοποιημένο στον λογαριασμό σου (Ρυθμίσεις -> AI Agents), ή το πλάνο σου δεν περιλαμβάνει MCP.
Ο client μου με αφήνει να διαλέξω μόνο από μια λίστα connectors, και το TellDone δεν είναι εκεί	Το TellDone δεν βρίσκεται ακόμη στον κατάλογο connectors κανενός client - πρόσθεσέ το ως custom connector με το MCP URL, ή χρησιμοποίησε τη μέθοδο με bearer token.

Δες επίσης

Webhook automations - στείλε δεδομένα σε εξωτερικές υπηρεσίες αυτόματα
Todoist - ειδικός αμφίδρομος συγχρονισμός εργασιών
Notion - ειδική ενσωμάτωση Notion

Δύο τρόποι σύνδεσης​

Απαιτήσεις πλάνου​

Η οθόνη εντός εφαρμογής​

Κλειδωμένο (Free και Basic)​

Απενεργοποιημένο (Pro και Ultra, λειτουργία off)​

Ενεργοποιημένο​

Πώς να ενεργοποιήσεις​

Σύνδεση με OAuth​

Claude Desktop / Cowork​

Claude Code​

Σύνδεση με bearer token​

Cursor​

Windsurf​

Other​

Codex​

OpenClaw​

Άλλοι MCP clients​

Δοκιμή της σύνδεσής σου​

Άδειες (scopes)​

Τι μπορείς να κάνεις​

Read tools (10) - Pro και Ultra​

Write tools (17) - Pro και Ultra​

Αναφορά εργαλείων​

get_notes​

get_note​

get_notes_full​

get_tasks​

get_events​

get_reports​

get_tags​

get_profile​

search​

get_change_log​

process_note (Pro και Ultra)​

create_note (Pro και Ultra)​

create_task (Pro και Ultra)​

create_event (Pro και Ultra)​

update_note (Pro και Ultra)​

update_task (Pro και Ultra)​

complete_task (Pro και Ultra)​

update_event (Pro και Ultra)​

delete_note (Pro και Ultra)​

delete_task (Pro και Ultra)​

delete_event (Pro και Ultra)​

undo_change_log_entry (Pro και Ultra)​

restore_entity (Pro και Ultra)​

create_tag (Pro και Ultra)​

set_tag_pinned (Pro και Ultra)​

delete_tag (Pro και Ultra)​

restore_tag (Pro και Ultra)​

Όρια εισόδου​

Χειρισμός σφαλμάτων​

Παραδείγματα χρήσης​

Ανάγνωση δεδομένων​

Εγγραφή δεδομένων (Pro και Ultra)​

Διαχείριση token​

Τι μπορείς να ζητήσεις από τον AI agent σου​

Σημαντικές σημειώσεις​

Ασφάλεια​

Απόρρητο και ροή δεδομένων​

Επίλυση προβλημάτων​

Δες επίσης​

Δύο τρόποι σύνδεσης

Απαιτήσεις πλάνου

Η οθόνη εντός εφαρμογής

Κλειδωμένο (Free και Basic)

Απενεργοποιημένο (Pro και Ultra, λειτουργία off)

Ενεργοποιημένο

Πώς να ενεργοποιήσεις

Σύνδεση με OAuth

Claude Desktop / Cowork

Claude Code

Σύνδεση με bearer token

Cursor

Windsurf

Other

Codex

OpenClaw

Άλλοι MCP clients

Δοκιμή της σύνδεσής σου

Άδειες (scopes)

Τι μπορείς να κάνεις

Read tools (10) - Pro και Ultra

Write tools (17) - Pro και Ultra

Αναφορά εργαλείων

get_notes

get_note

get_notes_full

get_tasks

get_events

get_reports

get_tags

get_profile

search

get_change_log

process_note (Pro και Ultra)

create_note (Pro και Ultra)

create_task (Pro και Ultra)

create_event (Pro και Ultra)

update_note (Pro και Ultra)

update_task (Pro και Ultra)

complete_task (Pro και Ultra)

update_event (Pro και Ultra)

delete_note (Pro και Ultra)

delete_task (Pro και Ultra)

delete_event (Pro και Ultra)

undo_change_log_entry (Pro και Ultra)

restore_entity (Pro και Ultra)

create_tag (Pro και Ultra)

set_tag_pinned (Pro και Ultra)

delete_tag (Pro και Ultra)

restore_tag (Pro και Ultra)

Όρια εισόδου

Χειρισμός σφαλμάτων

Παραδείγματα χρήσης

Ανάγνωση δεδομένων

Εγγραφή δεδομένων (Pro και Ultra)

Διαχείριση token

Τι μπορείς να ζητήσεις από τον AI agent σου

Σημαντικές σημειώσεις

Ασφάλεια

Απόρρητο και ροή δεδομένων

Επίλυση προβλημάτων

Δες επίσης