2Mind MCP dokümantasyonu — kurulum, kapsamlar ve araçlar

Genel bakış

2Mind MCP sunucusu uzak bir MCP sunucusudur. Asistana notlarını arayıp okuması, koleksiyonlarını ve görevlerini listelemesi ve bunlarda değişiklik istemesi için araçlar verir. 2Mind uygulamalarıyla aynı hesap ve aynı veri üzerinde çalışır.

Okuma anında gerçekleşir. Yazma ise asla sessiz olmaz: her yazma aracı bir onay isteği oluşturur ve değişiklik ancak sen onayladıktan sonra uygulanır — o bağlantının geri alınabilir değişiklikleri kendi başına uygulamasına izin vermediysen.

Sunucu, Streamable HTTP taşımasını durumsuz (stateless) modda kullanır. Her istek, OAuth bearer token taşıyan tek bir POST'tur; açık tutulacak bir oturum ya da olay akışı yoktur.

Bağlanma

Bir 2Mind hesabına ve uzak MCP sunucusu ekleyebilen bir asistana ihtiyacın var. Bu sunucu adresini kullan:

Sunucu adresi

https://api.use2mind.com/mcp

Claude

Bağlayıcı ayarlarını aç, özel bağlayıcı eklemeyi seç, 2Mind gibi bir ad ver ve sunucu adresini yapıştır. Kuruluş hesaplarında önce yöneticinin eklemesi gerekebilir.

ChatGPT

Geliştirici modunu aç ve sunucu adresi ile OAuth kimlik doğrulamasıyla yeni bir bağlayıcı oluştur. Geliştirici modu ChatGPT planına ve çalışma alanı ayarlarına bağlıdır.

Diğer istemciler

İstemciyi sunucu adresine yönlendir. Yetkilendirme sunucusunu sunucunun OAuth meta verisinden kendisi bulur; başka bir ayar gerekmez.

Bağlandığında ne olur

Asistanın 2Mind giriş sayfasını tarayıcıda açar.
Google, e-posta ve parola ya da Apple cihazlarda Apple ile giriş yaparsın.
Uygulamanın ne istediğine bakar ve bir erişim düzeyi seçersin.
Asistanına geri dönersin ve 2Mind araçları görünür.

Erişim düzeyleri

Asistan yazma erişimi istediğinde rıza ekranı seçimi sana bırakır. Seçtiğin düzey yalnız bağlanırken değil, her bir çağrıda yeniden denetlenir.

“Read only” — yalnız okuma (varsayılan): Arama, okuma ve listeleme. Bu bağlantıda yazma araçları listede bile görünmez.
“Read and make changes” — okuma ve değişiklik: Değişiklik isteyen araçları ekler. Her değişiklik yine onaydan geçer.

Kimlik doğrulama ve kapsamlar

Sunucu yalnızca Authorization başlığında bearer olarak gönderilen OAuth 2.0 erişim token'larını kabul eder. API anahtarı yoktur ve hiçbir token araç parametresi olarak iletilmez.

Geçerli token taşımayan bir istek, korunan kaynak meta verisini gösteren bir WWW-Authenticate başlığıyla 401 alır. İstemci buradan yetkilendirme sunucusunu bulur ve PKCE ile bir yetkilendirme kodu akışı başlatır.

POST https://api.use2mind.com/mcp
GET https://api.use2mind.com/.well-known/oauth-protected-resource
issuer https://auth.use2mind.com

Kapsam	İzin verdiği	Araçlar
`notes:read`	Notlarda arama, notları listeleme ve tamamını okuma; etiketleri listeleme.	`searchfetchlist_entrieslist_tags`
`collections:read`	Koleksiyonları listeleme ve okuma; etiketleri listeleme.	`list_collectionsget_collectionlist_tags`
`todos:read`	Görevleri filtreyle listeleme.	`list_todos`
`notes:write`	Not oluşturma, düzenleme, etiketleme, taşıma ve silme isteği.	`create_entryupdate_entrymove_entrydelete_entryundo_command`
`todos:write`	Görev oluşturma, düzenleme, sıralama ve silme isteği.	`create_todoupdate_tododelete_todoreorder_todosundo_command`
`collections:write`	Koleksiyon oluşturma, düzenleme, sıralama ve arşivleme isteği.	`create_collectionupdate_collectionreorder_collectionsarchive_collectionunarchive_collectionundo_command`

Uygulamada kullandığın giriş yöntemiyle giriş yap. Hesaplar farklı giriş sağlayıcıları arasında birleştirilmez; başka bir sağlayıcı ya da Apple'ın gizli e-posta adresi ayrı, boş bir 2Mind hesabı açabilir.

Değişiklikler nasıl işler

