MCP Erişimi (AI ajanları)

Son zamanlarda neler değişti

MCP artık iPhone'da (web uygulamasına ek olarak) tamamen mevcut. iPhone ekranı web ekranını yansıtır ve tüm desteklenen AI istemcileri için aynı kurulum parçacıklarını içerir.

Pro plan ve üstü

MCP Erişimi Pro veya Ultra plan gerektirir. Her iki plan da tam okuma + yazma erişimi alır (20 araç). Ultra'nın daha yüksek kotaları vardır ve sadece okuma moduna da geçebilir.

MCP (Model Context Protocol), AI kodlama asistanlarını ve otomasyon araçlarını doğrudan TellDone verilerine bağlamana izin verir. Bağlandıktan sonra, AI ajanın notlarını, görevlerini, etkinliklerini ve raporlarını okuyabilir - ve öğeleri oluşturabilir, güncelleyebilir ve silebilir. Toplam 20 araç vardır: 9'u veri okumak, 11'i yazmak için.

Hem iPhone uygulamasında (Ayarlar → Entegrasyonlar → AI Ajanları) hem de web uygulamasında (Ayarlar → AI Ajanları) mevcut.

Plan gereksinimleri

Plan	MCP
Free	Kilitli
Basic	Kilitli
Pro	Read + Write (20 araç)
Ultra	Read + Write (20 araç, daha yüksek kotalar) - Read-only moduna da geçebilir

Uygulama içi ekran

AI Ajanları ekranı planına ve MCP'nin açık olup olmamasına bağlı olarak üç duruma sahiptir.

Kilitli (Free ve Basic)

Free veya Basic planındaysan, ekran MCP'nin ne yaptığını açıklar ve bir Yükselt düğmesi gösterir. Üzerine dokunmak, Pro veya Ultra'ya geçebileceğin paywall'u açar.

Devre dışı (Pro ve Ultra, özellik kapalı)

Pro veya Ultra'daysan ama henüz MCP'yi açmadıysan, ekran planının neler yapabileceğine dair kısa bir özet (araç sayısı, erişim modu, kotalar) ve bir Etkinleştir düğmesi gösterir. Bağlantı token'ını oluşturmak ve entegrasyonu başlatmak için üzerine dokun.

Etkin

Etkinleştirildiğinde, ekran bir AI istemcisini bağlamak için ihtiyacın olan her şeyi gösterir:

• Mod anahtarı - Ultra'da Read-only ve Read + Write arasında geçiş yapabilirsin. Pro'da mod Read + Write'a sabittir.
• Token'ı göster veya gizle göz anahtarı ve kopyala düğmesiyle Erişim Token'ı satırı.
• Claude Code, Cursor, Windsurf ve Diğer sekmeleriyle Kurulum seçicisi. Eşleşen kod parçacığı sekmelerin altında görünür - sadece kopyalayıp AI istemcine yapıştır.
• Yeniden Oluştur düğmesi - token'ı hemen döndürür ve eskisini kullanan tüm aktif oturumları keser.
• Devre Dışı Bırak düğmesi - MCP'yi kapatır ve token'ı siler. Daha sonra yeniden etkinleştirebilirsin, ancak yeni bir token verilir.

ipucu

Bağlantı token'ını gizli tut. Token'a sahip olan herkes TellDone verilerine erişebilir. Token'ın sızdığından şüphelendiğinde Yeniden Oluştur'u kullan.

Nasıl etkinleştirilir

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

• iPhone: Ayarlar → Entegrasyonlar → AI Ajanları (MCP)
• Web: app.telldone.app → Ayarlar → AI Ajanları

Adımlar:

