Agenci AI (MCP)
MCP działa we wszystkich planach. Free i Basic dostają dostęp tylko do odczytu do wszystkich 10 narzędzi odczytu (Free ma limit 100 żądań dziennie). Pro i Ultra dostają pełny dostęp Odczyt i zapis (27 narzędzi) i mogą przełączyć się na tryb tylko do odczytu, jeśli wolą.
MCP (Model Context Protocol) pozwala połączyć asystentów AI, takich jak ChatGPT i Claude, asystentów programistycznych oraz narzędzia do automatyzacji bezpośrednio z twoimi danymi z TellDone. Po połączeniu asystent może czytać twoje notatki, zadania, wydarzenia, raporty, tagi i historię zmian. W planie Pro i wyższych może też tworzyć, aktualizować, usuwać i przywracać elementy. Narzędzi jest 27: 10 do odczytu (każdy plan) i 17 do zapisu (od planu Pro).
Na iPhonie Ustawienia > Integracje > Agenci AI (MCP) otwiera ekran konfiguracji MCP z domyślnie zamaskowanym tokenem dostępu:
A w aplikacji webowej:
Dwa sposoby połączenia
Klienta AI możesz połączyć na dwa sposoby:
- Zaloguj się przez TellDone (OAuth) (zalecane) - logujesz się kontem TellDone i zatwierdzasz to, o co prosi aplikacja. Używają tego ChatGPT i Claude, a tokena nie trzeba kopiować.
- Token bearer - skopiuj token dostępu z Ustawień i wklej go do konfiguracji klienta. Najprostszy dla skryptów, narzędzi wiersza poleceń i klientów bez wbudowanego logowania OAuth.
| Klient | Zalecane |
|---|---|
| ChatGPT (chatgpt.com lub aplikacja ChatGPT na komputer, nie aplikacja mobilna) | OAuth - dodaj własny serwer MCP z adresem MCP, a potem zaloguj się |
| Claude (strona, Desktop, aplikacja na iPhone) / Cowork | OAuth - dodaj własny konektor z adresem MCP, a potem zaloguj się |
| Claude Code (CLI) | Na razie token bearer - dodaj nagłówek Authorization ze swoim tokenem |
| Skrypty lub twój własny kod | Token bearer - najłatwiejszy do zautomatyzowania |
| Klient, który pozwala wybierać tylko z katalogu konektorów | Dodaj TellDone jako własny konektor z adresem MCP albo użyj tokena bearer. TellDone nie jest jeszcze w żadnym katalogu konektorów |
Wymagania planu
| Plan | MCP |
|---|---|
| Free | Tylko do odczytu (10 narzędzi odczytu), 100 żądań dziennie |
| Basic | Tylko do odczytu (10 narzędzi odczytu), bez limitu dziennego |
| Pro | Odczyt i zapis (27 narzędzi) - można przełączyć na tryb Tylko do odczytu |
| Ultra | Odczyt i zapis (27 narzędzi) - można przełączyć na tryb Tylko do odczytu |
Limit 100 żądań dziennie w planie Free liczy tylko wywołania narzędzi. Łączenie, logowanie i wyświetlanie listy narzędzi się nie liczą. Dzień wyznacza strefa czasowa zapisana na twoim koncie i kończy się o północy. Gdy osiągniesz limit, twój asystent dostanie komunikat o tym. Narzędzia zapisu są odrzucane w planach Free i Basic. Przy tokenie dostępu odpowiadają, że połączenie jest tylko do odczytu, a tworzenie i edycja wymagają planu Pro lub wyższego. Przy logowaniu (OAuth) większość z nich odpowiada „Insufficient scope”, bo połączenia Free i Basic nigdy nie dostają uprawnień do zapisu.
Ekran w aplikacji
Otwórz Ustawienia > Integracje, a w sekcji Agenci AI dotknij Agenci AI (MCP). Ekran mówi: „Pozwól ChatGPT, Claude i innym asystentom AI pracować z twoimi notatkami, zadaniami i wydarzeniami z TellDone.” i pokazuje twój plan:
- Free: „Twój plan: dostęp tylko do odczytu, 100 żądań dziennie. Zapis dostępny od Pro.”
- Basic: „Twój plan: dostęp tylko do odczytu”
- Pro i Ultra: „Twój plan: dostęp do odczytu i zapisu”
Dopóki MCP jest wyłączone, dotknij Włącz, aby je włączyć.
Po włączeniu ekran pokazuje:
- Tryb dostępu (Pro i Ultra) - w dowolnej chwili wybierz Tylko do odczytu lub Odczyt i zapis.
- Połącz asystenta - kroki dla ChatGPT, Claude i Inny asystent. Logujesz się do TellDone w asystencie, więc token nie jest potrzebny.
- Połączone aplikacje - asystenci, których połączono, każdy z przyciskiem Rozłącz. Lista jest pusta do pierwszego połączenia.
- Dla programistów (domyślnie zwinięte) - pole Token dostępu (ukryte, z Pokaż / Ukryj i Kopiuj), Wygeneruj token na nowo oraz przełącznik Claude Code / Cursor / Other z gotowym tekstem i własnym przyciskiem Kopiuj. Claude Code daje polecenie
claude mcp add, Cursor daje JSON do.cursor/mcp.json, a Other podaje adres serwera, opcję logowania OAuth i nagłówekAuthorization: Bearer. Gdy token jest ukryty, fragmenty zawierająYOUR_TOKEN. Dotknij Pokaż, a będą zawierać twój prawdziwy token.
W aplikacji webowej są te same elementy w innym układzie, bez zwiniętej sekcji dla programistów: adres OAuth z przyciskiem Kopiuj, elementy do obsługi tokena, Połączone aplikacje z Rozłącz oraz Manual bearer token setup z sześcioma wyborami klienta (Claude Code, Cursor, Windsurf, Codex, OpenClaw i cURL). W aplikacji webowej fragmenty zawsze zawierają twój prawdziwy token, nawet gdy pole tokena jest ukryte, więc traktuj je jak sam token.
- Dokumentacja - link do tej strony.
- Wyłącz - wyłącza MCP. Potwierdzasz komunikatem „Spowoduje to odebranie dostępu wszystkim podłączonym narzędziom AI.” Twój token zostaje usunięty i wszystkie połączenia przestają działać. Jeśli włączysz MCP ponownie, dostaniesz nowy token, a aplikacje połączone przez logowanie (OAuth) znów działają bez ponownego logowania. Aby usunąć aplikację na stałe, dotknij Rozłącz w Połączone aplikacje.
Trzymaj token dostępu w tajemnicy. Każdy, kto ma token, ma dostęp do twoich danych z TellDone. Jeśli podejrzewasz, że wyciekł, dotknij Wygeneruj token na nowo.
Jak włączyć
MCP możesz skonfigurować na obu platformach:
- iPhone: Ustawienia > Integracje > Agenci AI (MCP)
- Web: app.telldone.app > Settings > Integrations > AI agents (MCP)
Kroki:
- Dotknij Włącz.
- W planach Pro i Ultra wybierz tryb dostępu (Tylko do odczytu lub Odczyt i zapis). Free i Basic są tylko do odczytu.
- Aby połączyć ChatGPT lub Claude, dotknij go w sekcji Połącz asystenta i wykonaj kroki (zobacz niżej). Token nie jest potrzebny.
- Dla klienta programistycznego na iPhonie otwórz Dla programistów, dotknij Pokaż, wybierz Claude Code, Cursor lub Other i dotknij Kopiuj pod fragmentem. Jeśli skopiujesz przed dotknięciem Pokaż, we fragmencie będzie
YOUR_TOKENzamiast twojego tokena. W aplikacji webowej wybierz klienta w Manual bearer token setup i skopiuj fragment; zawiera już twój token. - Wklej fragment do klienta lub jego pliku konfiguracyjnego.
Połączenie przez OAuth
OAuth to zalecana droga dla ChatGPT, Claude i Cowork - logujesz się kontem TellDone zamiast kopiować token.
Adres MCP dla OAuth: https://api.telldone.app/mcp/user
Ten sam serwer odpowiada też pod https://api.telldone.app/mcp/user/mcp, a oba adresy akceptują token bearer. Do logowania OAuth użyj pierwszego.
ChatGPT
Własny serwer MCP możesz dodać na chatgpt.com albo w aplikacji ChatGPT na komputer. Aplikacja mobilna ChatGPT nie pozwala dodawać własnych konektorów, a aplikacja TellDone ujmuje to tak: „Aplikacja ChatGPT dodaje konektory tylko ze swojego katalogu.” Dotknij Wyślij instrukcję na mój komputer w TellDone, aby dostać kroki na komputerze. Po dodaniu tam TellDone jest dostępne także w aplikacji mobilnej ChatGPT.
Kroki w aplikacji:
- Na komputerze otwórz chatgpt.com/plugins, kliknij Add i wybierz Add custom MCP server.
- Nazwij go TellDone, wklej poniższy adres (
https://api.telldone.app/mcp/user) i wybierz OAuth. - Potwierdź i zainstaluj go, a potem zaloguj się do TellDone i zezwól na dostęp.
Jeśli nazwy w menu się zmienią, zajrzyj do przewodnika OpenAI o własnych serwerach MCP.
Claude (strona, Desktop, aplikacja na iPhone) / Cowork
Kroki w aplikacji:
- W Claude otwórz Customize → Connectors i dotknij Add custom connector.
- Wklej poniższy adres (
https://api.telldone.app/mcp/user). - Zaloguj się do TellDone i zezwól na dostęp.
Podczas logowania strona zgody TellDone pokazuje, która aplikacja prosi o dostęp i jakich dokładnie uprawnień chce. Zaloguj się e-mailem i hasłem do TellDone i kliknij Allow access albo dotknij Sign in with Apple lub Sign in with Google, co zatwierdza dostęp w tym samym kroku. Claude łączy się sam - nie trzeba kopiować tokena.
Jeśli nazwy w menu się zmienią, zajrzyj do przewodnika Anthropic o dodawaniu własnego konektora.
Połączenie przez token bearer
W Claude Code, Cursorze i innych klientach bez wbudowanego logowania OAuth wklej token dostępu bezpośrednio do konfiguracji klienta. We wszystkich poniższych przykładach zamień YOUR_TOKEN na token z ustawień.
Claude Code (token bearer)
claude mcp add --transport http telldone \
https://api.telldone.app/mcp/user/mcp \
--header "Authorization: Bearer YOUR_TOKEN"
Nie musisz tego wpisywać sam: w Ustawienia > Integracje > Agenci AI (MCP) > Dla programistów dotknij Pokaż, wybierz Claude Code i dotknij Kopiuj. Skopiowane polecenie już zawiera twój token.
Cursor
Dodaj do .cursor/mcp.json (albo skopiuj z Dla programistów > Cursor po dotknięciu Pokaż):
{
"mcpServers": {
"telldone": {
"url": "https://api.telldone.app/mcp/user/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
Inni klienci
Ustawienia dla innych klientów MCP:
Codex
Dodaj do 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
Inni klienci MCP
Połączyć się może każde narzędzie obsługujące MCP przez HTTP. Użyj punktu końcowego https://api.telldone.app/mcp/user/mcp z nagłówkiem autoryzacji Bearer YOUR_TOKEN.
Jeśli twój klient lub proxy rezerwuje nagłówek Authorization (na przykład niektóre bramki w stylu Smithery), wyślij token w X-MCP-Token: YOUR_TOKEN. Działają oba nagłówki; jeśli są oba, wygrywa Authorization.
Testowanie połączenia
Możesz sprawdzić, czy token działa, prostym poleceniem 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}'
Udana odpowiedź wyświetla wszystkie dostępne narzędzia.
Uprawnienia (scopes)
Połączenia OAuth mają zakres uprawnień - podczas logowania widzisz dokładnie, o co prosi klient, i zatwierdzasz to wprost.
| Scope | Pozwala aplikacji... |
|---|---|
notes:read | Czytać twoje notatki i otwierać pełne szczegóły notatki (narzędzie wyszukiwania potrzebuje też tasks:read i events:read) |
notes:write | Tworzyć, edytować i usuwać notatki (process_note potrzebuje też tasks:write i events:write) |
tasks:read / tasks:write | Czytać / tworzyć, edytować, kończyć i usuwać zadania |
events:read / events:write | Czytać / tworzyć, edytować i usuwać wydarzenia |
reports:read | Czytać twoje raporty dzienne, tygodniowe, miesięczne i roczne |
tags:read / tags:write | Wyświetlać twoje tagi / tworzyć, przypinać, usuwać i przywracać tagi |
profile:read | Czytać informacje o koncie i subskrypcji |
offline_access | Utrzymać logowanie (wydaje token odświeżania, żeby nie trzeba było logować się ponownie w każdej sesji) |
Scopes ograniczają to, co może zrobić połączenie: połączenie tylko z notes:read nie może wywołać narzędzia zapisu. Twój plan wyznacza drugi limit, dodatkowo.
Połączenia z tokenem bearer nie mają osobnych zakresów - rządzi nimi wyłącznie tryb odczytu/zapisu twojego planu.
Co możesz robić
Narzędzia odczytu (10) - wszystkie plany
| Narzędzie | Co robi |
|---|---|
| get_notes | Wyświetla notatki z filtrami (tagi, zakres dat, wyszukiwanie tekstu) |
| get_note | Pokazuje pojedynczą notatkę z jej zadaniami, wydarzeniami i pełną transkrypcją |
| get_notes_full | Pobiera wiele notatek z osadzonymi zadaniami i wydarzeniami jednym wywołaniem |
| get_tasks | Wyświetla zadania filtrowane według statusu (do zrobienia, zrobione, wszystkie), tagów lub dat |
| get_events | Wyświetla wydarzenia z kalendarza, z filtrem zakresu dat |
| get_reports | Czyta twoje raporty dzienne, tygodniowe, miesięczne i roczne (pełny markdown) |
| get_tags | Pokazuje wszystkie twoje tagi posortowane według użycia |
| get_profile | Pokazuje informacje o koncie i liczbę twoich notatek, zadań i wydarzeń |
| search | Przeszukuje notatki, zadania i wydarzenia (tekst + wyszukiwanie semantyczne dla notatek) |
| get_change_log | Pokazuje historię edycji notatki, zadania lub wydarzenia oraz to, czy każda edycja została cofnięta |
Narzędzie search obsługuje wyszukiwanie semantyczne notatek - znajduje wyniki według znaczenia, nie tylko słów kluczowych. Na przykład wyszukanie „spotkania o budżecie” znajdzie notatki o rozmowach finansowych, nawet jeśli nie zawierają słowa „budżet”.
Narzędzia zapisu (17) - Pro i Ultra
| Narzędzie | Co robi |
|---|---|
| process_note | Pełny potok AI - wyślij tekst lub audio i dostań notatkę z zadaniami, wydarzeniami i tagami |
| create_note | Dodaje zwykłą notatkę tekstową (bez analizy AI) |
| create_task | Dodaje zadanie z priorytetem, terminem, przypomnieniem i tagami |
| create_event | Dodaje wydarzenie z datą, godziną, miejscem, przypomnieniami, uczestnikami i regułą powtarzania |
| update_note | Zmienia tytuł, podsumowanie, typ, tagi, priorytet lub status notatki |
| update_task | Zmienia tytuł, opis, priorytet, termin, przypomnienie, tagi lub status zadania |
| complete_task | Oznacza zadanie jako zrobione |
| update_event | Zmienia szczegóły wydarzenia, godzinę, miejsce, przypomnienia, uczestników, regułę powtarzania, tagi lub status |
| delete_note | Usuwa notatkę. Jej zadania i wydarzenia zostają |
| delete_task | Usuwa zadanie |
| delete_event | Usuwa wydarzenie |
| undo_change_log_entry | Cofa pojedynczą śledzoną edycję - wykonaną przez AI lub przez ciebie - przywracając poprzednią wartość pola |
| restore_entity | Przywraca usuniętą lub zarchiwizowaną notatkę albo zadanie, albo usunięte lub anulowane wydarzenie |
| create_tag | Tworzy nowy tag albo zmienia automatycznie zaproponowany tag w stały |
| set_tag_pinned | Przypina lub odpina tag, żeby był na górze listy |
| delete_tag | Usuwa tag (można go przywrócić przez restore_tag) |
| restore_tag | Przywraca usunięty tag |
Wszystkie operacje zapisu i usuwania od razu pojawiają się na twoich połączonych urządzeniach (telefon, aplikacja webowa).
Opis narzędzi
get_notes
Wyświetla notatki z opcjonalnym filtrowaniem. Filtry dat używają recorded_at (kiedy nagrano notatkę głosową) albo created_at dla notatki, która go nie ma.
| Parametr | Typ | Domyślnie | Opis |
|---|---|---|---|
limit | int | 20 | Liczba notatek do zwrócenia (maks. 50) |
offset | int | 0 | Pomiń tyle notatek (do paginacji, maks. 10000) |
tags | string | - | Filtr według tagów, rozdzielonych przecinkami (pasuje którykolwiek) |
search | string | - | Wyszukiwanie tekstu w tytule i podsumowaniu |
date_from | string | - | Data początkowa, YYYY-MM-DD (włącznie) |
date_to | string | - | Data końcowa, YYYY-MM-DD (wyłącznie) |
standalone_only | bool | false | Gdy true, ukrywa notatki uzupełniające (dołączone do notatki/zadania/wydarzenia nadrzędnego) i zwraca tylko samodzielne notatki |
Zwraca: listę notatek z id, title, summary, type, tags, priority, status, recorded_at, created_at.
get_note
Pobiera pojedynczą notatkę z jej pełną transkrypcją oraz wszystkimi powiązanymi zadaniami i wydarzeniami.
| Parametr | Typ | Opis |
|---|---|---|
note_id | string | UUID notatki |
Zwraca: notatkę z title, summary, transcript, type, tags, priority, status, metadata, created_at oraz tablicami tasks[] i events[].
Zwraca też transcript_speakers (tury transkrypcji z etykietami mówców, dla spotkań z kilkoma mówcami - w innym wypadku null), speaker_count (null, chyba że nagranie zostało podzielone według mówców) oraz parent_note_id/parent_task_id/parent_event_id (ustawione, gdy ta notatka jest uzupełniającą edycją innego elementu). Każdy wpis tasks[]/events[] zawiera też reminders_at/recurrence_rule (zadania) lub reminder_minutes/attendees/recurrence_rule (wydarzenia).
get_notes_full
Pobiera wiele notatek wraz z zadaniami i wydarzeniami jednym wywołaniem. Te same filtry co get_notes oprócz search, a każda notatka zawiera osadzone tasks[] i events[].
| Parametr | Typ | Domyślnie | Opis |
|---|---|---|---|
limit | int | 10 | Liczba notatek (maks. 20) |
offset | int | 0 | Pomiń tyle notatek |
tags | string | - | Filtr według tagów |
date_from | string | - | Data początkowa, YYYY-MM-DD |
date_to | string | - | Data końcowa, YYYY-MM-DD |
standalone_only | bool | false | Gdy true, ukrywa notatki uzupełniające (dołączone do notatki/zadania/wydarzenia nadrzędnego) i zwraca tylko samodzielne notatki |
get_tasks
Wyświetla zadania z filtrowaniem.
| Parametr | Typ | Domyślnie | Opis |
|---|---|---|---|
status | string | "todo" | Filtr: todo, done lub all |
limit | int | 30 | Liczba zadań (maks. 100) |
offset | int | 0 | Pomiń tyle zadań |
tags | string | - | Filtr według tagów, rozdzielonych przecinkami |
date_from | string | - | Data początkowa, YYYY-MM-DD (filtruje według terminu; zadania bez terminu są wykluczone) |
date_to | string | - | Data końcowa, YYYY-MM-DD (filtruje według terminu; zadania bez terminu są wykluczone) |
Zwraca: listę zadań z id, title, description, status, priority, tags, deadline, reminder_at, reminders_at, completed_at, completed_by, source, created_at. reminder_at odzwierciedla pierwszy wpis reminders_at ze względu na wsteczną zgodność - użyj reminders_at, aby zobaczyć wszystkie przypomnienia zadania.
get_events
Wyświetla wydarzenia z kalendarza z filtrowaniem według zakresu dat.
| Parametr | Typ | Domyślnie | Opis |
|---|---|---|---|
limit | int | 30 | Liczba wydarzeń (maks. 100) |
offset | int | 0 | Pomiń tyle wydarzeń |
date_from | string | - | Pierwszy dzień, YYYY-MM-DD, w twojej strefie czasowej (włącznie). Wydarzenia nakładające się na zakres są uwzględniane, więc wydarzenie wielodniowe pokazuje się w każdym dniu, który obejmuje |
date_to | string | - | Ostatni dzień, YYYY-MM-DD, w twojej strefie czasowej (włącznie) |
Zwraca: listę wydarzeń 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
Pobiera wygenerowane przez AI raporty z pełną treścią markdown.
| Parametr | Typ | Domyślnie | Opis |
|---|---|---|---|
report_type | string | "daily" | Typ: daily, weekly, monthly lub yearly |
limit | int | 5 | Liczba raportów (maks. 10) |
Zwraca: listę raportów z id, type, period_start, period_end, content_md, created_at.
Raporty miesięczne są długie (często znacznie ponad 1000 słów). Użyj limit=1, jeśli twoje narzędzie AI ma wąskie okno kontekstu.
get_tags
Pobiera wszystkie twoje tagi, posortowane najpierw według przypięcia, potem według liczby użyć.
Bez parametrów. Zwraca do 100 tagów, każdy z tag, usage_count, is_pinned, is_manual.
get_profile
Pobiera informacje o koncie i liczbę twoich notatek, zadań i wydarzeń.
Bez parametrów. Zwraca email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at oraz stats (liczby notatek/zadań/wydarzeń).
search
Przeszukuje naraz notatki, zadania i wydarzenia. Dla notatek obsługuje zarówno wyszukiwanie tekstu, jak i semantyczne (znajduje wyniki według znaczenia za pomocą osadzeń AI).
| Parametr | Typ | Domyślnie | Opis |
|---|---|---|---|
query | string | required | Szukany tekst (maks. 500 znaków) |
limit | int | 20 | Maks. wyników na typ (maks. 20) |
semantic | bool | true | Włącza wyszukiwanie semantyczne dla notatek |
Zwraca wyniki pogrupowane według typu: notes[], tasks[], events[]. Każdy wynik ma id, type, title, detail, created_at.
Ustaw semantic=false, aby uzyskać szybsze wyszukiwanie tylko tekstu.
get_change_log
Pokazuje historię edycji notatki, zadania lub wydarzenia - każdą edycję uzupełniającą wykonaną przez AI i każdą twoją ręczną edycję, od najnowszej.
| Parametr | Typ | Domyślnie | Opis |
|---|---|---|---|
entity | string | required | notes, tasks lub events |
entity_id | string | required | UUID elementu |
include_manual | bool | false | Uwzględnia też twoje ręczne edycje, nie tylko te wykonane przez AI |
Zwraca: listę wpisów zmian z id (użyj go jako entry_id do cofania), field_name, old_value, new_value, source (follow_up, smart_context, correction_sync dla poprawki nazwy, którą TellDone przeniósł przez notatkę, lub manual), origin_note_id, edited_at i reverted_at (ustawione po cofnięciu).
process_note (Pro i Ultra)
Pełny potok AI - działa tak samo jak nagrywanie w aplikacji. Wyślij tekst lub audio, a TellDone to przepisze, przeanalizuje za pomocą AI i utworzy uporządkowaną notatkę z wyciągniętymi zadaniami, wydarzeniami, tagami i osadzeniami.
To narzędzie jest asynchroniczne: zwraca od razu audio_id i przetwarza w tle. Wyniki docierają przez synchronizację w czasie rzeczywistym na twoje połączone urządzenia albo możesz je odpytywać przez get_notes().
| Parametr | Typ | Opis |
|---|---|---|
text | string | Wymagane. Tekst do analizy. Jeśli nie jest pusty, służy jako transkrypcja, a wysłane audio nie jest transkrybowane; wyślij "", aby audio zostało przepisane. Limit, gdy nie wysłano audio: Pro 20 000 / Ultra 50 000 znaków |
audio_base64 | string | Plik audio zakodowany w Base64. Całe żądanie jest ograniczone do 10 MB, więc samo audio może mieć około 7 MB. Jest transkrybowane tylko wtedy, gdy text jest pusty |
audio_format | string | m4a, ogg, wav, mp3, aac lub webm (domyślnie: m4a) |
parent_task_id | string | UUID zadania, do którego to jest uzupełnienie |
parent_note_id | string | UUID notatki, do której to jest uzupełnienie |
parent_event_id | string | UUID wydarzenia, do którego to jest uzupełnienie |
Zawsze wysyłaj text. Aby TellDone przepisało audio, wyślij audio_base64 z text ustawionym na pusty ciąg (""). Jeśli text nie jest pusty, TellDone używa go jako transkrypcji i nie przepisuje audio. Ustaw co najwyżej jeden z trzech identyfikatorów nadrzędnych.
Zwraca: {"audio_id": "...", "status": "processing", "mode": "text-only"} albo "mode": "audio+stt", jeśli podano audio.
process_note podlega limitom twojego planu (wysyłki dziennie, notatki miesięcznie, maks. długość tekstu). get_profile pokazuje tylko liczbę twoich notatek, zadań i wydarzeń, a nie twoje limity. Zużycie sprawdzisz w aplikacji w Ustawienia > Zużycie.
create_note (Pro i Ultra)
Tworzy od razu zwykłą notatkę tekstową. Nie uruchamia analizy AI - żadne zadania ani wydarzenia nie są wyciągane. Użyj process_note, gdy chcesz, by TellDone znalazło zadania i wydarzenia za ciebie.
| Parametr | Typ | Limit | Opis |
|---|---|---|---|
title | string | 200 znaków | Wymagane |
summary | string | 1000 znaków | Opcjonalne. Krótka zajawka (1-3 zdania). Używana w twoich raportach, więc niech będzie krótka |
transcript | string | zależny od planu | Opcjonalne. Długi tekst pokazywany w szczegółach notatki. Nie jest uwzględniany w raportach. Limity: Pro 20 000 / Ultra 50 000 znaków |
type | string | - | Opcjonalne. task, idea, info (domyślnie), status, meeting, event lub reflection |
tags | string | 20 tagów | Rozdzielone przecinkami, opcjonalne |
suppress_external_sync | boolean | - | Opcjonalne, domyślnie false. Ustaw true dla elementów importowanych lub dodawanych hurtowo: wtedy element nie jest wysyłany do twoich połączonych aplikacji ani automatyzacji |
create_task (Pro i Ultra)
Tworzy nowe zadanie. Zadanie powstaje też w połączonym Todoist, Notion lub Microsoft To Do, a twoje automatyzacje dostają task.created. Nie dzieje się tak, gdy podasz suppress_external_sync: true.
| Parametr | Typ | Limit | Opis |
|---|---|---|---|
title | string | 200 znaków | Wymagane |
description | string | 2000 znaków | Opcjonalne |
priority | string | - | low, medium (domyślnie) lub high |
deadline | string | - | YYYY-MM-DD, opcjonalne |
reminder_at | string | - | Data i godzina ISO 8601 (na przykład 2026-04-15T09:00:00Z), opcjonalne |
tags | string | 20 tagów | Rozdzielone przecinkami, opcjonalne |
note_id | string | - | UUID, aby powiązać zadanie z notatką nadrzędną, opcjonalne |
suppress_external_sync | boolean | - | Opcjonalne, domyślnie false. Ustaw true dla elementów importowanych lub dodawanych hurtowo: wtedy element nie jest wysyłany do twoich połączonych aplikacji ani automatyzacji |
create_event (Pro i Ultra)
Tworzy wydarzenie w kalendarzu. Wydarzenie powstaje też w połączonym Notion, a twoje automatyzacje dostają calendar_event.created. Nie dzieje się tak, gdy podasz suppress_external_sync: true.
| Parametr | Typ | Limit | Opis |
|---|---|---|---|
title | string | 200 znaków | Wymagane |
start_at | string | - | Data i godzina ISO 8601, wymagane |
end_at | string | - | Data i godzina ISO 8601 (domyślnie: start + 1 godzina; dla wydarzenia całodniowego jeden dzień) |
description | string | 2000 znaków | Opcjonalne |
location | string | 200 znaków | Opcjonalne |
is_all_day | bool | - | Domyślnie: false |
tags | string | 20 tagów | Rozdzielone przecinkami, opcjonalne |
reminder_minutes | string | - | Minuty przed wydarzeniem, rozdzielone przecinkami (na przykład 15,60), opcjonalne |
attendees | string | - | Imiona lub adresy e-mail rozdzielone przecinkami, opcjonalne |
recurrence_rule | string | - | Ciąg RRULE (na przykład FREQ=WEEKLY;BYDAY=MO,WE,FR), opcjonalne. Reguły częstsze niż co godzinę albo takie, które nigdy nie mogą się zdarzyć, są odrzucane |
note_id | string | - | UUID, aby powiązać wydarzenie z notatką nadrzędną, opcjonalne |
suppress_external_sync | boolean | - | Opcjonalne, domyślnie false. Ustaw true dla elementów importowanych lub dodawanych hurtowo: wtedy element nie jest wysyłany do twoich połączonych aplikacji ani automatyzacji |
update_note (Pro i Ultra)
Aktualizuje jedno lub więcej pól istniejącej notatki. Zmieniane są tylko podane pola. Działa to dokładnie tak jak edycja notatki w aplikacji: jej tytuł, podsumowanie, tagi i typ trafiają na jej stronę w Notion, twoje automatyzacje dostają note.updated, a zmiana pojawia się w historii zmian, gdzie możesz ją cofnąć. Zmiana transkrypcji też jest zapisywana i wysyłana do Notion, ale nie trafia do historii zmian.
| Parametr | Typ | Opis |
|---|---|---|
note_id | string | Wymagane, UUID notatki |
title | string | Nowy tytuł (maks. 200 znaków) |
summary | string | Nowe podsumowanie (maks. 1000 znaków, podaj spację " ", aby wyczyścić) |
transcript | string | Nowa transkrypcja (limit zależny od planu, podaj spację " ", aby wyczyścić) |
type | string | task, idea, info, status, meeting, event lub reflection |
tags | string | Tagi rozdzielone przecinkami (zastępują wszystkie istniejące tagi, maks. 20) |
priority | string | low, medium lub high |
status | string | active lub archived |
W notatkach utworzonych przez potok głosowy transcript to oryginalny wynik zamiany mowy na tekst. Nadpisanie go zastępuje twoje oryginalne słowa. Aby je zachować, dopisz do transkrypcji zamiast ją zastępować.
update_task (Pro i Ultra)
Aktualizuje jedno lub więcej pól istniejącego zadania. Zmieniane są tylko podane pola. Działa to dokładnie tak jak edycja zadania w aplikacji: zmiana trafia do jego kopii w Todoist, Notion i Microsoft To Do, twoje automatyzacje dostają task.updated, a zmiana pojawia się w historii zmian zadania, gdzie możesz ją cofnąć. Ustawienie status na done kończy zadanie tak samo jak complete_task. Termin może być datą albo pełną datą z godziną (używana jest wtedy sama data). Każdy tag może mieć do 50 znaków.
| Parametr | Typ | Opis |
|---|---|---|
task_id | string | Wymagane, UUID zadania |
title | string | Nowy tytuł |
description | string | Nowy opis (podaj spację " ", aby wyczyścić) |
priority | string | low, medium lub high |
deadline | string | YYYY-MM-DD. To narzędzie nie może wyczyścić terminu; wyczyść go w aplikacji |
status | string | todo lub done |
tags | string | Tagi rozdzielone przecinkami (zastępują wszystkie istniejące tagi, maks. 20) |
reminder_at | string | Data i godzina ISO 8601 (podaj spację, aby wyczyścić) |
Ustawienie status na done zapisuje też, kiedy i jak zadanie zostało ukończone.
complete_task (Pro i Ultra)
Skrót do oznaczenia zadania jako zrobionego.
| Parametr | Typ | Opis |
|---|---|---|
task_id | string | Wymagane, UUID zadania |
Zwraca błąd, jeśli zadanie nie istnieje lub jest już ukończone.
update_event (Pro i Ultra)
Aktualizuje jedno lub więcej pól istniejącego wydarzenia. Zmieniane są tylko podane pola. Działa to dokładnie tak jak edycja wydarzenia w aplikacji: zmiana trafia na jego stronę w Notion, twoje automatyzacje dostają calendar_event.updated, a zmiana pojawia się w historii zmian, gdzie możesz ją cofnąć.
| Parametr | Typ | Opis |
|---|---|---|
event_id | string | Wymagane, UUID wydarzenia |
title | string | Nowy tytuł |
description | string | Nowy opis (podaj spację, aby wyczyścić) |
start_at | string | Nowa godzina rozpoczęcia (ISO 8601) |
end_at | string | Nowa godzina zakończenia (ISO 8601) |
location | string | Nowe miejsce (podaj spację, aby wyczyścić) |
status | string | confirmed, tentative lub cancelled |
tags | string | Tagi rozdzielone przecinkami (zastępują wszystkie istniejące tagi, maks. 20) |
is_all_day | string | "true" lub "false" |
reminder_minutes | string | Minuty przed wydarzeniem, rozdzielone przecinkami (na przykład 15,60, podaj spację, aby wyczyścić) |
attendees | string | Imiona lub adresy e-mail rozdzielone przecinkami (podaj spację, aby wyczyścić) |
recurrence_rule | string | Ciąg RRULE (podaj spację, aby wyczyścić) |
delete_note (Pro i Ultra)
Usuwa notatkę. Usuwana jest tylko notatka: jej zadania i wydarzenia zostają. Działa to dokładnie tak jak usunięcie w aplikacji: twoje automatyzacje dostają note.deleted. Kopia notatki w Notion nie jest usuwana (aplikacja też jej nie usuwa).
| Parametr | Typ | Opis |
|---|---|---|
note_id | string | Wymagane, UUID notatki |
delete_task (Pro i Ultra)
Usuwa zadanie. Działa to dokładnie tak jak usunięcie w aplikacji: jego kopie w Todoist, Notion i Microsoft To Do też są usuwane, a twoje automatyzacje dostają task.deleted. Przywrócisz je przez restore_entity.
| Parametr | Typ | Opis |
|---|---|---|
task_id | string | Wymagane, UUID zadania |
delete_event (Pro i Ultra)
Usuwa wydarzenie. Działa to dokładnie tak jak usunięcie w aplikacji: twoje automatyzacje dostają calendar_event.deleted. Strona wydarzenia w Notion nie jest usuwana (aplikacja też jej nie usuwa).
| Parametr | Typ | Opis |
|---|---|---|
event_id | string | Wymagane, UUID wydarzenia |
undo_change_log_entry (Pro i Ultra)
Cofa pojedynczą śledzoną edycję - przywraca pole do wartości sprzed tej edycji, niezależnie od tego, czy wykonało ją AI (z nagrania uzupełniającego), czy ty bezpośrednio.
| Parametr | Typ | Opis |
|---|---|---|
entity | string | Wymagane, notes, tasks lub events |
entity_id | string | Wymagane, UUID elementu |
entry_id | string | Wymagane, id wpisu zmiany z get_change_log |
Zwraca: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Cofnięcie tego samego wpisu dwa razy zwraca błąd - jest już cofnięty.
restore_entity (Pro i Ultra)
Przywraca usuniętą lub zarchiwizowaną notatkę albo zadanie, albo usunięte lub anulowane wydarzenie.
| Parametr | Typ | Opis |
|---|---|---|
entity | string | Wymagane, notes, tasks lub events |
entity_id | string | Wymagane, UUID elementu |
Zwraca: przywrócony element jako JSON.
create_tag (Pro i Ultra)
Tworzy nowy tag albo zmienia istniejący, automatycznie zaproponowany tag w stały.
| Parametr | Typ | Opis |
|---|---|---|
tag | string | Wymagane, 1-50 znaków (zapisywane małymi literami) |
category | string | Opcjonalne |
set_tag_pinned (Pro i Ultra)
Przypina lub odpina tag, żeby był na górze listy tagów.
| Parametr | Typ | Opis |
|---|---|---|
tag | string | Wymagane |
pinned | bool | Wymagane |
Tagów zawierających znak / nie można przypiąć.
delete_tag (Pro i Ultra)
Usuwa tag. Można go przywrócić przez restore_tag.
| Parametr | Typ | Opis |
|---|---|---|
tag | string | Wymagane |
restore_tag (Pro i Ultra)
Przywraca usunięty tag.
| Parametr | Typ | Opis |
|---|---|---|
tag | string | Wymagane |
Limity danych wejściowych
| Pole | Maks. długość | Używane w |
|---|---|---|
| title | 200 znaków | create/update note, task, event |
| description | 2000 znaków | create/update task, event |
| summary | 1000 znaków (twardy limit) | create/update note. Używane w twoich raportach, więc niech będzie krótkie |
| transcript | zależny od planu: Pro 20 000 / Ultra 50 000 | create/update note. Długi tekst, nie ma go w raportach |
| text | zależny od planu: Pro 20 000 / Ultra 50 000 (gdy nie wysłano audio) | process_note |
| location | 200 znaków | create/update event |
| tags | 20 tagów | create/update note, task, event |
| search query | 500 znaków | search |
| audio_base64 | około 7 MB audio (całe żądanie jest ograniczone do 10 MB) | process_note |
Jeśli przekroczysz limit, narzędzie zwraca komunikat o błędzie, na przykład "title too long (max 200 chars, got 250)".
Obsługa błędów
Większość narzędzi zwraca błędy jako JSON:
{"error": "description of what went wrong"}
Błędy planu, zakresu i limitów danych wejściowych wracają jako błąd narzędzia z tym samym komunikatem.
Częste błędy:
| Błąd | Kiedy |
|---|---|
"This TellDone connection is read-only. Creating and editing needs the Pro or Ultra plan." | Wywołano narzędzie zapisu w trybie tylko do odczytu (Free i Basic albo Pro i Ultra przełączone na tryb tylko do odczytu) |
"Daily limit reached: the Free plan includes 100 TellDone requests a day..." | Plan Free wykorzystał 100 żądań na dany dzień |
"Daily limit reached (N/M today)" | Utworzono dziś przez asystentów AI tyle elementów, ile pozwala twój plan (process_note, create_note, create_task i create_event liczą się każde) |
"Notes limit reached (X/Y this month)" | Miesięczny limit notatek w twoim planie jest wyczerpany |
"Invalid note_id format" | Jako identyfikator podano ciąg niebędący UUID |
"Note not found" | Identyfikator nie istnieje lub należy do innego użytkownika |
"Task not found or already completed" | complete_task na nieistniejącym lub już zrobionym zadaniu |
"title too long (max 200 chars, got N)" | Przekroczono limit danych wejściowych |
"Too many tags (max 20)" | Podano więcej niż 20 tagów |
Błędy na poziomie HTTP:
| Kod | Znaczenie |
|---|---|
| 401 | Nieprawidłowy, unieważniony lub usunięty token (wyłączenie MCP usuwa token, a wygenerowanie na nowo go zastępuje) |
| 429 | Przekroczono limit żądań (5 żądań/s, seria do 20) |
W planie Free osiągnięcie limitu 100 żądań dziennie jest zgłaszane jako komunikat błędu narzędzia (nie kod HTTP) i resetuje się o północy w strefie czasowej zapisanej na twoim koncie.
Przykłady użycia
Wszystkie przykłady używają cURL z protokołem MCP JSON-RPC. Zamień YOUR_TOKEN na swój token dostępu.
Odczyt danych
# 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}}}'
Zapis danych (Pro i Ultra)
# Process a note through full AI pipeline (extracts tasks + events)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":10,"method":"tools/call",
"params":{"name":"process_note","arguments":{"text":"Need to buy groceries tomorrow. Meeting with Katie at 3pm at the cafe to discuss the project."}}}'
# Create a task with deadline and reminder
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":11,"method":"tools/call",
"params":{"name":"create_task","arguments":{"title":"Review PR","priority":"high","deadline":"2026-04-15","reminder_at":"2026-04-15T09:00:00Z","tags":"dev"}}}'
# Create a repeating event with reminders and attendees
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":12,"method":"tools/call",
"params":{"name":"create_event","arguments":{"title":"Team standup","start_at":"2026-04-12T10:00:00Z","reminder_minutes":"15","attendees":"Katie,John","recurrence_rule":"FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR","tags":"meeting"}}}'
# Complete a task
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":13,"method":"tools/call",
"params":{"name":"complete_task","arguments":{"task_id":"<task-uuid>"}}}'
Udana odpowiedź wygląda tak:
{
"jsonrpc": "2.0",
"id": 11,
"result": {
"content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Review PR\",\"status\":\"todo\"}"}]
}
}
Narzędzia zapisu i aktualizacji zwracają krótkie odpowiedzi, głównie id, title i status. Narzędzia usuwania zwracają id i deleted. Aby po zapisie dostać pełne szczegóły (tagi, priorytet, termin itd.), wykonaj kolejne wywołanie odczytu, na przykład get_tasks lub get_note.
Zarządzanie tokenem
| Czynność | Jak |
|---|---|
| Podgląd tokena | iPhone Ustawienia > Integracje > Agenci AI (MCP) > Dla programistów (albo w aplikacji webowej Settings > Integrations > AI agents (MCP)), dotknij Pokaż |
| Kopiowanie tokena | Dotknij Kopiuj obok tokena |
| Wygenerowanie na nowo | Dotknij Wygeneruj token na nowo i potwierdź. Stary token przestaje działać natychmiast. Asystenci połączeni przez logowanie OAuth nie są dotknięci; rozłącz ich w Połączone aplikacje |
| Zmiana trybu | Pro i Ultra: wybierz Tylko do odczytu lub Odczyt i zapis. Free i Basic zawsze są tylko do odczytu |
| Wyłączenie | Dotknij Wyłącz i potwierdź („Spowoduje to odebranie dostępu wszystkim podłączonym narzędziom AI.”). Twój token zostaje usunięty i wszystkie połączenia przestają działać. Jeśli włączysz MCP ponownie, dostaniesz nowy token, a aplikacje połączone przez logowanie (OAuth) znów działają bez ponownego logowania. Aby usunąć aplikację na stałe, dotknij Rozłącz w Połączone aplikacje |
O co możesz poprosić swojego agenta AI
Po połączeniu zapytaj swoje narzędzie AI o takie rzeczy:
Przegląd dnia:
- „Podsumuj, co dziś zostało zrobione”
- „Pokaż moje notatki z tego tygodnia”
- „Jakie zadania są po terminie?”
Zarządzanie zadaniami:
- „Utwórz zadanie: przejrzeć raport kwartalny, wysoki priorytet, termin w piątek”
- „Oznacz zadanie z Figmą jako zrobione”
- „Jakie zadania są teraz w toku?”
Wyszukiwanie i analiza:
- „Znajdź wszystkie notatki o strategii marketingowej”
- „Jakie wydarzenia mam w przyszłym tygodniu?”
- „Podsumuj moje raporty dzienne z zeszłego tygodnia”
Planowanie:
- „Utwórz wydarzenie: stand-up zespołu jutro o 10:00”
- „Co mam w kalendarzu w tym tygodniu?”
- „Pokaż moje najczęstsze tagi - na co poświęcam najwięcej czasu?”
Twój asystent może czytać twoje notatki, zadania, wydarzenia i raporty oraz odpowiadać na złożone pytania, łącząc informacje z kilku narzędzi. W planach Pro i Ultra z włączonym trybem Odczyt i zapis może je także tworzyć, aktualizować i usuwać.
Warto wiedzieć
- Integracje i automatyzacje -
process_notedziała jak nagranie, więc jego notatka, zadania i wydarzenia trafiają do twoich połączonych integracji i automatyzacji webhook. Elementy, które tworzysz, edytujesz lub usuwasz pozostałymi narzędziami zapisu, zachowują się dokładnie tak jak w aplikacji: trafiają do twoich połączonych integracji (wydarzenia i zmiany w notatkach tylko do Notion) i do twoich automatyzacji. Przywrócenie zadania przezrestore_entityalbo cofnięcie jego ukończenia przezundo_change_log_entryponownie otwiera je też w integracjach, z którymi było zsynchronizowane. - Zmiany wprowadzone przez asystenta AI - w historii zmian elementu są oznaczone jako wprowadzone przez asystenta. Nie służą do uczenia rozpoznawania mowy w TellDone i nie są kopiowane do innych elementów notatki. Zmiany przez asystenta wliczają się do tego samego limitu co w aplikacji: 30 zmian na minutę.
- Wyszukiwanie semantyczne - notatki utworzone przez
process_notelubcreate_notedostają osadzenia, więc po krótkim czasie pojawiają się w wyszukiwaniu semantycznym. - Filtry dat - dla notatek daty to dni UTC. Dla wydarzeń daty to twoje lokalne dni, a wydarzenie nakładające się na zakres jest uwzględniane. Dla zadań filtrem jest data terminu.
Bezpieczeństwo
- Każdy użytkownik dostaje unikalny 384-bitowy token dostępu
- Twój token jest unieważniany natychmiast po wyłączeniu MCP lub wygenerowaniu go na nowo
- Każde żądanie jest ograniczone do twojego konta, więc agent ma dostęp tylko do twoich danych
- Połączenie używa HTTPS z ograniczaniem liczby żądań (5 żądań/s, seria do 20)
- Połączenia OAuth używają PKCE, jednorazowych kodów autoryzacji i krótkotrwałych tokenów dostępu - połączenie możesz w każdej chwili odwołać w aplikacji
Aby poznać szczegóły techniczne - punkty końcowe wykrywania, czasy życia tokenów, pełny przebieg OAuth - zobacz naszą otwartą dokumentację konektora na github.com/exp78/telldone-mcp albo odpytaj bezpośrednio https://api.telldone.app/.well-known/oauth-protected-resource.
Prywatność i przepływ danych
Podłączone narzędzie AI dostaje twoje dane tylko wtedy, gdy wywołuje TellDone, zwykle dlatego, że o coś je zapytano. Otrzymuje tylko odpowiedzi na te wywołania, w granicach zatwierdzonych uprawnień. Aby ograniczyć dostęp, przełącz na Tylko do odczytu, rozłącz aplikację w Połączone aplikacje albo wygeneruj na nowo lub wyłącz token dostępu w Ustawieniach. Pełne szczegóły znajdziesz w Polityce prywatności, a z pytaniami napisz na support@telldone.app.
Rozwiązywanie problemów
| Objaw | Przyczyna / rozwiązanie |
|---|---|
| Strona zgody OAuth mówi „Wrong email or password” | Użyj e-maila i hasła, którymi logujesz się do aplikacji, albo wybierz Sign in with Apple / Sign in with Google na tej samej stronie. |
| Połączono, ale AI nie może niczego tworzyć ani edytować | Twój plan to Free lub Basic (tylko odczyt), twój tryb to tylko odczyt albo połączenie nie ma uprawnień do zapisu. Jeśli połączono przed przejściem na wyższy plan, rozłącz aplikację w Połączone aplikacje i połącz ją ponownie. Swój tryb sprawdzisz w Ustawieniach. |
| Błąd „Insufficient scope” z narzędzia | Połączenie nie ma tego uprawnienia. W planach Free i Basic uprawnienia do zapisu nigdy nie są przyznawane, więc tworzenie i edycja wymagają Pro lub Ultra. Jeśli połączono przed przejściem na wyższy plan, rozłącz aplikację w Połączone aplikacje i połącz ją ponownie. |
Skopiowany fragment zawiera YOUR_TOKEN i klient nie może się połączyć | Skopiowano go, gdy token był ukryty. W Dla programistów dotknij Pokaż, a potem skopiuj fragment jeszcze raz. |
| Narzędzia w ogóle się nie pojawiają | MCP nie jest włączone na twoim koncie (Ustawienia > Integracje > Agenci AI (MCP) > Włącz). |
| „Daily limit reached” | Ten komunikat dotyczy dwóch limitów. „Daily limit reached: the Free plan includes 100 TellDone requests a day” to limit żądań w planie Free. „Daily limit reached (N/M today)” znaczy, że dziś utworzono przez asystentów AI tyle elementów, ile pozwala twój plan: process_note, create_note, create_task i create_event liczą się każde, także w planach Pro i Ultra. Oba resetują się o północy w strefie czasowej zapisanej na twoim koncie. |
| Mój klient pozwala wybierać tylko z listy konektorów, a TellDone jej nie ma | TellDone nie jest jeszcze w katalogu konektorów żadnego klienta - dodaj je jako własny konektor z adresem MCP albo użyj metody z tokenem bearer. |
Zobacz też
- Automatyzacje webhook - wysyłaj dane do zewnętrznych usług automatycznie
- Todoist - dedykowana dwukierunkowa synchronizacja zadań
- Notion - dedykowana integracja z Notion