Hiçbir yazma aracı verini kendi başına değiştirmez. Hedeflediği şeyin güncel sürümünü okur, kesin bir plan kurar ve bir onay isteği oluşturur. Yanıt, izleyebileceğin bir işlemdir (operation).

Asistan bir istek oluştururKendi ürettiği bir requestId ile bir yazma aracını çağırır. Sunucu pending_approval durumunda bir işlem ve değişikliğin tek satırlık özetiyle yanıt verir.
Bir bildirim alırsınTelefonuna bir bildirim düşer. Değişikliği orada onaylar ya da reddedersin; asistan asla senin yerine onay vermez.
Değişiklik uygulanırOnayladığında değişiklik uygulanır ve kaydedilir, böylece sonradan geri alınabilir. Yanıtlamadığın istekler 24 saat sonra düşer.
Asistan sonucu kontrol ederDeğişikliğin uygulanıp uygulanmadığını, reddedildiğini, başarısız olduğunu ya da süresinin dolduğunu görmek için operationId ile get_operation'ı çağırır.

Örnek

Araç çağrısı

{
  "name": "create_todo",
  "arguments": {
    "requestId": "3f6c2a9e-8b1d-4c7a-9e2f-5a1b7d4c8e60",
    "collectionId": "b2e4d6f8-1a3c-4e5f-8a7b-9c0d1e2f3a4b",
    "content": "Diş hekimi randevusunu al",
    "dueDate": "2026-10-02T09:00:00+03:00"
  }
}

Sonuç

{
  "operationId": "c81f0e2a-6d4b-4a9e-b3c7-1f2e3d4c5b6a",
  "action": "create_todo",
  "status": "pending_approval",
  "summary": "“Diş hekimi randevusunu al” görevini Ayak işleri listesine ekle",
  "approvalUrl": "https://api.use2mind.com/connect/approvals/c81f0e2a-6d4b-4a9e-b3c7-1f2e3d4c5b6a",
  "expiresAt": "2026-10-01T09:00:00.000Z"
}

İşlem nesnesi

`operationId`	get_operation'a verilecek kimlik.
`action`	İsteği oluşturan araç.
`status`	İsteğin şu anki durumu; aşağıdaki tabloya bak.
`summary`	Sunucunun yazdığı, tam olarak neyin değişeceğini anlatan tek satır.
`approvalUrl`	İsteğin ayrıca incelenebildiği, girişle korunan sayfa.
`expiresAt`	Yanıtlanmayan isteğin düşeceği zaman.
`commandLogId`	Uygulandıktan sonra dolar. undo_command ile kullanılır.
`result`	Uygulanan değişikliğin sonucu; örneğin yeni notun kimliği.

Durum değerleri

`pending_approval`	Onaylamanı ya da reddetmeni bekliyor.
`applied`	Onaylandı ve uygulandı.
`failed`	Onaylandı ama uygulanamadı; örneğin öğe bu arada değişti.
`rejected`	Reddettin.
`expired`	24 saat içinde yanıtlanmadı. Hiçbir şey değişmedi.

Sormadan uygula

“Connected apps” sayfasında her bağlantının bir “Apply changes without asking” anahtarı vardır ve varsayılan olarak kapalıdır. Açıkken o bağlantıdan gelen geri alınabilir değişiklikler hemen uygulanır ve applied olarak döner. delete_entry ve delete_todo yine onay bekler. Her değişiklik yine kaydedilir ve geri alınabilir.

Connected apps

Geri alma

Uygulanmış bir değişikliği asistan commandLogId ve version ile undo_command kullanarak, sen de “Recent changes” sayfasından tek dokunuşla geri alabilirsin. Öğe değişiklikten sonra düzenlendiyse geri alma reddedilir; böylece daha yeni çalışman asla ezilmez.

Recent changes

Araç başvurusu

Bir bağlantı yalnızca erişim düzeyinin izin verdiği araçları listeler. Her yazma aracı bir requestId alır: aynı requestId ile tekrar denemek ikinci bir değişiklik yaratmak yerine aynı işlemi döndürür.

Okuma

`search`

Yalnız okumaKapsam: notes:read

Notlarında bir anahtar kelime ya da konu arar; en fazla 20 eşleşmeyi kimliği, başlığı ve bağlantısıyla döndürür.

Parametre	Tür	Zorunlu	Açıklama
`query`	`string`	Evet	Aranacak anahtar kelime ya da konu.1–2.000 karakter

`fetch`

Yalnız okumaKapsam: notes:read

Bir notu kimliğiyle eksiksiz okur. Çok uzun bir not parça parça gelir; sonraki parçayı okumak için dönen nextId'yi ver.

Parametre	Tür	Zorunlu	Açıklama
`id`	`string`	Evet	search'ten bir not kimliği ya da uzun bir notu sürdürmek için önceki fetch'in nextId'si.en fazla 80 karakter