1. Etkinleştir'e dokun.
2. Erişim modunu seç (yalnızca Ultra - Pro her zaman Read + Write'tır).
3. Göz ve kopyala simgelerini kullanarak token'ını göster ve kopyala.
4. Kurulum bölümünde aracını seç (Claude Code, Cursor, Windsurf veya Diğer).
5. Parçacığı AI istemci yapılandırmana yapıştır.

AI aracını bağlama

Uygulama içi Kurulum seçicisindeki dört sekme (Claude Code, Cursor, Windsurf, Diğer) aşağıdaki bölümlerle eşleşir. Tüm örneklerde YOUR_TOKEN'ı ayarlarındaki token'la değiştir.

Claude Code

Bu komutu terminalinde çalıştır:

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

Cursor

.cursor/mcp.json'a ekle:

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

Windsurf

.codeium/windsurf/mcp_config.json'a ekle:

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

Diğer

Uygulama içi seçicinin Diğer altında grupladığı istemciler için bu parçacıkları kullan.

Codex

codex.json'a 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 herhangi bir araç bağlanabilir. Bearer YOUR_TOKEN yetkilendirme başlığıyla https://api.telldone.app/mcp/user/mcp uç noktasını kullan.

Alternatif auth header

İstemcin veya proxy'n Authorization başlığını rezerv ederse (örneğin, bazı Smithery tarzı geçitler), token'ı X-MCP-Token: YOUR_TOKEN olarak gönder. Her iki başlık da çalışır; ikisi de varsa, Authorization kazanır.

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 mevcut tüm araçları listeler.

Neler yapabilirsin

Okuma araçları (9) - Pro ve Ultra

Araç	Ne yapar
get_notes	Filtrelerle notları listele (etiketler, tarih aralığı, metin arama)
get_note	Alt görevleri, etkinlikleri ve tam transkriptiyle tek bir notu görüntüle
get_notes_full	Tek çağrıda gömülü görevler ve etkinliklerle birden fazla notu al
get_tasks	Duruma göre filtrelenmiş görevleri listele (yapılacak, bitti, tümü), etiketler veya tarihler
get_events	Takvim etkinliklerini listele, tarih aralığına göre filtrele
get_reports	Günlük, haftalık, aylık ve yıllık raporlarını oku (tam markdown)
get_tags	Tüm etiketlerini kullanıma göre sıralı görüntüle
get_profile	Hesap bilgilerini ve kullanım istatistiklerini gör
search	Notlar, görevler ve etkinlikler arasında ara (notlar için metin + semantik arama)

ipucu

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

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

Araç	Ne yapar
process_note	Tam AI süreci - metin veya ses gönder, görevler, etkinlikler ve etiketlerle bir not al
create_note	Düz metin not ekle (AI analizi yok)
create_task	Öncelik, son tarih, hatırlatıcı ve etiketlerle görev ekle
create_event	Tarih, saat, konum, hatırlatıcılar, katılımcılar ve tekrar ile takvim etkinliği ekle
update_note	Not başlığını, özetini, türünü, etiketlerini, önceliğini veya durumunu değiştir
update_task	Görev başlığını, açıklamasını, önceliğini, son tarihini, hatırlatıcısını, etiketlerini veya durumunu değiştir
complete_task	Bir görevi bitti olarak işaretle
update_event	Etkinlik ayrıntılarını, saati, konumu, hatırlatıcıları, katılımcıları, tekrarı, etiketleri veya durumu değiştir
delete_note	Bir notu ve tüm bağlı görevlerini ve etkinliklerini sil
delete_task	Bir görevi sil
delete_event	Bir etkinliği sil

Tüm yazma ve silme işlemleri, gerçek zamanlı senkron üzerinden bağlı cihazlarında (telefon, web uygulaması) anında görünür.

Araç referansı

get_notes

İsteğe bağlı filtrelemeyle notları listele. Tarih filtreleri created_at'i değil, recorded_at'i (sesli notu kaydettiğin zamanı) kullanır.

Parametre	Tür	Varsayılan	Açıklama
limit	int	20	Döndürülecek not sayısı (maks 50)
offset	int	0	Bu kadar notu atla (sayfalama için, maks 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ç)

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

get_note

Tam transkripti ve tüm bağlı 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 ve tasks[] ve events[] dizileriyle not.

get_notes_full

Tek çağrıda görev ve etkinlikleriyle birden fazla not al. get_notes ile aynı filtreler, ancak her not gömülü tasks[] ve events[] içerir.

Parametre	Tür	Varsayılan	Açıklama
limit	int	10	Not sayısı (maks 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

get_tasks

Filtrelemeyle görevleri listele.

Parametre	Tür	Varsayılan	Açıklama
status	string	"todo"	Filtre: todo, done veya all
limit	int	30	Görev sayısı (maks 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 hariç tutulur)
date_to	string	-	Bitiş tarihi, YYYY-MM-DD (son tarihe göre filtreler; son tarihi olmayan görevler hariç tutulur)

Döndürür: id, title, description, status, priority, tags, deadline, reminder_at, completed_at, completed_by, source, created_at ile görev listesi.

get_events

Tarih aralığı filtrelemesiyle takvim etkinliklerini listele.

Parametre	Tür	Varsayılan	Açıklama
limit	int	30	Etkinlik sayısı (maks 100)
offset	int	0	Bu kadar etkinliği atla
date_from	string	-	Başlangıç tarihi, YYYY-MM-DD (etkinlik başlangıç saatine göre filtreler)
date_to	string	-	Bitiş tarihi, YYYY-MM-DD

Döndürür: id, title, description, status, start_at, end_at, location, is_all_day, tags, created_at ile etkinlik listesi.

not

get_events, attendees, reminder_minutes veya recurrence_rule döndürmez. Bunlar create_event/update_event üzerinden yazılabilir ancak liste çıktısına dahil edilmez. İhtiyacın olursa, üst notu get_note ile al.

get_reports

AI ile oluşturulmuş 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ı (maks 10)

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

not

Aylık raporlar 3.000-5.000 kelime olabilir. AI aracının dar bir bağlam penceresi varsa limit=1 kullan.

get_tags

Tüm etiketlerini al, önce sabitlenmiş, sonra kullanım sayısına göre sıralı.

Parametre yok. tag, usage_count, is_pinned, is_manual ile en fazla 100 etiket döndürür.

get_profile

Hesap bilgilerini ve kullanım istatistiklerini 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

Notlar, görevler ve etkinlikler arasında aynı anda ara. Notlar için hem metin araması hem de semantik aramayı destekler (AI gömme kullanarak anlama göre sonuçlar bulur).

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

Sonuçları türe göre gruplandırılmış 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 olarak ayarla.

process_note (Pro ve Ultra)

Tam AI süreci - uygulamada kayıt etmekle aynı şekilde çalışır. Metin veya ses gönder, TellDone çevirir, AI ile analiz eder ve çıkarılan görevler, etkinlikler, etiketler ve gömme ile yapılandırılmış bir not oluşturur.

Bu araç asenkron'dur: hemen bir audio_id ile döner ve arka planda işler. Sonuçlar gerçek zamanlı senkron üzerinden bağlı cihazlarına gelir veya get_notes() ile yoklayabilirsin.

Parametre	Tür	Açıklama
text	string	Analiz edilecek metin (ses sağlanmazsa transkripsiyonu atlar)
audio_base64	string	Base64 kodlu ses dosyası (50MB'a kadar, transkripsiyonu tetikler)
audio_format	string	m4a, ogg, wav, mp3, aac veya webm (varsayılan: m4a)
parent_task_id	string	Bunun takip olduğu görevin UUID'si
parent_note_id	string	Bunun takip olduğu notun UUID'si
parent_event_id	string	Bunun takip olduğu etkinliğin UUID'si

text veya audio_base64'ten birini sağlamalısın (veya her ikisini - transkripsiyon için ses öncelikli).

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

not

process_note planının kotalarına tabidir (günlük yüklemeler, aylık notlar, maks metin uzunluğu). Mevcut kullanımını kontrol etmek için get_profile kullan.

create_note (Pro ve Ultra)

Anında düz metin not oluştur. AI analizi tetiklemez - görevler veya etkinlikler çıkarılmaz. Görev/etkinlik çıkarmalı tam AI analizi için bunun yerine process_note kullan.

Parametre	Tür	Limit	Açıklama
title	string	200 karakter	Gerekli
summary	string	1000 karakter	İsteğe bağlı. Kısa tanıtım (1-3 cümle). Rapor istemlerine dahildir, kısa tut
transcript	string	plana göre	İsteğe bağlı. Not ayrıntısında gösterilen uzun gövde. Raporlara dahil değil. Limitler: Free 2.000 / Basic 8.000 / 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ı

create_task (Pro ve Ultra)

Yeni bir görev oluştur.

Parametre	Tür	Limit	Açıklama
title	string	200 karakter	Gerekli
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 üst nota bağlamak için UUID, isteğe bağlı

create_event (Pro ve Ultra)

Bir takvim etkinliği oluştur.

Parametre	Tür	Limit	Açıklama
title	string	200 karakter	Gerekli
start_at	string	-	ISO 8601 tarih saat, gerekli
end_at	string	-	ISO 8601 tarih saat (varsayılan: başlangıç + 1 saat)
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 önce virgülle ayrılmış dakika (örneğin 15,60), isteğe bağlı
attendees	string	-	Virgülle ayrılmış adlar veya e-postalar, isteğe bağlı
recurrence_rule	string	-	RRULE dizesi (örneğin FREQ=WEEKLY;BYDAY=MO,WE,FR), isteğe bağlı
note_id	string	-	Etkinliği üst nota bağlamak için UUID, isteğe bağlı

update_note (Pro ve Ultra)

Mevcut bir notta bir veya daha fazla alanı güncelle. Yalnızca sağladığın alanlar değiştirilir.

Parametre	Tür	Açıklama
note_id	string	Gerekli, notun UUID'si
title	string	Yeni başlık (maks 200 karakter)
summary	string	Yeni özet (maks 1000 karakter, temizlemek için bir boşluk " " geç)
transcript	string	Yeni transkript (plan tabanlı limit, temizlemek için bir boşluk " " geç)
type	string	task, idea, info, status, meeting, event veya reflection
tags	string	Virgülle ayrılmış etiketler (mevcut tüm etiketleri değiştirir, maks 20)
priority	string	low, medium veya high
status	string	active veya archived

uyarı

Sesli not süreciyle oluşturulan notlar için, transcript orijinal konuşma-metin çıktısıdır. Üzerine yazmak kanonik kaynağı değiştirir - orijinali korumak istiyorsan onun yerine eklemeyi düşün.

update_task (Pro ve Ultra)

Mevcut bir görevde bir veya daha fazla alanı güncelle. Yalnızca sağladığın alanlar değiştirilir.

Parametre	Tür	Açıklama
task_id	string	Gerekli, görevin UUID'si
title	string	Yeni başlık
description	string	Yeni açıklama (temizlemek için bir boşluk " " geç)
priority	string	low, medium veya high
deadline	string	YYYY-MM-DD (temizlemek için bir boşluk geç)
status	string	todo veya done
tags	string	Virgülle ayrılmış etiketler (mevcut tüm etiketleri değiştirir, maks 20)
reminder_at	string	ISO 8601 tarih saat (temizlemek için bir boşluk geç)

status'u done olarak ayarlamak ayrıca görevin ne zaman ve nasıl tamamlandığını da kaydeder.

complete_task (Pro ve Ultra)

Bir görevi bitti olarak işaretlemek için kısayol.

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

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

update_event (Pro ve Ultra)

Mevcut bir etkinlikte bir veya daha fazla alanı güncelle. Yalnızca sağladığın alanlar değiştirilir.

Parametre	Tür	Açıklama
event_id	string	Gerekli, etkinliğin UUID'si
title	string	Yeni başlık
description	string	Yeni açıklama (temizlemek için bir boşluk geç)
start_at	string	Yeni başlangıç saati (ISO 8601)
end_at	string	Yeni bitiş saati (ISO 8601)
location	string	Yeni konum (temizlemek için bir boşluk geç)
status	string	confirmed, tentative veya cancelled
tags	string	Virgülle ayrılmış etiketler (mevcut tüm etiketleri değiştirir, maks 20)
is_all_day	string	"true" veya "false"
reminder_minutes	string	Etkinlikten önce virgülle ayrılmış dakika (örneğin 15,60)
attendees	string	Virgülle ayrılmış adlar veya e-postalar
recurrence_rule	string	RRULE dizesi (temizlemek için bir boşluk geç)

delete_note (Pro ve Ultra)

Bir notu sil. Bu, bu nottan oluşturulan tüm görevleri ve etkinlikleri de siler.

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

delete_task (Pro ve Ultra)

Bir görevi sil.

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

delete_event (Pro ve Ultra)

Bir etkinliği sil.

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

Giriş limitleri

Alan	Maks uzunluk	Kullanıldığı yer
title	200 karakter	not, görev, etkinlik oluştur/güncelle
description	2.000 karakter	görev, etkinlik oluştur/güncelle
summary	1.000 karakter (sıkı)	not oluştur/güncelle. Rapor istemlerine dahildir, token maliyetini kontrol etmek için kısa tutulur
transcript	plan tabanlı: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000	not oluştur/güncelle. Uzun gövde, raporlarda değil
location	200 karakter	etkinlik oluştur/güncelle
tags	20 etiket	not, görev, etkinlik oluştur/güncelle
arama sorgusu	500 karakter	search
audio_base64 (kod çözülmüş)	50 MB	process_note

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

Hata yönetimi

Tüm araçlar JSON döndürür. Hatalar bu biçimi kullanır:

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

Yaygın hatalar:

Hata	Ne zaman
"MCP access is read-only..."	Sadece okuma modunda yazma aracı çağrıldı
"Invalid note_id format"	Kimlik olarak UUID olmayan dize geçirildi
"Note not found"	Kimlik yok veya başka bir kullanıcıya ait
"Task not found or already completed"	Var olmayan veya zaten bitmiş bir görevde complete_task
"title too long (max 200 chars, got N)"	Giriş limiti aşıldı
"Too many tags (max 20)"	20'den fazla etiket sağlandı

HTTP düzeyinde hatalar:

Kod	Anlamı
401	Geçersiz veya eksik Bearer token
403	MCP devre dışı veya plan MCP'ye izin vermiyor
429	Hız limiti aşıldı (5 req/s)

Kullanım örnekleri

Tüm örnekler MCP JSON-RPC protokolüyle cURL kullanır. YOUR_TOKEN'ı bağlantı token'ınla değiştir.

Veri okuma

# Profilini ve istatistiklerini al
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"}}'

# Son notları listele (limit 5, Nisan 2026'dan)
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"}}}'

# Notları ara (hibrit metin + semantik)
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)

# Tam AI sürecinden bir notu işle (görevler + etkinlikler çıkarır)
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."}}}'

# Son tarih ve hatırlatıcılı bir görev oluştur
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"}}}'

# Hatırlatıcılar ve katılımcılarla tekrar eden bir etkinlik oluştur
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"}}}'

# Bir görevi tamamla
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": 10,
  "result": {
    "content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Review PR\",\"status\":\"todo\"}"}]
  }
}

