AI Ajanları (MCP)

Her planda kullanılabilir

MCP tüm planlarda çalışır. Free ve Basic, 10 okuma aracının tamamına salt okunur erişim alır (Free günde 100 istekle sınırlıdır). Pro ve Ultra tam Okuma ve Yazma erişimi (27 araç) alır ve isterlerse salt okunur moda geçebilir.

MCP (Model Context Protocol), ChatGPT ve Claude gibi AI asistanlarını, kodlama asistanlarını ve otomasyon araçlarını doğrudan TellDone verilerine bağlamanı sağlar. Bağlandıktan sonra asistanın notlarını, görevlerini, etkinliklerini, raporlarını, etiketlerini ve değişiklik geçmişini okuyabilir. Pro ve üstünde öğe oluşturabilir, güncelleyebilir, silebilir ve geri yükleyebilir de. Toplam 27 araç var: 10'u okuma (her plan), 17'si yazma (Pro ve üstü) için.

iPhone'da Ayarlar > Entegrasyonlar > AI Ajanları (MCP), erişim token'ının varsayılan olarak gizli olduğu MCP kurulum ekranını açar:

iPhone'da token'ı gizli AI Ajanları ayarları

Web'de ise:

Web'de erişim token'ı gizli AI Ajanları ayarları

Bağlanmanın iki yolu

Bir AI istemcisini bağlamanın iki yolu var:

TellDone ile giriş yap (OAuth) (önerilen) - TellDone hesabınla giriş yapar ve uygulamanın istediklerini onaylarsın. ChatGPT ve Claude bunu kullanır, kopyalanacak token yoktur.
Bearer token - erişim token'ını Ayarlar'dan kopyala ve istemcinin yapılandırmasına yapıştır. Betikler, komut satırı araçları ve yerleşik OAuth akışı olmayan istemciler için en basit yoldur.

İstemci	Önerilen
ChatGPT (chatgpt.com ya da ChatGPT masaüstü uygulaması, mobil uygulama değil)	OAuth - MCP URL'siyle özel bir MCP sunucusu ekle, sonra giriş yap
Claude (web sitesi, Desktop, iPhone uygulaması) / Cowork	OAuth - MCP URL'siyle özel bir bağlayıcı ekle, sonra giriş yap
Claude Code (CLI)	Şimdilik Bearer token - token'ınla `Authorization` başlığını ekle
Betikler ya da kendi kodun	Bearer token - otomatikleştirmesi en basit olan
Yalnızca listelenmiş bağlayıcılar dizininden seçim yapmana izin veren bir istemci	TellDone'u MCP URL'siyle özel bir bağlayıcı olarak ekle ya da bir bearer token kullan. TellDone henüz hiçbir bağlayıcı dizininde yok

Plan gereksinimleri

Plan	MCP
Free	Salt okunur (10 okuma aracı), günde 100 istek
Basic	Salt okunur (10 okuma aracı), günlük sınır yok
Pro	Okuma ve Yazma (27 araç) - Salt okunur moda geçebilir
Ultra	Okuma ve Yazma (27 araç) - Salt okunur moda geçebilir

Free'deki günde 100 istek sınırı yalnızca araç çağrılarını sayar. Bağlanma, giriş yapma ve araçları listeleme sayılmaz. Gün, hesabında kayıtlı saat dilimini izler ve gece yarısı sıfırlanır. Sınıra ulaştığında asistanın bunu belirten bir mesaj alır. Yazma araçları Free ve Basic'te reddedilir. Erişim token'ıyla bağlantının salt okunur olduğunu ve oluşturma ile düzenlemenin Pro ve üstünü gerektirdiğini söyleyen bir yanıt verirler. Giriş yaparak (OAuth) bağlandığında çoğu "Insufficient scope" yanıtı verir, çünkü Free ve Basic bağlantıları hiçbir zaman yazma izni almaz.

Uygulama içi ekran

Ayarlar > Entegrasyonlar'ı aç ve AI Ajanları bölümünde AI Ajanları (MCP)'ye dokun. Ekran "ChatGPT, Claude ve diğer AI asistanlarının TellDone'daki notlarınla, görevlerinle ve etkinliklerinle çalışmasına izin ver." yazar ve planını gösterir:

Free: "Planın: Salt okunur erişim, günde 100 istek. Yazma Pro ile gelir."
Basic: "Planın: Salt okunur erişim"
Pro ve Ultra: "Planın: Okuma ve Yazma erişimi"

MCP kapalıyken açmak için Etkinleştir'e dokun.

Etkinleştirildiğinde ekran şunları gösterir:

Erişim modu (Pro ve Ultra) - istediğin zaman Salt okunur ya da Okuma ve Yazma'yı seç.
Asistan bağla - ChatGPT, Claude ve Başka bir asistan için adımlar. TellDone'da asistanın içinden giriş yaparsın, token gerekmez.
Bağlı uygulamalar - bağladığın asistanlar, her birinde bir Bağlantıyı kes düğmesiyle. İlk bağlantıya kadar boş kalır.
Geliştiriciler için (varsayılan olarak kapalı) - Erişim Token'ı alanı (gizli, Göster / Gizle ve Kopyala ile), Token'ı Yenile ve kendi Kopyala düğmesi olan, hazır metin sunan bir Claude Code / Cursor / Diğer seçici. Claude Code sana claude mcp add komutunu, Cursor .cursor/mcp.json için JSON'u, Diğer ise sunucu adresini, OAuth ile giriş seçeneğini ve Authorization: Bearer başlığını verir. Token gizliyken metinlerde YOUR_TOKEN görünür. Göster'e dokunursan gerçek token'ını içerirler.

Web'de aynı denetimler farklı bir düzende yer alır ve katlanmış bir geliştirici bölümü yoktur: Kopyala düğmeli OAuth adresi, token denetimlerin, Bağlantıyı kes ile Bağlı uygulamalar ve altı istemci seçeneği olan Manuel bearer token kurulumu (Claude Code, Cursor, Windsurf, Codex, OpenClaw ve cURL). Web'de token alanı gizliyken bile metinler her zaman gerçek token'ını içerir, bu yüzden onlara token'ın kendisi gibi davran.

Belgeler - bu sayfaya bir bağlantı.
Devre dışı bırak - MCP'yi kapatır. "Bağlı tüm AI araçlarının erişimi iptal edilecek." mesajıyla onaylarsın. Token'ın silinir ve tüm bağlantılar durur. MCP'yi yeniden etkinleştirirsen yeni bir token alırsın ve giriş yaparak (OAuth) bağlanan uygulamalar yeniden giriş yapmadan çalışır. Bir uygulamayı kalıcı olarak kaldırmak için Bağlı uygulamalar altında Bağlantıyı kes'e dokun.