`list_entries`

Yalnız okumaKapsam: notes:read

Notlarını en yeniden eskiye listeler; isteğe bağlı olarak koleksiyona, etikete, başlık ya da gövdede geçen bir metne veya oluşturulma tarihi aralığına göre süzer. Her satır kısa bir önizleme, notun bulunduğu bütün koleksiyonları ve etiketlerini taşır. Sayfalıdır.

Parametre	Tür	Zorunlu	Açıklama
`collectionId`	`uuid`	Hayır	Yalnızca bu koleksiyondaki notlar.
`tag`	`string`	Hayır	Yalnızca bu etiketi taşıyan notlar; büyük/küçük harf gözetilmez.1–100 karakter
`contains`	`string`	Hayır	Yalnızca başlığında ya da gövdesinde bu metin geçen notlar; büyük/küçük harf gözetilmez.1–200 karakter
`createdAfter`	`string (date-time)`	Hayır	Yalnızca bu zamanda ya da sonrasında oluşturulan notlar. Saat dilimi farkıyla ISO 8601.
`createdBefore`	`string (date-time)`	Hayır	Yalnızca bu zamanda ya da öncesinde oluşturulan notlar. Saat dilimi farkıyla ISO 8601.
`limit`	`integer`	Hayır	Sayfa başına döndürülecek öğe sayısı.1–50 · varsayılan 20
`cursor`	`string (date-time)`	Hayır	Önceki sayfadaki nextCursor değeri.

`list_collections`

Yalnız okumaKapsam: collections:read

Koleksiyonlarını kayıtlı sıranla; türü, üst koleksiyonu, arşiv durumu ve görev taşıyıp taşımadığıyla listeler. Sayfalıdır.

Parametre	Tür	Zorunlu	Açıklama
`limit`	`integer`	Hayır	Sayfa başına döndürülecek öğe sayısı.1–50 · varsayılan 20
`cursor`	`string`	Hayır	Önceki sayfadaki nextCursor değeri.en fazla 100 karakter
`includeArchived`	`boolean`	Hayır	Arşivlenmiş koleksiyonları da döndürür. Varsayılan olarak gizlidir.

`get_collection`

Yalnız okumaKapsam: collections:read

Bir koleksiyonu kimliğiyle okur: list_collections ile aynı alanlar, artı son değiştiği zaman, kaç not tuttuğu ve kaç görevinin hâlâ açık olduğu.

Parametre	Tür	Zorunlu	Açıklama
`collectionId`	`uuid`	Evet	Okunacak koleksiyon.

`list_todos`

Yalnız okumaKapsam: todos:read

Görevlerini listeler; isteğe bağlı olarak koleksiyona, tamamlanma durumuna ya da bitiş tarihi aralığına göre süzer. Sayfalıdır.

Parametre	Tür	Zorunlu	Açıklama
`collectionId`	`uuid`	Hayır	Yalnızca bu koleksiyondaki görevler.
`completed`	`boolean`	Hayır	Yalnızca tamamlanmış (true) ya da açık (false) görevler.
`dueAfter`	`string (date-time)`	Hayır	Yalnızca bu zamanda ya da sonrasında biten görevler. Saat dilimi farkıyla ISO 8601.
`dueBefore`	`string (date-time)`	Hayır	Yalnızca bu zamanda ya da öncesinde biten görevler. Saat dilimi farkıyla ISO 8601.
`limit`	`integer`	Hayır	Sayfa başına döndürülecek öğe sayısı.1–50 · varsayılan 20
`cursor`	`string`	Hayır	Önceki sayfadaki nextCursor değeri.en fazla 100 karakter

`list_tags`

Yalnız okumaKapsam: notes:read · collections:read

Etiket sözlüğünü, her etiketi kaç notun ve koleksiyonun taşıdığıyla birlikte, en çok kullanılan başta olmak üzere listeler. Notlar ve koleksiyonlar tek bir sözlüğü paylaşır.

Parametre	Tür	Zorunlu	Açıklama

Notlar

`create_entry`

Onay gerekirKapsam: notes:write

Var olan bir koleksiyonda yeni bir not ister. Koleksiyon her zaman açıkça seçilir.

Parametre	Tür	Zorunlu	Açıklama
`requestId`	`uuid`	Evet	Asistanın ürettiği bir UUID. Yeniden kullanılırsa var olan işlem döner.
`collectionId`	`uuid`	Evet	Notun oluşturulacağı koleksiyon. list_collections ile bulunur.
`content`	`string`	Evet	Notun gövdesi.1–20.000 karakter
`title`	`string ya da null`	Hayır	Not başlığı. null başlığı kaldırır.en fazla 500 karakter
`tags`	`string[]`	Hayır	Yeni notun etiketleri, # olmadan. Mümkünse list_tags'teki adları yeniden kullan.en fazla 10 öğe

