İçeriğe geç
Oleaflyv0.4.12

Bağlantılar

Claude Desktop, Claude Code, Cursor, Codex ya da başka bir MCP istemcisini Oleafly'nin yerel proje araçlarına bağlayın.

Oleafly, bir MCP (Model Context Protocol) sunucusu olarak çalışabilir. Claude Desktop, Claude Code, Cursor, Codex ve Grok CLI gibi MCP istemcileri bir Oleafly projesini okuyabilir, düzenleyebilir, arayabilir ve derleyebilir. Modeli istemci sağladığı için Oleafly’de bir yapay zeka sağlayıcı anahtarına ihtiyacınız yoktur.

Elinizde zaten bir Claude (ya da benzeri) aboneliği varsa ve o sohbet uygulamasının Ayarlar içine bir API anahtarı yapıştırmadan Oleafly’yi yönetmesini istiyorsanız, aradığınız seçenek budur.

İki yönde MCPBir yönde, bilgisayarınızdaki Claude Desktop, Cursor veya Codex gibi bir MCP istemcisi, bir taşıyıcı belirteçle 127.0.0.1 üzerindeki Oleafly MCP sunucusuna bağlanır. Projeyi okuyabilir, düzenleyebilir ve derleyebilir; hangi değişikliklerin sizi bekleyeceğine onay politikanız karar verir. Diğer yönde, Oleafly'nin yerleşik asistanı eklediğiniz MCP sunucularındaki araçları kullanır: bir komut çalıştıran yerel bir sunucu ya da bir URL'deki uzak bir sunucu.MCP istemciniz Oleafly'nin araçlarını kullanırOleafly'nin asistanı diğer MCP sunucularını kullanırMCP istemcisiClaude Desktop,Cursor, CodexOleafly MCPYalnızca 127.0.0.1ProjeOkuma, düzenleme, derlemeTaşıyıcı belirteçOnaylarAsistanOleafly'de yerleşikYerel sunucuBir komut çalıştırırUzak sunucuBir URL'ye bağlanırİki yönde MCPBir yönde, bilgisayarınızdaki Claude Desktop, Cursor veya Codex gibi bir MCP istemcisi, bir taşıyıcı belirteçle 127.0.0.1 üzerindeki Oleafly MCP sunucusuna bağlanır. Projeyi okuyabilir, düzenleyebilir ve derleyebilir; hangi değişikliklerin sizi bekleyeceğine onay politikanız karar verir. Diğer yönde, Oleafly'nin yerleşik asistanı eklediğiniz MCP sunucularındaki araçları kullanır: bir komut çalıştıran yerel bir sunucu ya da bir URL'deki uzak bir sunucu.MCP istemciniz Oleafly'yi kullanırOleafly'nin asistanı sunucuları kullanırMCP istemcisiClaude Desktop, CursorOleafly MCPYalnızca 127.0.0.1ProjeOkuma, düzenleme, derlemeTaşıyıcı belirteçOnaylarAsistanOleafly'de yerleşikYerel sunucuBir komut çalıştırırUzak sunucuBir URL'ye bağlanır
Bilgisayarınızdaki bir MCP istemcisi, 127.0.0.1 ve bir belirteç üzerinden Oleafly'nin proje araçlarına ulaşır. Diğer yönde, Oleafly'nin asistanı eklediğiniz MCP sunucularındaki araçları kullanabilir.
  1. Ayarlar → Tümleştirmeler → Oleafly MCP bölümünü açın.
  2. MCP sunucusunu aç düğmesini açık konuma getirin.

Sunucu yalnızca Oleafly süreci açıkken çalışır. Yalnızca 127.0.0.1 adresinde dinler, yerel ağınızda asla dinlemez. Proje penceresini kapatmak sunucuyu durdurmaz; durduran, MCP’yi kapatmak ya da Oleafly’den çıkmaktır.

