Claude Code için yerel MCP
konsolity mcp, standart giriş ve çıkış (stdio) üzerinde bir yerel MCP sunucusu başlatır. Aynı makinede çalışan bir Claude ajanı, örneğin Claude Code, bu sunucuyu sunucularınızı listelemek ve üzerlerinde komut çalıştırmak için konsolity run ile tamamen aynı kurallarla kullanır. Hiçbir şey uzak Claude bağlayıcısından geçmez: ajan doğrudan CLI ile konuşur.
Makine mcp alanıyla (ve ilgili araçlar için hosts, snippets ile) etkinleştirilmiş olmalıdır.
Claude Code bağlama
claude mcp add konsolity -- konsolity mcp
Sunucunun görüldüğünü doğrulayın:
claude mcp list
Claude Code her oturum için konsolity mcp komutunu başlatır ve oturum sonunda durdurur. Açık her MCP oturumu hesabın CLI oturumları listesinde görünür ve oradan sonlandırılabilir.
Araçlar
| Araç | Alan | İşlevi |
|---|---|---|
list_hosts |
hosts |
Kapsamdaki sunucular: tanımlayıcı, etiket, adres, kullanıcı, grup. Gizli bilgi yok. |
list_snippets |
snippets |
Kapsamdaki parçacıklar: tanımlayıcı, ad, grup. |
run_command |
hosts, tam erişim |
Kapsamdaki bir sunucuda komut kurallarına göre bir komut çalıştırır. |
run_snippet |
snippets + hosts, tam erişim |
Kapsamdaki bir sunucuda bir parçacık çalıştırır. |
list_sessions |
sessions |
Hesapta çalışan CLI oturumları. |
Salt okunur erişimde yalnızca listeleme araçları sunulur.
Aynı kurallar
- Kapsam dışındaki sunucu, hiçbir kurala uymayan komut: ajan için açık bir mesajla ve günlükte bir satırla reddedilir.
- Yıkıcı komut: “Herhangi bir komut” açıkken bile hiçbir şey çalışmadan önce uygulamada veya konsolda onay.
- Zaman aşımı: makinenin azami zaman aşımıyla sınırlıdır (varsayılan 60 sn, en fazla 1 sa).
- İptal veya oturum sonu: çalışan komut 5 saniyeden kısa sürede durdurulur ve MCP sunucusu kapanır.
Sınırlı çıktı
Bir araç sonucu çıkış kodunu, süreyi, standart çıktıyı ve hata çıktısını döndürür; her biri 64 KiB ile sınırlıdır. Bu sınırın ötesinde çıktı kırpılır ve sonuç bunu belirtir. Çıktının tamamı için bir terminalde konsolity run kullanın; onun çıktısı sınırlı değildir.
Claude'u bağlamanın üç yolu
konsolity mcp |
Claude bağlayıcısı | konsolity serve |
|
|---|---|---|---|
| Kullanılan Claude | Aynı makinedeki Claude Code (veya bir ajan) | claude.ai, Claude uygulaması | claude.ai, Claude uygulaması |
| Aktarım | yerel stdio | https://mcp.konsolity.com/mcp |
bağlayıcı kuyruğu, makine tarafından alınır |
| Kim çalıştırır | bu makinedeki CLI | açık masaüstü uygulaması | arayüzsüz hizmet olarak CLI |
| Onay | makinenin kapsamı ve kuralları | uygulamada “Bir kez izin ver” | makinenin kapsamı ve kuralları |
| Belgeler | bu sayfa | Claude bağlayıcısı | Hizmet ve depolama |
Her durumda, bir CLI makinesinden gelen yıkıcı komutlar onayınızı bekler.