İçeriğe geç
Pathrule

dokümanlar

Pathrule Remote MCP

HTTP MCP istemcinizi cloud.pathrule.io/mcp adresinden Cloud çalışma alanınıza bağlayın. Yerel kurulum gerektirmeyen, OAuth kapsamlı bilgi erişimi; araç ve dosya sistemi sınırları açıkça belirlidir.

Bu sayfada

Barındırılan bir MCP istemcisini https://cloud.pathrule.io/mcp adresine bağlayarak bir Pathrule Cloud çalışma alanındaki bilgiyi okuyabilir ve yazabilirsiniz. Bağlantı Streamable HTTP ve PKCE ile OAuth 2.1 kullanır. Bunun için bir Pathrule hesabına ve onaylayacağınız çalışma alanına erişiminizin olması gerekir.

Bağlanma

https://app.pathrule.io adresinde hesap oluşturun ya da giriş yapın, ardından MCP istemcinizi bağlayın:

claude mcp add --transport http pathrule https://cloud.pathrule.io/mcp
codex mcp add pathrule --url https://cloud.pathrule.io/mcp

Claude.ai veya başka bir HTTP MCP istemcisi için de aynı uç noktayı kullanın. Yetkilendirme akışını tamamlayın ve istemcinin istediği çalışma alanını ve kapsamları onaylayın.

Keşif

  • MCP: https://cloud.pathrule.io/mcp
  • Yetkilendirme sunucusu: https://cloud.pathrule.io/.well-known/oauth-authorization-server
  • Korunan kaynak: https://cloud.pathrule.io/.well-known/oauth-protected-resource/mcp

Araçlar ve yetkiler

Okuma yetkisi pathrule_get_context aracını ve hafıza kayıtları, kurallar ve beceriler için listeleme ve okuma araçlarını sunar. Yazma yetkisi bunlara ek olarak oluşturma, güncelleme, silme ve öğe bazında geçmiş araçlarını da açar. Erişim, yetkinin ait olduğu çalışma alanıyla sınırlıdır; başka bir çalışma alanı kimliği vermek bu sınırı genişletmez.

Uzak yazma işlemleri title, body ve kanonik bir path kullanır. Güncellemeler bir öğe id değeri ve sayısal bir expectedVersion ister. Değişiklik işlemleri sabit bir operation_id veya idempotency anahtarı gerektirir; böylece bir işlemi yeniden denemek ikinci bir kopya oluşturmaz. Bunlar uzak şemalardır, yerel sunucunun content_edit ve expected_version_id şemalarıyla aynı değildir. Kullanmadan önce bağlı sunucudan tools/list isteyin.

Yetkilendirme sunucusu pathrule:read, pathrule:write, pathrule:refresh ve pathrule:activity kapsamlarını tanır. Bir kapsamın tanınması, karşılık gelen bir aracın var olduğu anlamına gelmez: mevcut uzak katalog bilgi ve bağlamı kapsar. Organizasyon yönetimi, çalışma alanı oluşturma, snapshot'lar, yerel proje öğrenimi, kalıp içe aktarma, etkinlik kaydı ve yenileme iş akışları için CLI, yerel MCP araçları veya Cloud konsolu kullanılır.

İzinler her zaman günceldir

Sunucu, erişimi yetkilendirirken ve bir aracı çalıştırırken oturumunuzu, çalışma alanının durumunu ve üyeliğinizi kontrol eder. Bir çalışma alanından çıkarılmanız, çalışma alanının arşivlenmesi veya silinmesi o alana ait yetkileri iptal eder. Çalışma alanını geri yüklemek bu yetkileri geri getirmez; yeniden bağlanıp erişimi tekrar onaylamanız gerekir. Refresh token'lar düzenli olarak yenisiyle değiştirilir ve daha önce değiştirilmiş bir token'ı yeniden kullanmak, o token'ın ait olduğu token ailesini iptal eder.

Yerel iletim

Remote MCP dosya sisteminizi okuyamaz, hook kuramaz, eşlik eden dosyaları yazamaz ve yerel kişisel tercihlerinizi gönderemez. Ajanın bağlam alabilmesi için araçlarını çağırması gerekir. Depoyu tanıyan bağlamın ve hook'ların ajana işe başlamadan önce gelmesini istiyorsanız CLI'ı veya VS Code'u kullanın.