Oleafly 5323 bağlantı noktasını yeğler (http://127.0.0.1:5323/mcp). Bu nokta kullanılamıyorsa sunucu otomatik olarak başka bir boş yerel bağlantı noktasına bağlanır ve bunu sonraki açılış için kaydeder. Ayarlar, etkin URL’yi gösterir. Onun yeniden başlat düğmesi mümkünse geçerli bağlantı noktasını yeniden kullanır ya da başka bir boş nokta seçer.

Ayarlar, yaygın istemciler için kopyala-yapıştır parçacıkları gösterir. Seçilen bağlantı noktası 5323’ten farklı olabileceğinden canlı URL’yi kopyalayın, ardından <token> değerini Ayarlar’daki taşıyıcı belirteçle değiştirin (Göster / Kopyala).

Terminal penceresi
claude mcp add --transport http oleafly http://127.0.0.1:5323/mcp --header "Authorization: Bearer <token>"

claude_desktop_config.json dosyasına ekleyin (Desktop stdio’yu yeğlediğinden mcp-remote üzerinden stdio köprüsü):

{
"mcpServers": {
"oleafly": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"http://127.0.0.1:5323/mcp",
"--header",
"Authorization: Bearer <token>",
"--transport",
"http-only"
]
}
}
}

Her sürüm, bir Claude Desktop uzantısı olan oleafly.mcpb dosyasını içerir; bu yüzden yapılandırma dosyasına ve tokena ihtiyacınız olmaz. Dosyayı son sürümden (yeni sekmede açılır) indirin ve kurmak için Claude Desktop ile açın.

Uzantı, uygulamayla gelen oleafly komutunu başlatır ve Oleafly’de açık olan proje üzerinde çalışır; bu yüzden Oleafly’yi MCP sunucusu açık şekilde çalışır durumda tutun. Claude Desktop komutu bulamazsa uzantının ayarlarından seçin: macOS’ta Oleafly.app/Contents/MacOS içindeki oleafly-cli, Windows’ta %LOCALAPPDATA%\Oleafly içindeki oleafly-cli.exe.

MCP Registry aynı uzantıyı io.github.Oleafly/oleafly adıyla listeler.

.cursor/mcp.json dosyasına (ya da istemcinizin MCP yapılandırmasına) ekleyin:

