Tesseract'a MCP bağlayıcısı (MCP sunucusu) ekleme

Tesseract, stdio, HTTP veya SSE üzerinden çalışan MCP sunucularının yanı sıra resmî MCP kayıt defterindeki sunucuları da destekler. Sunucuyu Ayarlar → Eklentiler → Bağlayıcılar bölümünden bir kez; adresiyle, başlatma komutuyla veya JSON ayarlarıyla eklersiniz. Tesseract'taki 14 ajan çerçevesinin tümü bu sunucunun araçlarını kullanabilir.

Tesseract 0.12.5 sürümüyle kontrol edildi.

Tesseract'a MCP sunucusu nasıl eklerim?

Ayarlar → Eklentiler → Bağlayıcılar bölümünü açın ve Tesseract'a sunucuyu üç biçimden biriyle ekleyin. Tesseract, herhangi bir şey eklenmeden önce sunucu bilgilerini gösterir.

  1. Ayarlar → Eklentiler bölümünü, ardından Bağlayıcılar sekmesini açın.
  2. Üstteki kutuya aşağıdakilerden birini yapıştırın, ardından Ekle'ye basın:
    • Bir adres: Web'deki bir sunucu için https://mcp.example.com/mcp gibi bir http(s) bağlantısı.
    • Bir komut: Bilgisayarınızda stdio üzerinden çalışan bir sunucu için npx -y @acme/notes-mcp gibi.
    • JSON biçimindeki ayarları: Bir komut, bağımsız değişkenleri ve ortamı.
  3. Tesseract'ın size gösterdiklerine bakın. Bir komut söz konusu olduğunda, çalıştıracağı komutun tamamını görürsünüz ve siz izin vermeden hiçbir şey çalışmaz.
  4. Alttaki düğmeyle ekleyin: Komut için İzin ver ve ekle, adres için Bağlayıcı ekle. Düğmeye basana kadar hiçbir şey eklenmez.

Bir sunucunun README dosyasındaki gibi bir JSON yapılandırmasını yapıştırabilir miyim?

Evet. Tesseract, url veya command içeren tek bir sunucunun ayarlarını ya da mcpServers altındaki bir bloğun tamamını okuyabilir. servers, mcp veya mcp_servers altındaki sunucuları da bulur.

Örneğin, bilgisayarınızda çalışan bir sunucu:

{ "mcpServers": { "notes": { "command": "npx", "args": ["-y", "@acme/notes-mcp"] } } }

Ayarlarda birden fazla sunucu varsa Tesseract her birini listeler; eklemek istediklerinizi siz seçersiniz.

Resmî MCP kayıt defterinden nasıl sunucu eklerim?

Bağlayıcılar sekmesinde kutunun yanındaki Dizine göz at düğmesine basın ve oradan bir sunucu ekleyin.

  1. Ayarlar → Eklentiler → Bağlayıcılar bölümünü açın.
  2. Dizine göz at düğmesine basın. Resmî MCP kayıt defterindeki sunucular listelenir; ada göre arama yapabilirsiniz.
  3. İstediğiniz öğedeki Ekle düğmesine basın. Ardından, yapıştırılmış bir adres veya komut için uygulanan adımların aynısını görürsünüz. Siz söylemeden hiçbir şey eklenmez.

Claude Code, Codex, Gemini CLI ve OpenCode ile çalışıyor mu?

Evet. Bu sitede 14 ajan çerçevesinin her birine ait sayfada, desteklenen özellikler arasında “Tesseract araçları ve MCP sunucularınız” listelenir. Buna Claude Code, OpenAI Codex, OpenCode, Gemini CLI, Antigravity CLI, Kimi Code, Qwen Code, MiniMax Code, CodeBuddy, Grok Build, Cursor, Hermes Agent, OpenClaw ve NanoClaw dâhildir. Bağlayıcıyı her çerçeve için ayrı ayrı değil, Tesseract'a bir kez eklersiniz. Her konuşma kendi çerçevesini kullanır; böylece farklı konuşmalar farklı çerçevelerde çalışabilir.

Bağlayıcım için "Tesseract'a ekle" düğmesini nasıl oluşturabilirim?

tesseract.dev/connect/ adresindeki ücretsiz oluşturucuyu kullanın. README dosyanıza ekleyebileceğiniz bir Markdown rozeti ve düz bir bağlantı oluşturur.

  1. tesseract.dev/connect/ adresini açın.
  2. Bağlayıcınızın adını yazın.
  3. Sunucunuzun adresini veya JSON biçimindeki ayarlarını yapıştırın.
  4. Markdown'ı README'nize ya da bağlantıyı kopyalayın.

Rozet, doğrudan uygulamaya değil tesseract.dev'deki bir sayfaya bağlantı verir; çünkü GitHub, http(s) olmayan bağlantıları kaldırır. Adres en fazla 2.048 karakter olabilir. Ayarlar, en fazla 20.000 karakterlik tek bir JSON nesnesi olmalıdır. Ayarlar bağlantının içine yalnızca kodlanarak (base64url) yazılır; bu yüzden gerçek anahtarları ve tokenları ayarlara eklemeyin.

Birisi düğmeye tıklayınca ne olur?

Önce tesseract.dev'de bağlayıcınızı görürler; hiçbir şey kendiliğinden açılmaz.

  1. Sayfada bağlayıcının ne olduğu belirtilir: bağlandığı web adresi ya da çalıştırdığı komut, tam hâliyle yazılır.
  2. Uygulamaya sahip olmayanlar için Tesseract'te Aç ve Tesseract'ı Edinin seçenekleri sunar.
  3. Tesseract'te Aç, Ayarlar → Eklentiler → Bağlayıcılar bölümünü açar ve bağlayıcıyı kutuya önceden yerleştirip "Bu bağlantıdan geldi" olarak işaretler.
  4. Tesseract, herhangi bir şey eklenmeden önce onu yeniden gösterir ve herhangi bir şey çalıştırılmadan önce sorar.

url= veya config= bilgisi okunamayan bir bağlantıda "Bu bağlantı bir bağlayıcı belirtmiyor" mesajı gösterilir.

Bu, Tesseract'i Claude veya ChatGPT içinde kullanmakla aynı şey mi?

Hayır. Bu kılavuz, diğer MCP sunucularını Tesseract'e eklemeyi anlatıyor; Claude ve ChatGPT'de Tesseract ise bunun tersidir: Tesseract'i tek bir adresle sohbet uygulamanıza eklersiniz.

Sorular

Tesseract herhangi bir MCP sunucusunu kullanabilir mi?

stdio, HTTP veya SSE üzerinden çalışan tüm MCP sunucularını kullanabilir.

Sunucuyu Claude Code ve Codex için ayrı ayrı mı kurmam gerekiyor?

Hayır. Ayarlar → Eklentiler → Bağlayıcılar bölümüne bir kez eklemeniz yeterli; Tesseract'teki tüm frameworkler onu kullanabilir.

README'deki mcpServers JSON'unu yapıştırabilir miyim?

Evet. Tesseract, tek bir sunucunun ayarlarını veya mcpServers bloğunun tamamını okuyabilir.

Resmî MCP kayıt defterindeki sunucuları nerede bulabilirim?

Ayarlar → Eklentiler → Bağlayıcılar bölümünde, Dizine göz at altında.

"Tesseract'e ekle" bağlantısı bağlayıcıyı kendiliğinden ekler mi?

Hayır. Tesseract, herhangi bir şey eklenmeden önce bunu size yeniden gösterir ve herhangi bir şey çalıştırılmadan önce sorar.

Daha fazla rehber