`update_entry`

Onay gerekirKapsam: notes:write

Bir notun başlığında, gövdesinde ya da etiketlerinde değişiklik ister.

Parametre	Tür	Zorunlu	Açıklama
`requestId`	`uuid`	Evet	Asistanın ürettiği bir UUID. Yeniden kullanılırsa var olan işlem döner.
`entryId`	`uuid`	Evet	Değiştirilecek not.
`title`	`string ya da null`	Hayır	Not başlığı. null başlığı kaldırır.en fazla 500 karakter
`content`	`string ya da null`	Hayır	Notun gövdesi.en fazla 20.000 karakter
`tags`	`string[]`	Hayır	Eksiksiz yeni etiket kümesi, # olmadan. Listede olmayan kaldırılır; [] hepsini kaldırır. Etiketlere dokunmamak için verme.en fazla 10 öğe

`move_entry`

Onay gerekirKapsam: notes:write

Bir not için yeni bir koleksiyon kümesi ister. Not, listede olmayan koleksiyonlardan, orada oluşturduğu görevlerle birlikte çıkar.

Parametre	Tür	Zorunlu	Açıklama
`requestId`	`uuid`	Evet	Asistanın ürettiği bir UUID. Yeniden kullanılırsa var olan işlem döner.
`entryId`	`uuid`	Evet	Değiştirilecek not.
`collectionIds`	`uuid[]`	Evet	Not için eksiksiz yeni koleksiyon kümesi.1–5 öğe
`primaryCollectionId`	`uuid`	Hayır	Ana koleksiyon. collectionIds içinden biri olmalı; varsayılan ilkidir.

`delete_entry`

Her zaman onay gerekirKapsam: notes:write

Bir notun ve ona bağlı görevlerin silinmesini ister. Her zaman onay gerekir.

Parametre	Tür	Zorunlu	Açıklama
`requestId`	`uuid`	Evet	Asistanın ürettiği bir UUID. Yeniden kullanılırsa var olan işlem döner.
`entryId`	`uuid`	Evet	Değiştirilecek not.

Görevler

`create_todo`

Onay gerekirKapsam: todos:write

Bir görev listesinin sonuna yeni bir görev ister.

Parametre	Tür	Zorunlu	Açıklama
`requestId`	`uuid`	Evet	Asistanın ürettiği bir UUID. Yeniden kullanılırsa var olan işlem döner.
`collectionId`	`uuid`	Evet	list_collections'ta carriesTodos değeri true olan bir koleksiyon.
`content`	`string`	Evet	Görev metni.1–2.000 karakter
`dueDate`	`string (date-time) ya da null`	Hayır	Bitiş tarihi, saat dilimi farkıyla ISO 8601. null tarihi temizler.

`update_todo`

Onay gerekirKapsam: todos:write

Bir görevin metninde, tamamlanma durumunda ya da bitiş tarihinde değişiklik ister.

Parametre	Tür	Zorunlu	Açıklama
`requestId`	`uuid`	Evet	Asistanın ürettiği bir UUID. Yeniden kullanılırsa var olan işlem döner.
`todoId`	`uuid`	Evet	Değiştirilecek görev.
`content`	`string ya da null`	Hayır	Görev metni.en fazla 20.000 karakter
`isCompleted`	`boolean`	Hayır	Görevi tamamlandı (true) ya da açık (false) olarak işaretler.
`dueDate`	`string (date-time) ya da null`	Hayır	Bitiş tarihi, saat dilimi farkıyla ISO 8601. null tarihi temizler.

`delete_todo`

Her zaman onay gerekirKapsam: todos:write

Bir görevin silinmesini ister. Her zaman onay gerekir.

Parametre	Tür	Zorunlu	Açıklama
`requestId`	`uuid`	Evet	Asistanın ürettiği bir UUID. Yeniden kullanılırsa var olan işlem döner.
`todoId`	`uuid`	Evet	Değiştirilecek görev.

`reorder_todos`

Onay gerekirKapsam: todos:write

Bir koleksiyonun içindeki görevler için en önemlisi başta olmak üzere yeni bir sıra ister. Yalnızca yer değiştiren görevleri saymak yeter; kalanlar onların ardında sırasını korur.

Parametre	Tür	Zorunlu	Açıklama
`requestId`	`uuid`	Evet	Asistanın ürettiği bir UUID. Yeniden kullanılırsa var olan işlem döner.
`collectionId`	`uuid`	Evet	Görevleri sıralanan koleksiyon. Her kimlik ona ait olmalı.
`orderedIds`	`uuid[]`	Evet	list_todos'tan görev kimlikleri, yeni sırayla. Adı geçmeyen görevler bunların ardında sırasını korur.1–100 öğe