{
"mcpServers": {
"oleafly": {
"url": "http://127.0.0.1:5323/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}

~/.grok/config.toml içinde:

[mcp_servers.oleafly]
url = "http://127.0.0.1:5323/mcp"
headers = { Authorization = "Bearer <token>" }

Oleafly ayarlarındaki Codex CLI parçacığını kullanın; bu parçacık çalışan sunucuya bir stdio köprüsü sağlar. Girdiyi Codex yapılandırmanıza ekleyin ve Oleafly’nin gösterdiği canlı URL ile belirteci kullanın:

~/.codex/config.toml
[mcp_servers.oleafly]
command = "npx"
args = [
"-y",
"mcp-remote@latest",
"http://127.0.0.1:5323/mcp",
"--header",
"Authorization: Bearer <token>",
"--transport",
"http-only"
]

Köprü, Node.js ve npx gerektirir. Yapılandırmayı değiştirdikten sonra istemciyi yeniden başlatın ya da yeniden bağlayın.

Kurulumu betikle yapmak isterseniz, Oleafly verilerinizin yanındaki (Ayarlar’da gösterilen) mcp.json dosyası aynı URL’yi ve belirteci tutar. Yalnızca sunucu çalışırken yazılır (Unix’te 0600 kipi) ve sunucu durduğunda silinir. Ona, diğer yerel gizli bilgiler gibi davranın.

MCP araçlarının çoğu adlarını ve şemalarını uygulama içi asistanla paylaşır. Proje keşfi ve yönlendirme araçları masaüstü arka ucu tarafından sağlanır.

Açık bir proje varken araçlar, uygulamada açık olan projeyi hedefler. Bağlı bir pencereyle başka bir projeyi seçmek için list_projects ve open_project kullanın.

Son pencere kapandıktan sonra arka uç read_file, list_files ve search_project araçlarını kullanıma açık tutar. Onay ilkesi izin verdiğinde yerel yazmalar, değiştirmeler, oluşturmalar ve yeniden adlandırmalar da kullanılabilir kalır. Bu araçlar yalnızca uygulamanın bildirdiği son projeyi kullanır ve o proje artık geçerli değilse çağrıyı reddeder. Kitaplıktaki diğer projelerden asla tahmin yürütmezler. Durum, proje seçimi, silme, derleme, günlükler, PDF incelemesi, tema değişiklikleri ve şekil araçları bağlı bir pencere gerektirir.

AraçNe yapar
get_statusOleafly sürümü, açık proje, belge motoru, ana belge, son derleme durumu ve son derlemenin neden başarısız olduğu ya da çalışamadığı
list_projectsKimlikleri, adları, motorları, türleri, ana belgeleri, zaman damgaları, renkleri, önizleme durumu ve dışa aktarma geçmişiyle projeler
open_projectBir projeyi kimliğiyle açar; böylece diğer araçlar onu hedefler
list_filesProje dosya ağacı
project_mapAna hatlar, etiketler, atıflar, makrolar, giriş grafiği, çözülmemiş başvurular
search_projectGeçerli projede metin arar
AraçNe yapar
read_fileBir proje dosyasını okur
get_logSon derleme günlüğü
get_pdf_textDerlenen PDF’den çıkarılan metin
verify_pdf_pagesOluşturulan PDF sayfalarını yerleşim sorunları için sayfa görüntülerinden ya da sayfa metninden denetler

get_pdf_text ve verify_pdf_pages, Oleafly’nin elindeki son PDF’i okur. Son derleme başarısız olduğunda ya da çalışamadığında sonuçları PDF’in eski olduğunu ve nedenini söyler; çünkü PDF daha önceki bir derlemeden gelir ya da başarısız derlemeden kalan kısmi bir PDF’dir. get_log da son derleme çalışamadığında aynısını söyler, çünkü günlük o zaman daha önceki bir derlemeden gelir.

AraçNe yapar
write_fileBir dosyaya yazar ya da üzerine yazar
replace_in_fileBir dosya içinde bulur ve değiştirir
create_fileBir dosya veya klasör oluşturur
rename_fileBir yolu yeniden adlandırır ya da taşır
delete_fileBir dosya veya klasörü siler
set_main_docDerleme giriş belgesini ayarlar
AraçNe yapar
compileProjeyi PDF’e derler
preview_figureBir şekli tek başına işler ve bir PNG görüntüsü döndürür
insert_figureSon önizlenen şekli belgeye ekler
load_imageŞekil çalışması için projeden bir görüntü yükler

compile, derlemenin işe yarayıp yaramadığını söyler, hatalarını listeler, bir PDF olup olmadığını belirtir ve günlüğün son bölümüyle biter. Biten bir derleme uyarılarını da bildirir. Derleme çalışamadığında, bitmediğinde ya da bir TeX kurulumu ya da bulunmayan bir Typst sürümü gibi kaynağın dışında bir şeye ihtiyaç duyduğunda sonuç nedeni verir ve Oleafly’nin uygulamada size sunduğu çözümü adlandırır. Araç, istemciden size söylemesini ve kaynağınıza dokunmamasını ister. Durdurduğunuz bir derleme durduruldu olarak işaretlenir; böylece istemci onu koddaki bir hata saymaz. Oleafly’nin kendi asistanı aynı sonucu alır.

Projenin LaTeX, Typst yoksa Markdown olduğunu öğrenmek için önce get_status çağırın, sonra kaynağı o biçimde yazın. preview_figure ve insert_figure, LaTeX ve Typst projelerinde çalışır:

  • LaTeX’te şekil, küçük bir bağımsız belgede derlenen TikZ kodudur ve insert_figure onu bir figure ortamına sarar.
  • Typst’te şekil, projenin Typst sürümüyle işlenen Typst işaretlemesidir; örneğin bir CeTZ tuvali ya da bir fletcher diyagramı. insert_figure onu #figure içine sarar, etiketi ondan sonraya koyar ve #import satırlarını onun üstüne taşır.
  • Markdown projesinde her iki araç da hata döndürür ve hiçbir şeyi değiştirmez.

load_image her projede çalışır.

AraçNe yapar
toggle_themeAçık / koyu kipi değiştirir
AraçNe yapar
list_skillsKurulu becerileri kimlikleri, adları, açıklamaları ve açık olup olmadıklarıyla listeler
load_skillBir becerinin tam yönergelerini ve dosya listesini yükler
read_skill_fileBir becerinin klasöründen bir başvuru ya da betik okur

Beceri araçları, açık proje ve Oleafly penceresi olmadan, bağlantı kurulur kurulmaz çalışır. Bir istemci, Ayarlar’da kapatılmış olanlar dahil her geçerli beceriyi görür: anahtarlar, Oleafly’nin kendi asistanının hangi becerileri kullanacağını belirler; bir istemcinin neleri okuyabileceğini değil. Becerileri bunun yerine bir klasörden okuyan ajanlar, Ayarlar → Yapay Zeka Asistanı → Beceriler içindeki Becerileri bu bilgisayardaki diğer ajanlarla paylaş seçeneğini kullanabilir. Beceriler sayfasına bakın.

Bu araçlar, Notlar’ı açın bölümünde anlatıldığı gibi Ayarlar → Deneysel Özellikler bölümünde Notlar açıkken bulunur. Açık proje üzerinde değil, notlarınız üzerinde çalışırlar ve bağlı bir pencere gerektirirler.

AraçNe yapar
list_knowledge_notesNotlarınızı, en yenisi önce, kimlikleri, başlıkları, etiketleri, bağlı projeleri ve kısa özetleriyle listeler. Etikete ya da projeye göre filtreler
search_notesNotlarınızda arar ve kimlikleri, başlıkları, etiketleri, bağlantıları ve eşleşen parçaları döndürür
read_note_by_idBir notu ön bilgisiyle birlikte Markdown olarak okur
today_noteBugünün günlük notunu ya da henüz yoksa sahip olacağı başlığı okur
list_note_tasksNotlarınızdaki onay kutulu görevleri, en yeni not önce, listeler. Nota göre ve açık ya da tamamlanmış olmasına göre filtreler
note_backlinksBir nota bağlantı veren notları, her bağlantının çevresindeki metinle listeler
append_to_noteBir notun ya da bugünün günlük notunun sonuna Markdown ekler
edit_note_sectionBir notun tek bir başlığın altındaki bölümünü yeniden yazar ya da sonuna ekleme yapar
create_noteBaşlığı, Markdown’ı, etiketleri ve bağlı bir projesi olan bir not oluşturur

append_to_note ve edit_note_section nota yazmaz. Değişiklikleri, siz Oleafly’de kabul edene kadar notta öneri olarak görünür. create_note Oleafly’de onayınızı bekler; append_to_note da önce bugünün günlük notunu oluşturması gerektiğinde öyle. Bu bağlantıya güven altında not oluşturmak sormaz. Bir iş birliği sunucusu üzerinden paylaşılan bir not bu yolla okunabilir ama değiştirilemez. Salt okunur, notları değiştiren üç aracı kaldırır.

Birçok MCP istemcisi bir aracı çağırmadan önce sorar. Oleafly ayrıca Ayarlar → Tümleştirmeler → Oleafly MCP içinde seçilen ilkeyi uygular:

  • Her değişikliği onayla varsayılandır. Yazma, yeniden adlandırma ve silme işlemleri, bir uygulama penceresi bağlıyken bir onay kartı gösterir. Pencere yokken bu işlemler reddedilir, çünkü kartın gösterileceği bir yer yoktur.
  • Düzenlemeleri otomatik onayla, silmeleri sor, yazma ve yeniden adlandırma işlemlerinin arka uçta çalışmasına izin verir. Silmeler onay için yine bağlı bir pencere gerektirir.
  • Bu bağlantıya güven, arka uç yazmalarının ve yeniden adlandırmalarının Oleafly istemi olmadan çalışmasına izin verir. Silme yine bağlı bir pencere gerektirir. Bu ilkeyi yalnızca istemciye ve onun kendi onay denetimlerine güveniyorsanız kullanın.

Bunu destekleyen iki anahtar daha vardır:

  • Salt okunur (ayrı bir anahtar), değiştiren araçları tools/list listesinden tamamen kaldırır; böylece dış bir uygulama, yukarıdaki ilke ne olursa olsun dosyaları okuyabilir ve derleyebilir ama asla değiştiremez.
  • Taşıyıcı belirteç: ~/.oleafly/ altındaki kimlik doğrulamalı şifreli yerel depoda tutulan 256 bitlik rastgele bir değer. Eski istemcileri geçersiz kılmak için onu yeniden üretin. Genel yapılandırma okumaları belirteci asla açığa çıkarmaz. Onu Ayarlar içinde yalnızca çalışan sunucunun bağlantı denetimleri gösterebilir.

Ve yapılandırmadığınız iki değişmez daha vardır:

  • Yalnızca localhost: bağlanma adresi 127.0.0.1’dir. Tarayıcı Origin başlığı taşıyan istekler reddedilir ve Host geri döngü olmalıdır.
  • Proje kısıtı: arka uç dosya araçları projeye göreli yolları kabul eder ve standart yolları uygulamanın bildirdiği projeyle sınırlar. Bir araç çağrısı başka bir proje kimliği veremez ya da arka ucun kitaplıktan başka bir projeyi seçmesini sağlayamaz.

Bir pencere bağlıyken MCP etkinliği sekmesi gelen çağrıları günlüğe kaydeder. Son pencere kapandıktan sonra arka uç çağrıları sürebilir, ama bir pencere yeniden bağlanana kadar bir etkinlik paneli ya da onay kartı yoktur.

Bir bulut sohbet hizmeti, makinenizdeki 127.0.0.1 adresine ulaşamaz. Onun yerine Claude Desktop (ya da Claude Code, Cursor vb.) kullanın. MCP bağlantı noktasını genel internete tünellemeyin: bu, elinde URL olan herkesin yerel proje dosyalarınızı düzenlemesine ve silmesine yol açar.

BelirtiDenenecekler
Bazı araçlar kullanılamıyorŞekil önizlemeleri ve diğer yalnızca arayüz araçları bir Oleafly penceresi gerektirir. Uygulamayı ve projeyi açın, sonra tools/list çağrısını yeniden deneyin.
Bağlantı noktası 5323’ten değiştiYeğlenen nokta kullanılamıyordu; Oleafly boş bir nokta seçti. Ayarlar’dan canlı URL’yi kopyalayın.
HTTP 401Belirteç uyuşmazlığı (örneğin Yeniden üret sonrasında). Yeni belirteci istemciye kopyalayın.
HTTP 403İstemci bir Origin başlığı ya da geri döngü olmayan bir Host gönderdi. Bir tarayıcı sekmesi değil, yerel bir MCP istemcisi kullanın.
Çağrı zaman aşımına uğradıHer araç çağrısı, derlemeler için ya da Onayla’yı tıklamanız için en çok 5 dakika (300 sn) bekler. Bekleyen kartları onaylayın ya da reddedin, ya da yeniden deneyin. Bir derleme daha uzun sürebilir; bir Quarto veya Calepin not defteri için bir saate kadar. Çağrı zaman aşımına uğradıktan sonra da Oleafly’de çalışmaya devam eder ve Oleafly penceresini gerektiren araçlar onu bekler; bu yüzden yeniden denemeden önce bitmesine izin verin.
compile hatalar yerine bir neden döndürüyorDerleme çalışamadı, örneğin TeX kurulu olmadığı için. Oleafly’nin uygulamada sunduğu çözümü, örneğin TinyTeX kurmayı kullanın, sonra yeniden derleyin.
BağlanılamıyorOleafly’nin MCP açıkken çalışıyor olması gerekir. Bu sunucu çıkışta durur; uygulama kapalıyken proje araçları için istemciyi bunun yerine oleafly mcp komutuna bağlayın.
Ayarlar → Yapay Zeka Asistanı → MCP. Bir sunucu ekleyin, kayıt defterine göz atın ya da başka bir araçtaki yapılandırmaları içe aktarın.
Ayarlar → Yapay Zeka Asistanı → MCP. Bir sunucu ekleyin, kayıt defterine göz atın ya da başka bir araçtaki yapılandırmaları içe aktarın. Tam ekran görüntüsünü aç

Yerleşik asistana daha fazla araç vermek için Ayarlar → Yapay Zeka Asistanı → MCP bölümünü açın.

  • Kayıt defterine göz at ile bir sunucu bulun ve kurulumunu inceleyin.
  • Diğer araçlardan içe aktar ile var olan sunucu yapılandırmalarını seçin. İçe aktarmadan önce seçili girdileri inceleyin.
  • Sunucu ekle ile bir sunucuyu kendiniz girin, sonra bağlantıyı doğrulayın.

Bağlı sunucular araçlarını asistana sunar. Bağlantı durumunu inceleyebilir, sunucuları aynı sayfadan açabilir ya da kapatabilirsiniz. Kimlik bilgileri ve komutlar her sunucu yapılandırmasına aittir; yeni bir sunucu bağlamadan önce onları inceleyin.

alphaXiv de bir MCP sunucusu olarak bağlanır, ama onu burada değil, Ayarlar → Tümleştirmeler → alphaXiv bölümünde bir API anahtarıyla kurarsınız. Bağlandıktan sonra bu listede alphaXiv olarak görünür. Adımları Araştırma kaynaklarını bağlayın sayfası anlatır.

Sunucu ekle → Form. Yerel komut ya da Uzak URL seçin, bağlantı alanlarını doldurun, sonra Ekle ve doğrula'yı kullanın.
Sunucu ekle → Form. Yerel komut ya da Uzak URL seçin, bağlantı alanlarını doldurun, sonra Ekle ve doğrula'yı kullanın. Tam ekran görüntüsünü aç

Ayarlar → Yapay Zeka Asistanı → MCP altında Sunucu ekle’yi seçin. Yerel bir sunucu stdio üzerinden bir komut çalıştırır; uzak bir sunucu bir URL’ye bağlanır. JSON formu Oleafly’nin sunucu biçimini kullanır:

Yerel sunucu yapılandırması
{
"name": "Research tools",
"enabled": true,
"transport": "stdio",
"command": "your-mcp-server",
"args": ["--stdio"],
"env": {}
}

Komutu ve argümanları, kurduğunuz sunucunun belgelediği değerlerle değiştirin. Ortam değerleri env nesnesine yazılır.

Uzak sunucu yapılandırması
{
"name": "Research service",
"enabled": true,
"transport": "remote",
"url": "https://your-server.example/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}

Örnek URL’yi ve belirteci, hizmetin bağlantı ayrıntılarıyla değiştirin. Bağlantıyı denetlemek için Doğrula’yı kullanın, sonra sunucunun sunduğu araçları inceleyin. Sunucuyu kendi satırından açın ya da kapatın. Yapılandırmayı değiştirmek için düzenleme eylemini, bağlantıyı kesmek için kaldırma eylemini kullanın.

Diğer araçlardan içe aktar’ı seçin, bulunan yapılandırmaları inceleyin ve istediğiniz sunucuları seçin. İçe aktarmadan önce yürütülebilir dosya yollarını, ortam değişkenlerini, URL’leri ve kimlik bilgilerini inceleyin. Bu işlem bağlantı ayarlarını içe aktarır; sunucu yürütülebilir dosyasını sizin için kurmaz.

  1. Oleafly’de küçük bir alıştırma projesi açın.
  2. Uygulamadan kopyaladığınız parçacığı kullanarak dış istemciyi bağlayın.
  3. İstemciden get_status çağırmasını ve proje dosyalarını listelemesini isteyin.
  4. Ana belgeyi okumasını ve bir başlık değişikliği önermesini isteyin.
  5. Bir yazma işlemini onaylamadan önce eylemi Oleafly’de inceleyin.
  6. Derleyin ve PDF’i inceleyin.

Oleafly içinde bağlı bir dış araç için, o sunucunun desteklediği basit bir salt okunur istekle başlayın ve sohbette oluşan araç kartını inceleyin.

Görsel önizlemesi

Yapay zekâ yanıtları yüklenemedi

Yeniden deneyin ya da dokümanlarda arama yapın.