ipucu

Erişim token'ını gizli tut. Token'a sahip olan herkes TellDone verilerine erişebilir. Sızdığından şüphelenirsen Token'ı Yenile'ye dokun.

Nasıl etkinleştirilir

MCP'yi iki platformdan da yapılandırabilirsin:

iPhone: Ayarlar > Entegrasyonlar > AI Ajanları (MCP)
Web: app.telldone.app > Ayarlar > Entegrasyonlar > AI ajanları (MCP)

Adımlar:

Etkinleştir'e dokun.
Pro ve Ultra'da erişim modunu seç (Salt okunur ya da Okuma ve Yazma). Free ve Basic salt okunurdur.
ChatGPT'yi ya da Claude'u bağlamak için Asistan bağla altında ona dokun ve adımları izle (aşağıya bak). Token gerekmez.
iPhone'da bir kodlama istemcisi için Geliştiriciler için'i aç, Göster'e dokun, Claude Code, Cursor ya da Diğer'i seç ve metnin altındaki Kopyala'ya dokun. Göster'e dokunmadan kopyalarsan metinde token'ın yerine YOUR_TOKEN yazar. Web'de Manuel bearer token kurulumu altında istemcini seç ve metni kopyala; token'ını zaten içerir.
Metni istemcine ya da yapılandırma dosyasına yapıştır.

OAuth ile bağlanma

OAuth, ChatGPT, Claude ve Cowork için önerilen yoldur - token kopyalamak yerine TellDone hesabınla giriş yaparsın.

OAuth için MCP URL'si: https://api.telldone.app/mcp/user

Aynı sunucu https://api.telldone.app/mcp/user/mcp adresinde de yanıt verir ve iki adres de bearer token kabul eder. OAuth ile giriş için ilkini kullan.

ChatGPT

Özel bir MCP sunucusunu chatgpt.com üzerinden ya da ChatGPT masaüstü uygulamasında ekleyebilirsin. ChatGPT mobil uygulaması özel bağlayıcı ekleyemez ve TellDone uygulaması bunu şöyle söyler: "ChatGPT uygulaması bağlayıcıları yalnızca kendi kataloğundan ekler." Talimatları bir bilgisayarda almak için TellDone'da Adımları bilgisayarıma gönder'e dokun. Orada eklendikten sonra TellDone ChatGPT mobil uygulamasında da kullanılabilir.

Uygulamadaki adımlar:

Bilgisayarda chatgpt.com/plugins adresini aç, Add'e tıkla ve Add custom MCP server'ı seç.
Adını TellDone koy, aşağıdaki adresi (https://api.telldone.app/mcp/user) yapıştır ve OAuth'u seç.
Onayla ve yükle, ardından TellDone'da oturum aç ve erişime izin ver.

Menü adları değişirse OpenAI'ın özel MCP sunucuları kılavuzuna bak.

Claude (web sitesi, Desktop, iPhone uygulaması) / Cowork

Uygulamadaki adımlar:

Claude'da Customize → Connectors'ı aç ve Add custom connector'a dokun.
Aşağıdaki adresi (https://api.telldone.app/mcp/user) yapıştır.
TellDone'da oturum aç ve erişime izin ver.

Giriş yaptığında TellDone'un onay sayfası hangi uygulamanın erişim istediğini ve tam olarak hangi izinleri istediğini gösterir. TellDone e-postan ve parolanla giriş yap ve Allow access'e tıkla ya da erişimi aynı adımda onaylayan Sign in with Apple veya Sign in with Google'a dokun. Claude kendiliğinden bağlanır - kopyalanacak token yoktur.

Menü adları değişirse Anthropic'in özel bağlayıcı ekleme kılavuzuna bak.

Bearer token ile bağlanma

Claude Code, Cursor ve yerleşik OAuth girişi olmayan diğer istemciler için erişim token'ını doğrudan istemcinin yapılandırmasına yapıştır. Aşağıdaki tüm örneklerde YOUR_TOKEN yerine ayarlarındaki token'ı yaz.

Claude Code (bearer token)

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

Bunu kendin yazmak zorunda değilsin: Ayarlar > Entegrasyonlar > AI Ajanları (MCP) > Geliştiriciler için bölümünde Göster'e dokun, Claude Code'u seç ve Kopyala'ya dokun. Kopyalanan komut token'ını zaten içerir.

Cursor

.cursor/mcp.json dosyasına ekle (ya da Göster'e dokunduktan sonra Geliştiriciler için > Cursor bölümünden kopyala):

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

Diğer istemciler

Diğer MCP istemcileri için ayarlar:

Codex

codex.json dosyasına ekle:

{
  "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

Diğer MCP istemcileri

HTTP üzerinden MCP'yi destekleyen her araç bağlanabilir. https://api.telldone.app/mcp/user/mcp uç noktasını Bearer YOUR_TOKEN yetkilendirme başlığıyla kullan.

Alternatif auth başlığı

İstemcin ya da proxy'n Authorization başlığını ayırıyorsa (örneğin bazı Smithery tarzı ağ geçitleri) token'ı bunun yerine X-MCP-Token: YOUR_TOKEN ile gönder. İki başlık da çalışır; ikisi birden varsa Authorization önceliklidir.

Bağlantını test etme

Token'ının çalıştığını basit bir cURL komutuyla doğrulayabilirsin:

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

Başarılı bir yanıt tüm kullanılabilir araçları listeler.

İzinler (kapsamlar)

OAuth bağlantıları kapsamlıdır - giriş sırasında istemcinin tam olarak ne istediğini görür ve açıkça onaylarsın.

Kapsam	Uygulamanın şunu yapmasına izin verir...
`notes:read`	Notlarını okur ve not ayrıntılarının tamamını açar (arama aracı ayrıca `tasks:read` ve `events:read` ister)
`notes:write`	Not oluşturur, düzenler ve siler (process_note ayrıca `tasks:write` ve `events:write` ister)
`tasks:read` / `tasks:write`	Görevleri okur / oluşturur, düzenler, tamamlar ve siler
`events:read` / `events:write`	Etkinlikleri okur / oluşturur, düzenler ve siler
`reports:read`	Günlük, haftalık, aylık ve yıllık raporlarını okur
`tags:read` / `tags:write`	Etiketlerini listeler / etiket oluşturur, sabitler, siler ve geri yükler
`profile:read`	Hesap bilgilerini ve aboneliğini okur
`offline_access`	Oturumu açık tutar (her oturumda yeniden giriş yapmaman için bir yenileme token'ı verir)

Kapsamlar bir bağlantının neler yapabileceğini sınırlar: yalnızca notes:read olan bir bağlantı yazma aracını çağıramaz. Planın bunun üstüne ikinci bir sınır koyar.

Bearer token bağlantıları tek tek kapsamlandırılmaz - yalnızca planının okuma/yazma moduyla yönetilir.

Neler yapabilirsin

Okuma araçları (10) - tüm planlar

Araç	Ne yapar
get_notes	Notları filtrelerle listeler (etiketler, tarih aralığı, metin araması)
get_note	Tek bir notu bağlı görevleri, etkinlikleri ve tam transkriptiyle gösterir
get_notes_full	Birden fazla notu gömülü görevleri ve etkinlikleriyle tek çağrıda alır
get_tasks	Görevleri duruma (yapılacak, tamamlandı, hepsi), etiketlere veya tarihlere göre filtreleyerek listeler
get_events	Takvim etkinliklerini listeler, tarih aralığına göre filtreler
get_reports	Günlük, haftalık, aylık ve yıllık raporlarını okur (tam markdown)
get_tags	Tüm etiketlerini kullanıma göre sıralı gösterir
get_profile	Hesap bilgilerini ve kaç notun, görevin ve etkinliğin olduğunu gösterir
search	Notlar, görevler ve etkinliklerde arar (notlar için metin + anlamsal arama)
get_change_log	Bir notun, görevin ya da etkinliğin düzenleme geçmişini ve her düzenlemenin geri alınıp alınmadığını gösterir

ipucu

search aracı notlar için anlamsal aramayı destekler - yalnızca anahtar kelimelerle değil, anlama göre sonuç bulur. Örneğin "bütçe toplantıları" aramak, "bütçe" kelimesini içermese bile mali tartışmalar hakkındaki notları bulur.

Yazma araçları (17) - Pro ve Ultra

Araç	Ne yapar
process_note	Tam AI hattı - metin ya da ses gönder, görevleri, etkinlikleri ve etiketleriyle bir not geri al
create_note	Düz metin notu ekler (AI analizi yok)
create_task	Öncelik, son tarih, hatırlatma ve etiketlerle görev ekler
create_event	Tarih, saat, konum, hatırlatmalar, katılımcılar ve tekrar kuralıyla takvim etkinliği ekler
update_note	Notun başlığını, özetini, türünü, etiketlerini, önceliğini veya durumunu değiştirir
update_task	Görevin başlığını, açıklamasını, önceliğini, son tarihini, hatırlatmasını, etiketlerini veya durumunu değiştirir
complete_task	Bir görevi tamamlandı olarak işaretler
update_event	Etkinliğin ayrıntılarını, saatini, konumunu, hatırlatmalarını, katılımcılarını, tekrar kuralını, etiketlerini veya durumunu değiştirir
delete_note	Bir notu siler. Notun görevleri ve etkinlikleri kalır
delete_task	Bir görevi siler
delete_event	Bir etkinliği siler
undo_change_log_entry	İzlenen tek bir düzenlemeyi geri alır - AI'ın ya da senin yaptığın - alanın önceki değerini geri getirir
restore_entity	Silinmiş veya arşivlenmiş bir notu ya da görevi, silinmiş veya iptal edilmiş bir etkinliği geri getirir
create_tag	Yeni bir etiket oluşturur ya da otomatik önerilen bir etiketi kalıcı yapar
set_tag_pinned	Bir etiketi en üstte sıralanması için sabitler ya da sabitlemesini kaldırır
delete_tag	Bir etiketi kaldırır (restore_tag ile geri getirilebilir)
restore_tag	Silinmiş bir etiketi geri getirir

Tüm yazma ve silme işlemleri bağlı cihazlarında (telefon, web uygulaması) hemen görünür.

Araç referansı

get_notes

Notları isteğe bağlı filtrelemeyle listele. Tarih filtreleri recorded_at değerini (sesli notu kaydettiğin zaman) kullanır; kaydı olmayan bir not için created_at kullanılır.

Parametre	Tür	Varsayılan	Açıklama
`limit`	int	20	Döndürülecek not sayısı (en fazla 50)
`offset`	int	0	Bu kadar notu atla (sayfalama için, en fazla 10000)
`tags`	string	-	Etiketlere göre filtrele, virgülle ayrılmış (herhangi biriyle eşleşir)
`search`	string	-	Başlık ve özette metin araması
`date_from`	string	-	Başlangıç tarihi, YYYY-MM-DD (dahil)
`date_to`	string	-	Bitiş tarihi, YYYY-MM-DD (hariç)
`standalone_only`	bool	false	true olduğunda devam kaydı notlarını (bir üst nota/göreve/etkinliğe bağlı notlar) gizler ve yalnızca bağımsız notları döndürür

Döndürür: id, title, summary, type, tags, priority, status, recorded_at, created_at içeren not listesi.

get_note

Tam transkripti ve bağlı tüm görevleri ve etkinlikleriyle tek bir not al.

Parametre	Tür	Açıklama
`note_id`	string	Notun UUID'si

Döndürür: title, summary, transcript, type, tags, priority, status, metadata, created_at ile ayrıca tasks[] ve events[] dizilerini içeren not.

Ayrıca transcript_speakers (konuşmacı etiketli transkript bölümleri, birden fazla konuşmacılı toplantılar için - aksi halde null), speaker_count (kayıt konuşmacıya göre bölünmediyse null) ve parent_note_id/parent_task_id/parent_event_id (bu not başka bir öğenin devam kaydı düzenlemesiyse ayarlanır) döndürür. Her tasks[]/events[] girişi ayrıca reminders_at/recurrence_rule (görevler) veya reminder_minutes/attendees/recurrence_rule (etkinlikler) içerir.

get_notes_full

Birden fazla notu görevleri ve etkinlikleriyle tek çağrıda al. search dışında get_notes ile aynı filtreler geçerlidir ve her not gömülü tasks[] ve events[] içerir.

Parametre	Tür	Varsayılan	Açıklama
`limit`	int	10	Not sayısı (en fazla 20)
`offset`	int	0	Bu kadar notu atla
`tags`	string	-	Etiketlere göre filtrele
`date_from`	string	-	Başlangıç tarihi, YYYY-MM-DD
`date_to`	string	-	Bitiş tarihi, YYYY-MM-DD
`standalone_only`	bool	false	true olduğunda devam kaydı notlarını (bir üst nota/göreve/etkinliğe bağlı notlar) gizler ve yalnızca bağımsız notları döndürür

get_tasks

Görevleri filtrelemeyle listele.

Parametre	Tür	Varsayılan	Açıklama
`status`	string	"todo"	Filtre: `todo`, `done` veya `all`
`limit`	int	30	Görev sayısı (en fazla 100)
`offset`	int	0	Bu kadar görevi atla
`tags`	string	-	Etiketlere göre filtrele, virgülle ayrılmış
`date_from`	string	-	Başlangıç tarihi, YYYY-MM-DD (son tarihe göre filtreler; son tarihi olmayan görevler dışarıda kalır)
`date_to`	string	-	Bitiş tarihi, YYYY-MM-DD (son tarihe göre filtreler; son tarihi olmayan görevler dışarıda kalır)

Döndürür: id, title, description, status, priority, tags, deadline, reminder_at, reminders_at, completed_at, completed_by, source, created_at içeren görev listesi. reminder_at, geriye dönük uyumluluk için reminders_at içindeki ilk girişi yansıtır - bir görevin tüm hatırlatmalarını görmek için reminders_at kullan.

get_events

Takvim etkinliklerini tarih aralığı filtrelemesiyle listele.

Parametre	Tür	Varsayılan	Açıklama
`limit`	int	30	Etkinlik sayısı (en fazla 100)
`offset`	int	0	Bu kadar etkinliği atla
`date_from`	string	-	İlk gün, YYYY-MM-DD, kendi saat diliminde (dahil). Aralıkla örtüşen etkinlikler dahil edilir, bu yüzden birkaç gün süren bir etkinlik kapsadığı her günde görünür
`date_to`	string	-	Son gün, YYYY-MM-DD, kendi saat diliminde (dahil)

Döndürür: id, title, description, status, start_at, end_at, location, is_all_day, tags, note_id, reminder_minutes, attendees, recurrence_rule, created_at içeren etkinlik listesi.

get_reports

AI tarafından oluşturulan raporlarını tam markdown içeriğiyle al.

Parametre	Tür	Varsayılan	Açıklama
`report_type`	string	"daily"	Tür: `daily`, `weekly`, `monthly` veya `yearly`
`limit`	int	5	Rapor sayısı (en fazla 10)

Döndürür: id, type, period_start, period_end, content_md, created_at içeren rapor listesi.

not

Aylık raporlar uzundur (çoğu zaman 1.000 kelimenin çok üzerinde). AI aracının bağlam penceresi dar ise limit=1 kullan.

get_tags

Tüm etiketlerini önce sabitlenenler, sonra kullanım sayısı sırasıyla al.

Parametre yok. En fazla 100 etiket döndürür; her biri tag, usage_count, is_pinned, is_manual içerir.

get_profile

Hesap bilgilerini ve kaç notun, görevin ve etkinliğin olduğunu al.

Parametre yok. email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at ve stats (not/görev/etkinlik sayıları) döndürür.

search

Notlarda, görevlerde ve etkinliklerde aynı anda ara. Notlar için hem metin aramasını hem de anlamsal aramayı (AI gömmeleriyle anlama göre sonuç bulur) destekler.

Parametre	Tür	Varsayılan	Açıklama
`query`	string	zorunlu	Arama metni (en fazla 500 karakter)
`limit`	int	20	Tür başına en fazla sonuç (en fazla 20)
`semantic`	bool	true	Notlar için anlamsal aramayı etkinleştir

Sonuçları türe göre gruplanmış döndürür: notes[], tasks[], events[]. Her sonuç id, type, title, detail, created_at içerir.

Daha hızlı, yalnızca metin araması için semantic=false ayarla.

get_change_log

Bir notun, görevin ya da etkinliğin düzenleme geçmişini gör - AI'ın devam kaydıyla yaptığı her düzenleme ve senin yaptığın her elle düzenleme, en yeniden eskiye.

Parametre	Tür	Varsayılan	Açıklama
`entity`	string	zorunlu	`notes`, `tasks` veya `events`
`entity_id`	string	zorunlu	Öğenin UUID'si
`include_manual`	bool	false	Yalnızca AI'ın yaptıklarını değil, kendi elle düzenlemelerini de dahil et

Döndürür: id (geri alma için entry_id olarak kullan), field_name, old_value, new_value, source (follow_up, smart_context, TellDone'un bir not boyunca taşıdığı bir isim düzeltmesi için correction_sync veya manual), origin_note_id, edited_at ve reverted_at (geri alındığında ayarlanır) içeren değişiklik girişi listesi.

process_note (Pro ve Ultra)

Tam AI hattı - uygulamada kayıt yapmakla aynı şekilde çalışır. Metin ya da ses gönder; TellDone yazıya döker, AI ile analiz eder ve çıkarılan görevler, etkinlikler, etiketler ve gömmelerle yapılandırılmış bir not oluşturur.

Bu araç asenkrondur: hemen bir audio_id ile döner ve arka planda işler. Sonuçlar bağlı cihazlarına gerçek zamanlı eşitlemeyle gelir ya da get_notes() ile sorgulayabilirsin.

Parametre	Tür	Açıklama
`text`	string	Zorunlu. Analiz edilecek metin. Boş değilse transkript olarak kullanılır ve gönderdiğin ses yazıya dökülmez; sesin yazıya dökülmesi için `""` gönder. Ses gönderilmediğinde sınır: Pro 20.000 / Ultra 50.000 karakter
`audio_base64`	string	Base64 kodlu ses dosyası. Tüm istek 10 MB ile sınırlıdır, yani ses yaklaşık 7 MB olabilir. Yalnızca `text` boşsa yazıya dökülür
`audio_format`	string	`m4a`, `ogg`, `wav`, `mp3`, `aac` veya `webm` (varsayılan: m4a)
`parent_task_id`	string	Bunun devam kaydı olduğu görevin UUID'si
`parent_note_id`	string	Bunun devam kaydı olduğu notun UUID'si
`parent_event_id`	string	Bunun devam kaydı olduğu etkinliğin UUID'si

Her zaman text gönder. TellDone'un sesi yazıya dökmesi için audio_base64 ile birlikte text değerini boş bir metin ("") olarak gönder. text boş değilse TellDone onu transkript olarak kullanır ve sesi yazıya dökmez. Üst öğe kimliklerinden en fazla birini ayarla.

Döndürür: {"audio_id": "...", "status": "processing", "mode": "text-only"} ya da ses sağlandıysa "mode": "audio+stt".

not

process_note, planının kotalarına tabidir (günlük yükleme, aylık not sayısı, en fazla metin uzunluğu). get_profile yalnızca kaç notun, görevin ve etkinliğin olduğunu gösterir, sınırlarını göstermez. Kullanımını uygulamada Ayarlar > Kullanım bölümünden kontrol et.

create_note (Pro ve Ultra)

Anında düz metin notu oluştur. AI analizini tetiklemez - görev ya da etkinlik çıkarılmaz. TellDone'un senin için görev ve etkinlik bulmasını istiyorsan process_note kullan.

Parametre	Tür	Sınır	Açıklama
`title`	string	200 karakter	Zorunlu
`summary`	string	1000 karakter	İsteğe bağlı. Kısa özet (1-3 cümle). Raporlarında kullanılır, bu yüzden kısa tut
`transcript`	string	plana bağlı	İsteğe bağlı. Not ayrıntısında gösterilen uzun gövde. Raporlara dahil edilmez. Sınırlar: Pro 20.000 / Ultra 50.000 karakter
`type`	string	-	İsteğe bağlı. `task`, `idea`, `info` (varsayılan), `status`, `meeting`, `event` veya `reflection`
`tags`	string	20 etiket	Virgülle ayrılmış, isteğe bağlı
`suppress_external_sync`	boolean	-	İsteğe bağlı, varsayılan false. İçe aktarılan ya da toplu eklenen öğeler için true yap: öğe o zaman bağlı uygulamalarına ya da otomasyonlarına gönderilmez

create_task (Pro ve Ultra)

Yeni bir görev oluştur. Görev, bağlı Todoist, Notion ya da Microsoft To Do hesabında da oluşturulur ve otomasyonların task.created alır. suppress_external_sync: true verdiğinde bu olmaz.

Parametre	Tür	Sınır	Açıklama
`title`	string	200 karakter	Zorunlu
`description`	string	2000 karakter	İsteğe bağlı
`priority`	string	-	`low`, `medium` (varsayılan) veya `high`
`deadline`	string	-	YYYY-MM-DD, isteğe bağlı
`reminder_at`	string	-	ISO 8601 tarih-saat (örneğin `2026-04-15T09:00:00Z`), isteğe bağlı
`tags`	string	20 etiket	Virgülle ayrılmış, isteğe bağlı
`note_id`	string	-	Görevi bir üst nota bağlamak için UUID, isteğe bağlı
`suppress_external_sync`	boolean	-	İsteğe bağlı, varsayılan false. İçe aktarılan ya da toplu eklenen öğeler için true yap: öğe o zaman bağlı uygulamalarına ya da otomasyonlarına gönderilmez

create_event (Pro ve Ultra)

Takvim etkinliği oluştur. Etkinlik, bağlı Notion hesabında da oluşturulur ve otomasyonların calendar_event.created alır. suppress_external_sync: true verdiğinde bu olmaz.

Parametre	Tür	Sınır	Açıklama
`title`	string	200 karakter	Zorunlu
`start_at`	string	-	ISO 8601 tarih-saat, zorunlu
`end_at`	string	-	ISO 8601 tarih-saat (varsayılan: başlangıç + 1 saat; tüm gün süren etkinlikte bir gün)
`description`	string	2000 karakter	İsteğe bağlı
`location`	string	200 karakter	İsteğe bağlı
`is_all_day`	bool	-	Varsayılan: false
`tags`	string	20 etiket	Virgülle ayrılmış, isteğe bağlı
`reminder_minutes`	string	-	Etkinlikten önceki dakikalar, virgülle ayrılmış (örneğin `15,60`), isteğe bağlı
`attendees`	string	-	Virgülle ayrılmış isimler ya da e-postalar, isteğe bağlı
`recurrence_rule`	string	-	RRULE metni (örneğin `FREQ=WEEKLY;BYDAY=MO,WE,FR`), isteğe bağlı. Saatlikten daha sık olan ya da hiç gerçekleşemeyen kurallar reddedilir
`note_id`	string	-	Etkinliği bir üst nota bağlamak için UUID, isteğe bağlı
`suppress_external_sync`	boolean	-	İsteğe bağlı, varsayılan false. İçe aktarılan ya da toplu eklenen öğeler için true yap: öğe o zaman bağlı uygulamalarına ya da otomasyonlarına gönderilmez

update_note (Pro ve Ultra)

Mevcut bir notun bir ya da daha fazla alanını güncelle. Yalnızca verdiğin alanlar değişir. Bu, notu uygulamada düzenlemekle tamamen aynı şekilde çalışır: başlığı, özeti, etiketleri ve türü Notion sayfasına ulaşır, otomasyonların note.updated alır ve düzenleme, geri alınabileceği değişiklik geçmişinde görünür. Transkript değişikliği de kaydedilir ve Notion'a gönderilir, ancak geçmişte yer almaz.

Parametre	Tür	Açıklama
`note_id`	string	Zorunlu, notun UUID'si
`title`	string	Yeni başlık (en fazla 200 karakter)
`summary`	string	Yeni özet (en fazla 1000 karakter, temizlemek için bir boşluk `" "` ver)
`transcript`	string	Yeni transkript (plana bağlı sınır, temizlemek için bir boşluk `" "` ver)
`type`	string	`task`, `idea`, `info`, `status`, `meeting`, `event` veya `reflection`
`tags`	string	Virgülle ayrılmış etiketler (mevcut tüm etiketlerin yerine geçer, en fazla 20)
`priority`	string	`low`, `medium` veya `high`
`status`	string	`active` veya `archived`

uyarı

Ses hattıyla oluşturulan notlarda transcript, konuşmanın yazıya dökülmüş özgün halidir. Üzerine yazmak özgün sözlerinin yerine geçer. Onları korumak için transkriptin yerine geçmek yerine ona ekleme yap.

update_task (Pro ve Ultra)

Mevcut bir görevin bir ya da daha fazla alanını güncelle. Yalnızca verdiğin alanlar değişir. Bu, görevi uygulamada düzenlemekle tamamen aynı şekilde çalışır: değişiklik görevin Todoist, Notion ve Microsoft To Do'daki kopyalarına ulaşır, otomasyonların task.updated alır ve düzenleme, geri alınabileceği görev geçmişinde görünür. status değerini done yapmak görevi complete_task gibi tamamlar. Son tarih bir tarih ya da tam bir tarih ve saat olabilir (tarihi kullanılır). Her etiket en fazla 50 karakter olabilir.

Parametre	Tür	Açıklama
`task_id`	string	Zorunlu, görevin UUID'si
`title`	string	Yeni başlık
`description`	string	Yeni açıklama (temizlemek için bir boşluk `" "` ver)
`priority`	string	`low`, `medium` veya `high`
`deadline`	string	YYYY-MM-DD. Bu araç son tarihi temizleyemez; uygulamada temizle
`status`	string	`todo` veya `done`
`tags`	string	Virgülle ayrılmış etiketler (mevcut tüm etiketlerin yerine geçer, en fazla 20)
`reminder_at`	string	ISO 8601 tarih-saat (temizlemek için bir boşluk ver)

status değerini done yapmak, görevin ne zaman ve nasıl tamamlandığını da kaydeder.

complete_task (Pro ve Ultra)

Bir görevi tamamlandı olarak işaretlemenin kısayolu.

Parametre	Tür	Açıklama
`task_id`	string	Zorunlu, görevin UUID'si

Görev yoksa ya da zaten tamamlanmışsa hata döndürür.

update_event (Pro ve Ultra)

Mevcut bir etkinliğin bir ya da daha fazla alanını güncelle. Yalnızca verdiğin alanlar değişir. Bu, etkinliği uygulamada düzenlemekle tamamen aynı şekilde çalışır: değişiklik Notion sayfasına ulaşır, otomasyonların calendar_event.updated alır ve düzenleme, geri alınabileceği değişiklik geçmişinde görünür.

Parametre	Tür	Açıklama
`event_id`	string	Zorunlu, etkinliğin UUID'si
`title`	string	Yeni başlık
`description`	string	Yeni açıklama (temizlemek için bir boşluk ver)
`start_at`	string	Yeni başlangıç zamanı (ISO 8601)
`end_at`	string	Yeni bitiş zamanı (ISO 8601)
`location`	string	Yeni konum (temizlemek için bir boşluk ver)
`status`	string	`confirmed`, `tentative` veya `cancelled`
`tags`	string	Virgülle ayrılmış etiketler (mevcut tüm etiketlerin yerine geçer, en fazla 20)
`is_all_day`	string	`"true"` veya `"false"`
`reminder_minutes`	string	Etkinlikten önceki dakikalar, virgülle ayrılmış (örneğin `15,60`, temizlemek için bir boşluk ver)
`attendees`	string	Virgülle ayrılmış isimler ya da e-postalar (temizlemek için bir boşluk ver)
`recurrence_rule`	string	RRULE metni (temizlemek için bir boşluk ver)

delete_note (Pro ve Ultra)

Bir notu sil. Yalnızca not silinir: görevleri ve etkinlikleri kalır. Bu, notu uygulamada silmekle tamamen aynı şekilde çalışır: otomasyonların note.deleted alır. Notun Notion'daki kopyası kaldırılmaz (uygulama da onu kaldırmaz).

Parametre	Tür	Açıklama
`note_id`	string	Zorunlu, notun UUID'si

delete_task (Pro ve Ultra)

Bir görevi sil. Bu, görevi uygulamada silmekle tamamen aynı şekilde çalışır: Todoist, Notion ve Microsoft To Do'daki kopyaları da silinir ve otomasyonların task.deleted alır. Görevi restore_entity ile geri getirebilirsin.

Parametre	Tür	Açıklama
`task_id`	string	Zorunlu, görevin UUID'si

delete_event (Pro ve Ultra)

Bir etkinliği sil. Bu, etkinliği uygulamada silmekle tamamen aynı şekilde çalışır: otomasyonların calendar_event.deleted alır. Etkinliğin Notion'daki sayfası kaldırılmaz (uygulama da onu kaldırmaz).

Parametre	Tür	Açıklama
`event_id`	string	Zorunlu, etkinliğin UUID'si

undo_change_log_entry (Pro ve Ultra)

İzlenen tek bir düzenlemeyi geri al - alanı o düzenlemeden önceki değerine döndürür; düzenlemeyi AI (bir devam kaydından) ya da sen doğrudan yapmış olsan da.

Parametre	Tür	Açıklama
`entity`	string	Zorunlu, `notes`, `tasks` veya `events`
`entity_id`	string	Zorunlu, öğenin UUID'si
`entry_id`	string	Zorunlu, `get_change_log` içindeki değişiklik girişinin `id` değeri

Döndürür: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Aynı girişi iki kez geri almak hata döndürür - zaten geri alınmıştır.

restore_entity (Pro ve Ultra)

Silinmiş veya arşivlenmiş bir notu ya da görevi, silinmiş veya iptal edilmiş bir etkinliği geri getir.

Parametre	Tür	Açıklama
`entity`	string	Zorunlu, `notes`, `tasks` veya `events`
`entity_id`	string	Zorunlu, öğenin UUID'si

Döndürür: geri yüklenen öğe, JSON olarak.

create_tag (Pro ve Ultra)

Yeni bir etiket oluştur ya da mevcut, otomatik önerilen bir etiketi kalıcı yap.

Parametre	Tür	Açıklama
`tag`	string	Zorunlu, 1-50 karakter (küçük harfle saklanır)
`category`	string	İsteğe bağlı

set_tag_pinned (Pro ve Ultra)

Bir etiketi etiket listenin en üstünde sıralanması için sabitle ya da sabitlemesini kaldır.

Parametre	Tür	Açıklama
`tag`	string	Zorunlu
`pinned`	bool	Zorunlu

İçinde / karakteri olan etiketler sabitlenemez.

delete_tag (Pro ve Ultra)

Bir etiketi kaldır. restore_tag ile geri getirilebilir.

Parametre	Tür	Açıklama
`tag`	string	Zorunlu

restore_tag (Pro ve Ultra)

Silinmiş bir etiketi geri getir.

Parametre	Tür	Açıklama
`tag`	string	Zorunlu

Giriş limitleri

Alan	En fazla uzunluk	Kullanıldığı yer
title	200 karakter	not, görev, etkinlik oluşturma/güncelleme
description	2.000 karakter	görev, etkinlik oluşturma/güncelleme
summary	1.000 karakter (kesin)	not oluşturma/güncelleme. Raporlarında kullanılır, bu yüzden kısa tut
transcript	plana bağlı: Pro 20.000 / Ultra 50.000	not oluşturma/güncelleme. Uzun gövde, raporlarda yok
text	plana bağlı: Pro 20.000 / Ultra 50.000 (ses gönderilmediğinde)	process_note
location	200 karakter	etkinlik oluşturma/güncelleme
tags	20 etiket	not, görev, etkinlik oluşturma/güncelleme
search query	500 karakter	search
audio_base64	yaklaşık 7 MB ses (tüm istek 10 MB ile sınırlıdır)	process_note

Bir sınırı aşarsan araç "title too long (max 200 chars, got 250)" gibi bir hata mesajı döndürür.

Hata yönetimi

Çoğu araç hataları JSON olarak döndürür:

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

Plan, kapsam ve giriş sınırı hataları aynı mesajla bir araç hatası olarak gelir.

Sık görülen hatalar:

Hata	Ne zaman
`"This TellDone connection is read-only. Creating and editing needs the Pro or Ultra plan."`	Salt okunur modda yazma aracı çağrıldı (Free ve Basic ya da salt okunura geçirilmiş Pro ve Ultra)
`"Daily limit reached: the Free plan includes 100 TellDone requests a day..."`	Free plan günün 100 isteğini bitirdi
`"Daily limit reached (N/M today)"`	Bugün AI asistanları aracılığıyla planının izin verdiği kadar öğe oluşturdun (process_note, create_note, create_task ve create_event'in her biri sayılır)
`"Notes limit reached (X/Y this month)"`	Planının aylık not sınırı doldu
`"Invalid note_id format"`	Kimlik olarak UUID olmayan bir metin verildi
`"Note not found"`	Kimlik mevcut değil ya da başka bir kullanıcıya ait
`"Task not found or already completed"`	Var olmayan ya da zaten tamamlanmış bir görevde `complete_task`
`"title too long (max 200 chars, got N)"`	Giriş sınırı aşıldı
`"Too many tags (max 20)"`	20'den fazla etiket verildi

HTTP düzeyindeki hatalar:

Kod	Anlamı
401	Geçersiz, iptal edilmiş ya da silinmiş token (MCP'yi devre dışı bırakmak token'ını siler, yenilemek onun yerine yenisini koyar)
429	İstek sınırı aşıldı (5 istek/sn, 20'ye kadar ani artış)

Free'de günde 100 istek sınırına ulaşmak bir HTTP kodu olarak değil, araç hata mesajı olarak bildirilir ve hesabında kayıtlı saat diliminde gece yarısı sıfırlanır.

Kullanım örnekleri

Tüm örnekler MCP JSON-RPC protokolüyle cURL kullanır. YOUR_TOKEN yerine erişim token'ını yaz.

Veri okuma

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

Veri yazma (Pro ve 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>"}}}'

Başarılı bir yanıt şöyle görünür:

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

not

Yazma ve güncelleme araçları kısa yanıtlar döndürür; çoğunlukla id, title ve status. Silme araçları id ve deleted döndürür. Yazmadan sonra tüm ayrıntıları (etiketler, öncelik, son tarih vb.) almak için get_tasks ya da get_note gibi bir okuma çağrısı yap.

Token yönetimi

Eylem	Nasıl
Token'ı görüntüle	iPhone'da Ayarlar > Entegrasyonlar > AI Ajanları (MCP) > Geliştiriciler için (web'de Ayarlar > Entegrasyonlar > AI ajanları (MCP)), Göster'e dokun
Token'ı kopyala	Token'ın yanındaki Kopyala'ya dokun
Yenile	Token'ı Yenile'ye dokun ve onayla. Eski token hemen çalışmayı bırakır. OAuth ile giriş yaparak bağlanan asistanlar etkilenmez; onların bağlantısını Bağlı uygulamalar altında kes
Modu değiştir	Pro ve Ultra: Salt okunur ya da Okuma ve Yazma'yı seç. Free ve Basic her zaman Salt okunurdur
Devre dışı bırak	Devre dışı bırak'a dokun ve onayla ("Bağlı tüm AI araçlarının erişimi iptal edilecek."). Token'ın silinir ve tüm bağlantılar durur. MCP'yi yeniden etkinleştirirsen yeni bir token alırsın ve giriş yaparak (OAuth) bağlanan uygulamalar yeniden giriş yapmadan çalışır. Bir uygulamayı kalıcı olarak kaldırmak için Bağlı uygulamalar altında Bağlantıyı kes'e dokun

AI ajanına neler sorabilirsin

Bağlandıktan sonra AI aracına şunlar gibi şeyler sorabilirsin:

Gününü gözden geçir:

"Bugün ne üzerinde çalıştım?"
"Bu haftaki notlarımı göster"
"Hangi görevlerin tarihi geçti?"

Görevleri yönet:

"Bir görev oluştur: üç aylık raporu incele, yüksek öncelik, son tarih cuma"
"Figma görevini tamamlandı olarak işaretle"
"Şu anda hangi görevler üzerinde çalışıyorum?"

Ara ve analiz et:

"Pazarlama stratejisi hakkındaki tüm notları bul"
"Gelecek hafta hangi etkinliklerim var?"
"Geçen haftaki günlük raporlarımı özetle"

İleriyi planla:

"Bir etkinlik oluştur: yarın sabah 10'da ekip toplantısı"
"Bu hafta takvimimde ne var?"
"En çok kullandığım etiketleri göster - en çok zamanımı neye harcıyorum?"

Asistanın notlarını, görevlerini, etkinliklerini ve raporlarını okuyabilir, birkaç araçtan gelen bilgiyi birleştirerek karmaşık sorulara yanıt verebilir. Okuma ve Yazma açık olan Pro ve Ultra'da bunları oluşturabilir, güncelleyebilir ve silebilir de.

Bilmen gerekenler

Entegrasyonlar ve otomasyonlar - process_note bir kayıt gibi çalışır, bu yüzden not, görevler ve etkinlikler bağlı entegrasyonlarına ve webhook otomasyonlarına da gider. Diğer yazma araçlarıyla oluşturduğun, düzenlediğin ya da sildiğin öğeler tamamen uygulamadaki gibi davranır: bağlı entegrasyonlarına (etkinlikler ve not düzenlemeleri yalnızca Notion'a) ve otomasyonlarına ulaşır. Bir görevi restore_entity ile geri yüklemek ya da tamamlanmasını undo_change_log_entry ile geri almak, görevi eşitlendiği entegrasyonlarda da yeniden açar.
AI asistanının yaptığı düzenlemeler - öğenin değişiklik geçmişinde bir asistan tarafından yapılmış olarak işaretlenir. TellDone'ın konuşma tanımasını eğitmek için kullanılmaz ve notun diğer öğelerine kopyalanmaz. Asistan üzerinden yapılan düzenlemeler, uygulamanın dakikada 30 düzenlemelik sınırını paylaşır.
Anlamsal arama - process_note ya da create_note ile oluşturulan notların ikisi de gömme alır, bu yüzden kısa bir gecikmeyle anlamsal aramada görünürler.
Tarih filtreleri - notlarda tarihler UTC günleridir. Etkinliklerde tarihler kendi yerel günlerindir ve aralıkla örtüşen bir etkinlik dahil edilir. Görevlerde filtre son tarihtir.

Güvenlik

Her kullanıcı benzersiz bir 384 bitlik erişim token'ı alır
MCP'yi devre dışı bıraktığında ya da token'ı yenilediğinde token'ın anında iptal edilir
Her istek hesabınla sınırlıdır, bu yüzden ajanın yalnızca kendi verilerine erişebilir
Bağlantı, istek sınırlamasıyla HTTPS kullanır (5 istek/sn, 20'ye kadar ani artış)
OAuth bağlantıları PKCE, tek kullanımlık yetkilendirme kodları ve kısa ömürlü erişim token'ları kullanır - bir bağlantıyı istediğin zaman uygulamadan iptal edebilirsin

Teknik ayrıntılar için - keşif uç noktaları, token ömürleri, tam OAuth akışı - github.com/exp78/telldone-mcp adresindeki açık kaynaklı bağlayıcı referansımıza bak ya da https://api.telldone.app/.well-known/oauth-protected-resource adresini doğrudan sorgula.

Gizlilik ve veri akışı

Bağlı bir AI aracı verilerini yalnızca TellDone'u çağırdığında, genellikle ona bir şey sorduğun için alır. Yalnızca bu çağrıların yanıtlarını, onayladığın izinler dahilinde alır. Erişimi sınırlamak için Salt okunur'a geç, uygulamanın bağlantısını Bağlı uygulamalar altında kes ya da Ayarlar'da erişim token'ını yenile veya devre dışı bırak. Tüm ayrıntılar için Gizlilik Politikası sayfasına bak ya da sorularınla support@telldone.app adresine yaz.

Sorun giderme

Belirti	Neden / çözüm
OAuth onay sayfası "Wrong email or password" diyor	Uygulamaya giriş yaptığın e-posta ve parolayı kullan ya da aynı sayfada Sign in with Apple / Sign in with Google'ı seç.
Bağlandı, ama AI hiçbir şey oluşturamıyor ya da düzenleyemiyor	Planın Free ya da Basic (salt okunur), modun salt okunur ya da bağlantının yazma izni yok. Planını yükseltmeden önce bağlandıysan uygulamanın bağlantısını Bağlı uygulamalar altında kes ve yeniden bağla. Modunu Ayarlar'dan kontrol edebilirsin.
Bir araçtan "Insufficient scope" hatası	Bağlantının o izni yok. Free ve Basic'te yazma izinleri hiçbir zaman verilmez, bu yüzden oluşturma ve düzenleme Pro ya da Ultra gerektirir. Planını yükseltmeden önce bağlandıysan uygulamanın bağlantısını Bağlı uygulamalar altında kes ve yeniden bağla.
Kopyalanan metinde `YOUR_TOKEN` yazıyor ve istemci bağlanamıyor	Token gizliyken kopyaladın. Geliştiriciler için bölümünde Göster'e dokun, sonra metni yeniden kopyala.
Araçlar hiç görünmüyor	MCP hesabında etkin değil (Ayarlar > Entegrasyonlar > AI Ajanları (MCP) > Etkinleştir).
"Daily limit reached"	Bu mesajı iki sınır kullanır. "Daily limit reached: the Free plan includes 100 TellDone requests a day" Free'nin istek sınırıdır. "Daily limit reached (N/M today)" ise bugün AI asistanları aracılığıyla planının izin verdiği kadar öğe oluşturduğun anlamına gelir: process_note, create_note, create_task ve create_event'in her biri sayılır, Pro ve Ultra'da da. İkisi de hesabında kayıtlı saat diliminde gece yarısı sıfırlanır.
İstemcim yalnızca bir bağlayıcı listesinden seçim yapmama izin veriyor ve TellDone listede yok	TellDone henüz hiçbir istemcinin bağlayıcı dizininde yok - MCP URL'siyle özel bir bağlayıcı olarak ekle ya da bearer token yöntemini kullan.

Ayrıca bak

Webhook otomasyonları - verileri harici hizmetlere otomatik gönder
Todoist - özel iki yönlü görev eşitlemesi
Notion - özel Notion entegrasyonu

Bağlanmanın iki yolu​

Plan gereksinimleri​

Uygulama içi ekran​

Nasıl etkinleştirilir​

OAuth ile bağlanma​

ChatGPT​

Claude (web sitesi, Desktop, iPhone uygulaması) / Cowork​

Bearer token ile bağlanma​

Claude Code (bearer token)​

Cursor​

Diğer istemciler​

Codex​

OpenClaw​

Diğer MCP istemcileri​

Bağlantını test etme​

İzinler (kapsamlar)​

Neler yapabilirsin​

Okuma araçları (10) - tüm planlar​

Yazma araçları (17) - Pro ve Ultra​

Araç referansı​

get_notes​

get_note​

get_notes_full​

get_tasks​

get_events​

get_reports​

get_tags​

get_profile​

search​

get_change_log​

process_note (Pro ve Ultra)​

create_note (Pro ve Ultra)​

create_task (Pro ve Ultra)​

create_event (Pro ve Ultra)​

update_note (Pro ve Ultra)​

update_task (Pro ve Ultra)​

complete_task (Pro ve Ultra)​

update_event (Pro ve Ultra)​

delete_note (Pro ve Ultra)​

delete_task (Pro ve Ultra)​

delete_event (Pro ve Ultra)​

undo_change_log_entry (Pro ve Ultra)​

restore_entity (Pro ve Ultra)​

create_tag (Pro ve Ultra)​

set_tag_pinned (Pro ve Ultra)​

delete_tag (Pro ve Ultra)​

restore_tag (Pro ve Ultra)​

Giriş limitleri​

Hata yönetimi​

Kullanım örnekleri​

Veri okuma​

Veri yazma (Pro ve Ultra)​

Token yönetimi​

AI ajanına neler sorabilirsin​

Bilmen gerekenler​

Güvenlik​

Gizlilik ve veri akışı​

Sorun giderme​

Ayrıca bak​