PandaNpc MCP Sunucusunu Claude Code ve Codex için Yapılandırma

Güncellendi

PandaNpc MCP sunucusu, MCP uyumlu bir kodlama aracısını PandaNote bilgi tabanınıza, iş günlüklerinize, zamanlanmış görevlerinize, model yapılandırmanıza ve Aracı Servis Merkezi'ne bağlar. Aracının her seferinde boş bir sohbetle başlamak yerine kalıcı proje bağlamına ihtiyaç duyduğu durumlarda kullanışlıdır.

Sunucu, MCP'nin standart girdi/çıktı aktarımı üzerinden yerel olarak çalışır. MCP istemciniz bir oturum açıldığında pandanpc-mcp sürecini başlatır; bir bağlantı noktası açmanız veya ayrı bir web sunucusu çalıştırmanız gerekmez.

Kurulumdan önce

Şunlara ihtiyacınız vardır:

  • MCP istemcisinin çalıştığı ortamda Node.js ve npm'in mevcut olması.
  • Doğrulama için kullanılan e-posta adresine erişimi olan bir PandaNpc hesabı.
  • Claude Code, OpenAI Codex, Cursor veya yerel stdio MCP sunucularını destekleyen başka bir istemci.

Aracının kendi bilgisayarlarınızdan birinde iş zamanlamasını istiyorsanız, önce PandaPaw'ı kurun ve bağlayın. Notlar ve çalışma alanı araçları, çevrimiçi bir PandaPaw cihazı gerektirmez.

MCP sunucusunu kurma veya güncelleme

Paketi macOS, Linux veya Windows üzerinde genel olarak kurun:

bash
npm install -g @pandanpc/mcp-server

Yürütülebilir dosyanın kabuğunuz tarafından görülebildiğini doğrulayın:

bash
pandanpc-mcp --help

Güncellemek istediğinizde aynı npm komutunu çalıştırın. Güncellemeden sonra MCP istemcisini yeniden başlatın çünkü zaten çalışan bir istemci, başlangıçta başlattığı süreç sürümünü korur.

Bir araç veya davranışı eski bir ekran görüntüsünden veya öğreticiden farklıysa, MCP sunucu sürüm geçmişine göz atın.

PandaNpc'yi Claude Code'a ekleme

En güvenilir yöntem, Claude Code'un kendi yapılandırma komutudur. PandaNpc'nin her projede kullanılabilir olmasını istiyorsanız kullanıcı kapsamını kullanın:

bash
claude mcp add --scope user pandanpc -- pandanpc-mcp

Yapılandırmanın geçerli depo aracılığıyla paylaşılması gerektiğinde bunun yerine --scope project kullanın; yalnızca geçerli projede size uygulanması gerektiğinde ise --scope local kullanın.

Kayıtlı sunucuyu kontrol edin:

bash
claude mcp get pandanpc
claude mcp list

Ayrıca Claude Code kurulumunuz tarafından kullanılan MCP yapılandırmasında stdio sunucusunu elle de yapılandırabilirsiniz:

json
{
  "mcpServers": {
    "pandanpc": {
      "command": "pandanpc-mcp"
    }
  }
}

PandaNpc'yi OpenAI Codex'e ekleme

Codex aynı yerel süreci komut satırından kaydedebilir:

bash
codex mcp add pandanpc -- pandanpc-mcp

Kaydedilen yapılandırmayı doğrulayın:

bash
codex mcp get pandanpc
codex mcp list

~/.codex/config.toml içindeki eşdeğer giriş şudur:

toml
[mcp_servers.pandanpc]
command = "pandanpc-mcp"

Sunucuyu ekledikten sonra Codex'i yeniden başlatın veya yeni bir oturum açın. Özel bir Codex yapılandırma dosyası tutuyorsanız, MCP tablosunu dosyalar arasında çoğaltmak yerine o dosyaya koyun.

Cursor ve diğer MCP istemcilerini yapılandırma

Cursor için, Claude Code için gösterilen aynı JSON biçimini kullanarak ~/.cursor/mcp.json dosyasına yerel bir sunucu ekleyin. Windsurf ve diğer istemciler için, komutu pandanpc-mcp olan ve bağımsız değişken listesi boş olan bir stdio MCP sunucusu oluşturun.

Yürütülebilir dosya, grafik uygulamanın devraldığı PATH üzerinde olmalıdır. Terminalde çalışıyor ancak masaüstü istemcisi "komut bulunamadı" bildiriyorsa, aşağıdaki komutun döndürdüğü mutlak yürütülebilir dosya yolunu kullanın:

bash
command -v pandanpc-mcp

Windows PowerShell'de şunu kullanın:

powershell
Get-Command pandanpc-mcp

Aracıdan oturum açma

PandaNpc iki adımlı e-posta doğrulama akışı kullanır. Aracıdan şu işlemleri sırasıyla yapmasını isteyin:

  1. note_login işlevini e-posta adresinizle çağırın. PandaNpc bir doğrulama kodu gönderir.
  2. note_login işlevini aynı e-posta adresi ve kodla tekrar çağırın.

Yerel kimlik bilgisi önbelleğe alınır, bu nedenle her oturumda oturum açmanız gerekmez. Doğrulama kodunu asla herkese açık bir sohbet kaydına ya da paylaşılan bir isteme yapıştırmayın.