not

Yazma ve güncelleme araçları yalnızca id, title ve status içeren minimal yanıtlar döndürür. Bir yazmadan sonra tam ayrıntıları almak için (etiketler, öncelik, son tarih vb.), get_tasks veya get_note gibi bir takip okuma çağrısı yap.

Token yönetimi

Eylem	Nasıl
Token'ı görüntüle	iPhone Ayarlar → Entegrasyonlar → AI Ajanları (veya web Ayarlar → AI Ajanları), göz simgesine dokun
Token'ı kopyala	Token'ın yanındaki kopyala simgesine dokun
Yeniden Oluştur	Yeniden Oluştur'a dokun ve onayla. Eski token hemen çalışmayı durdurur ve aktif oturumlar bağlantıyı keser
Modu değiştir	Yalnızca Ultra - Read-only ve Read + Write arasında geçiş yap. Pro'da mod Read + Write'a sabittir
Devre Dışı Bırak	Devre Dışı Bırak'a dokun ve onayla. Token silinir ve tüm bağlantılar durur. Daha sonra yeniden etkinleştirebilirsin (yeni bir token verilir)

AI ajanına neler sorabilirsin

Bağlandıktan sonra, AI aracına şöyle şeyler sor:

Gününü incele:

• "Bugün ne üzerinde çalıştım?"
• "Bu haftadan notlarımı göster"
• "Hangi görevler gecikmiş?"

Görevleri yönet:

• "Bir görev oluştur: çeyrek raporunu incele, yüksek öncelik, son tarih Cuma"
• "Figma görevini bitti olarak işaretle"
• "Hangi görevler üzerinde çalışıyorum?"

Ara ve analiz et:

• "Pazarlama stratejisi hakkında tüm notları bul"
• "Önümüzdeki hafta hangi etkinliklerim var?"
• "Geçen haftadan günlük raporlarımı özetle"

Önceden planla:

• "Bir etkinlik oluştur: yarın saat 10'da ekip toplantısı"
• "Bu hafta takvimimde ne var?"
• "En çok kullanılan etiketlerimi göster - en çok zamanı neye harcıyorum?"

AI ajanı notlarına, görevlerine, etkinliklerine ve raporlarına tam erişime sahiptir. Veriyi okuyabilir, oluşturabilir, güncelleyebilir ve silebilir ve birden fazla araçtan bilgi birleştirerek karmaşık soruları yanıtlayabilir.

Önemli notlar

• Not oluşturmanın iki yolu - create_note anında düz metin not oluşturur (AI analizi yok). process_note tam AI sürecini çalıştırır (uygulamada kayıt etmekle aynı) - metni analiz eder, görevler ve etkinlikler çıkarır, etiketler ve gömme oluşturur. TellDone'un düşünmesini istediğinde process_note kullan.
• Entegrasyon senkronu yok - MCP üzerinden oluşturulan veya güncellenen öğeler webhook otomasyonlarını veya entegrasyon senkronlarını (Todoist, Notion) tetiklemez. Bir sonraki senkronda uygulamalarında görünürler.
• Semantik arama araca bağlıdır - process_note ile oluşturulan notlar gömme alır ve semantik aramada görünür. create_note ile oluşturulan notlar gömme almaz, bu nedenle yalnızca metin aramasında görünür.
• Yazma yanıtları minimaldir - oluşturma ve güncelleme araçları yalnızca id, title ve status döndürür. Bir yazmadan sonra tüm alanları almak için bir takip okuma çağrısı yap.
• Tarih filtreleri UTC kullanır - date_from/date_to parametreleri UTC zaman damgaları olarak karşılaştırılır. UTC olmayan saat dilimlerindeki kullanıcılar için, sınır tarihleri komşu günlerden öğeleri dahil edebilir veya hariç tutabilir.
• Hız limiti - saniyede 5 istek. Toplu işlemler için isteklerini ayarla.

Güvenlik

• Her kullanıcı benzersiz bir 384-bit bağlantı token'ı alır
• MCP'yi devre dışı bıraktığında veya yeniden oluşturduğunda token'ın anında iptal edilir
• Tüm veriler hesabına sıkı bir şekilde izole edilir - ajanın yalnızca kendi verilerine erişebilir
• Her istek kullanıcına ayarlanır - bir ajanın başka bir kullanıcının verilerine erişmesinin yolu yoktur
• Bağlantı hız limitlemesiyle (5 req/s) HTTPS kullanır

Ayrıca bkz.

• Webhook otomasyonları - dış servislere otomatik veri gönder
• Todoist - özel iki yönlü görev senkronu
• Notion - özel Notion entegrasyonu