MCP bağlantısını doğrulama

Aracının veri oluşturmasına veya düzenlemesine izin vermeden önce küçük, yalnızca okuma amaçlı bir test çalıştırın:

  1. Ondan list_workspaces çağırmasını isteyin.
  2. Ondan bir çalışma alanı için list_notes çağırmasını isteyin.
  3. Ondan search_notes ile zararsız bir anahtar kelime aramasını isteyin.

Başarılı bir yanıt, MCP istemcisinin süreci başlattığını, kimlik doğrulamanın tamamlandığını ve hesap API'sine erişilebildiğini kanıtlar. Yazma testi için, tek kullanımlık bir not oluşturun ve ardından onu yumuşak silme ile silin.

MCP istemcinizin gösterdiği kesin araç listesi, kurulu sürüm için doğruluk kaynağıdır. Araçlar şu iş akışları etrafında gruplandırılmıştır:

İş akışı Tipik araçlar Önemli davranış
Notlar list_notes, create_note, read_note, update_note, search_notes update_note gövdenin tamamını değiştirir; düzenlemeden önce okuyun
İş günlükleri save_done Tamamlanan işi otomatik olarak bugünün proje klasörüne kaydeder
Çalışma alanları list_workspaces, create_workspace, update_workspace Bağlı bir proje yolu, sunucunun doğru çalışma alanını bulmasını sağlar
Zamanlanmış iş list_scheduled_bridges, create_scheduled_task, list_scheduled_task_runs Bir PandaPaw makinesi çevrimiçi olmalıdır; cron ifadeleri altı alan kullanır
Sağlayıcılar ve modeller list_providers, list_models, oluşturma/güncelleme/silme araçları Geçerli kimlikleri ve geçerli model türlerini kullanmak için önce listeleyin
Kurallar ve beceriler sync_rules Desteklenen proje talimatlarını değiştirilmemiş dosyaları atlayarak eşitler

Sağlayıcı ve model alan tanımları için Özel yapay zeka sağlayıcıları ve API keys bölümüne bakın. Hesap ve faturalandırma sınırları için PandaNpc hesapları, planları ve API maliyetleri bölümüne bakın.

Güvenli çalışma uygulamaları

  • Oluşturma, güncelleme, silme veya zamanlama işlemlerinden önce liste, okuma veya arama araçlarıyla başlayın.
  • Bir notu güncellemeden önce okuyun çünkü not güncellemeleri bir yama uygulamak yerine Markdown belgesinin tamamını değiştirir.
  • Zamanlanmış istemleri kod yürütme istekleri olarak ele alın: hedef makineyi, çalışma dizinini, saat dilimini ve altı alanlı cron ifadesini doğrulayın.
  • Sağlayıcı API keys'lerini istemlerden ve notlardan uzak tutun. Sırları yalnızca amaçlanan sağlayıcı yapılandırma akışı aracılığıyla girin.
  • Yıkıcı veya harici eylemlere izin vermeden önce MCP araç onay kartını inceleyin.
  • İş günlükleri için doğru çalışma alanını ve tarih klasörünü elle tahmin etmek yerine save_done kullanın.

Sorun giderme

İstemci `pandanpc-mcp` bulunamadı diyor

Kurulumdan sonra yeni bir terminal açın ve yürütülebilir dosya yolunu kontrol edin. Masaüstü uygulamaları bazen daha eski bir PATH devralır; mutlak yolu yapılandırın veya uygulamayı yeniden başlatın. npm bir sürüm yöneticisi aracılığıyla kurulduysa, MCP istemcisinin aynı kullanıcı ve ortam altında başladığından emin olun.

Sunucu kayıtlı ancak hiçbir araç görünmüyor

İstemciyi yeniden başlatın, ardından claude mcp get pandanpc veya codex mcp get pandanpc çıktısını inceleyin. Komut yanlışsa girişi kaldırıp tekrar ekleyin. Ayrıca yerel stdio sürecini bir HTTP URL'si olarak yapılandırmadığınızı kontrol edin.

Araçlar kimliğinizin doğrulanmadığını söylüyor

İki note_login çağrısını tekrarlayın. En yeni doğrulama kodunu kullanın, spam klasörünü kontrol edin ve her iki çağrının da aynı e-posta adresini kullandığından emin olun.

Zamanlanmış görevler bir makine bulamıyor

Önce list_scheduled_bridges çağrısını yapın. Kullanılabilir bir cihaz döndürmezse, hedef makinede PandaPaw durumunu ve cihaz bağlantısını doğrulayın. Kapalı, uyuyan, oturumu kapatılmış veya bağlantısı kesilmiş bir makine zamanlanmış bir çalıştırmayı başlatamaz.

Bir not güncellemesi mevcut metni kaldırdı

update_note tam değiştirme gövdesini kabul eder. Notu, varsa geçmişinden veya çöp kutusundan geri yükleyin, ardından geçerli içeriği okuyun ve birleştirilmiş belgeyi gönderin.

Hesaba özel yardıma mı ihtiyacınız var? support@pandanpc.com adresiyle iletişime geçin ve MCP istemci adını, işletim sistemini, paket sürümünü ve sır içermeyen tam hata mesajını ekleyin.