Desktop Extensions: Claude Desktop üçün bir kliklə MCP server quraşdırılması

Məzmun:

—

Keçən il Model Context Protocol (MCP) buraxanda gördük ki, developerlər Claude-a fayl sistemlərindən verilənlər bazalarına qədər hər şeyə giriş imkanı verən möhtəşəm lokal serverlər yaradırlar. Lakin eyni rəyi davamlı eşidirdik: quraşdırma çox mürəkkəb idi. İstifadəçilərin developer alətlərinə ehtiyacı var idi, konfiqurasiya fayllarını əl ilə redaktə etməli idilər və tez-tez asılılıq problemləri ilə üzləşirdilər.

Bu gün biz Desktop Extensions-u təqdim edirik — MCP serverlərinin quraşdırılmasını bir düyməyə basmaq qədər sadə edən yeni paketləmə formatı.

MCP quraşdırma probleminin həlli

Lokal MCP serverləri Claude Desktop istifadəçiləri üçün güclü imkanlar açır. Onlar lokal tətbiqlərlə qarşılıqlı əlaqə qura, şəxsi məlumatlara daxil ola və inkişaf alətləri ilə inteqrasiya edə bilərlər — bütün bunlar məlumatları istifadəçinin kompüterində saxlayaraq. Lakin mövcud quraşdırma prosesi əhəmiyyətli maneələr yaradır:

  • Developer alətləri tələb olunur: İstifadəçilərin Node.js, Python və ya digər runtime-lar quraşdırılmış olmalıdır
  • Əl ilə konfiqurasiya: Hər server JSON konfiqurasiya fayllarının redaktəsini tələb edir
  • Asılılıq idarəetməsi: İstifadəçilər paket konfliktlərini və versiya uyğunsuzluqlarını həll etməlidirlər
  • Kəşf mexanizmi yoxdur: Faydalı MCP serverlərini tapmaq üçün GitHub-da axtarış aparmaq lazımdır
  • Yeniləmə mürəkkəbliyi: Serverləri aktual saxlamaq əl ilə yenidən quraşdırma tələb edir

Bu sürtünmə nöqtələri o demək idi ki, MCP serverləri güclərinə baxmayaraq, texniki biliyə malik olmayan istifadəçilər üçün əsasən əlçatmaz qalırdı.

Desktop Extensions-un təqdimatı

Desktop Extensions (.mcpb faylları) bütün MCP serverini — bütün asılılıqlar daxil olmaqla — tək bir quraşdırıla bilən paketə yığaraq bu problemləri həll edir. İstifadəçilər üçün nə dəyişir:

Əvvəl:

# Əvvəlcə Node.js quraşdırın 
npm install -g @example/mcp-server 
# ~/.claude/claude_desktop_config.json faylını əl ilə redaktə edin 
# Claude Desktop-u yenidən başladın 
# Ümid edin ki, işləyəcək

Sonra:

  1. .mcpb faylını yükləyin
  2. Claude Desktop ilə açmaq üçün iki dəfə klikləyin
  3. "Install" düyməsinə basın

Vəssalam. Terminal yoxdur, konfiqurasiya faylları yoxdur, asılılıq konfliktləri yoxdur.

Arxitektura icmalı

Desktop Extension, lokal MCP serverini, eləcə də Claude Desktop və desktop extension-ları dəstəkləyən digər tətbiqlərin bilməli olduğu hər şeyi təsvir edən manifest.json faylını özündə saxlayan zip arxividir.

$18

Desktop Extension-da tələb olunan yeganə fayl manifest.json-dur. Claude Desktop bütün mürəkkəbliyi öz üzərinə götürür:

  • Daxili runtime: Xarici asılılıqları aradan qaldırmaq üçün Node.js-i Claude Desktop ilə birlikdə göndəririk
  • Avtomatik yeniləmələr: Yeni versiyalar mövcud olduqda extension-lar avtomatik yenilənir
  • Təhlükəsiz sirlər: API açarları kimi həssas konfiqurasiya ƏS keychain-ində saxlanılır

Manifest insanlar tərəfindən oxuna bilən məlumatları (ad, təsvir və ya müəllif kimi), xüsusiyyətlərin bəyannaməsini (alətlər, prompt-lar), istifadəçi konfiqurasiyasını və runtime tələblərini ehtiva edir. Əksər sahələr isteğe bağlıdır, ona görə minimal versiya olduqca qısadır, baxmayaraq ki, praktikada hər üç dəstəklənən extension növünün (Node.js, Python və klassik binary/icra edilə bilən fayllar) faylları daxil edəcəyini gözləyirik:

$19

Lokal MCP serverlərinin quraşdırılmasını və konfiqurasiyasını asanlaşdırmaq məqsədi daşıyan bir sıra rahat seçimlər manifest spesifikasiyasında mövcuddur. Server konfiqurasiya obyekti həm template literal-lar şəklində istifadəçi tərəfindən müəyyənləşdirilən konfiqurasiyaya, həm də platforma-spesifik üstünlüklərə yer verəcək şəkildə təyin edilə bilər. Extension developerləri istifadəçilərdən hansı növ konfiqurasiya toplamaq istədiklərini ətraflı şəkildə müəyyənləşdirə bilərlər.

Gəlin manifest-in konfiqurasiyaya necə kömək etdiyinə dair konkret bir nümunəyə baxaq. Aşağıdakı manifest-də developer istifadəçinin api_key təqdim etməli olduğunu bəyan edir. Claude istifadəçi həmin dəyəri təqdim edənə qədər extension-ı aktiv etməyəcək, onu avtomatik olaraq əməliyyat sisteminin sir saxlancında saxlayacaq və serveri işə salarkən ${user_config.api_key} ifadəsini istifadəçinin təqdim etdiyi dəyərlə şəffaf şəkildə əvəz edəcək. Eynilə, ${__dirname} extension-ın açılmış qovluğunun tam yolu ilə əvəz olunacaq.

{
  "mcpb_version": "0.1",
  "name": "my-extension",
  "version": "1.0.0",
  "description": "Sadə bir MCP extension",
  "author": {
    "name": "Extension Müəllifi"
  },
  "server": {
    "type": "node",
    "entry_point": "server/index.js",
    "mcp_config": {
      "command": "node",
      "args": ["${__dirname}/server/index.js"],
      "env": {
        "API_KEY": "${user_config.api_key}"
      }
    }
  },
  "user_config": {
    "api_key": {
      "type": "string",
      "title": "API Açarı",
      "description": "Autentifikasiya üçün API açarınız",
      "sensitive": true,
      "required": true
    }
  }
}

İsteğe bağlı sahələrin əksəriyyəti daxil edilmiş tam manifest.json belə görünə bilər:

$1a

Extension və manifest nümunəsi üçün MCPB repozitoriyasındakı nümunələrə müraciət edin.

manifest.json-dakı bütün tələb olunan və isteğe bağlı sahələrin tam spesifikasiyasını açıq mənbəli alətlər dəstimizin bir hissəsi olaraq tapa bilərsiniz.

İlk extension-unuzun yaradılması

Gəlin mövcud bir MCP serverini Desktop Extension olaraq paketləməni addım-addım nəzərdən keçirək. Nümunə olaraq sadə bir fayl sistemi serverindən istifadə edəcəyik.

Addım 1: Manifest yaradın

Əvvəlcə serveriniz üçün manifest-i işə salın:

npx @anthropic-ai/mcpb init

Bu interaktiv alət serveriniz haqqında suallar verir və tam manifest.json yaradır. Ən sadə manifest.json-a sürətlə çatmaq istəyirsinizsə, əmri --yes parametri ilə işə sala bilərsiniz.

Addım 2: İstifadəçi konfiqurasiyasını idarə edin

Əgər serverinizə istifadəçi daxiletməsi lazımdırsa (API açarları və ya icazə verilmiş qovluqlar kimi), bunu manifest-də bəyan edin:

"user_config": {
  "allowed_directories": {
    "type": "directory",
    "title": "İcazə Verilmiş Qovluqlar",
    "description": "Serverin daxil ola biləcəyi qovluqlar",
    "multiple": true,
    "required": true,
    "default": ["${HOME}/Documents"]
  }
}

Claude Desktop:

  • İstifadəçi dostu konfiqurasiya interfeysi göstərəcək
  • Extension-ı aktiv etməzdən əvvəl daxiletmələri doğrulayacaq
  • Həssas dəyərləri təhlükəsiz saxlayacaq
  • Developer konfiqurasiyasından asılı olaraq konfiqurasiyanı serverinizə ya arqument, ya da mühit dəyişəni kimi ötürəcək

Aşağıdakı nümunədə istifadəçi konfiqurasiyasını mühit dəyişəni kimi ötürürük, lakin bu həmçinin arqument ola bilər.

"server": {
   "type": "node",
   "entry_point": "server/index.js",
   "mcp_config": {
   "command": "node",
   "args": ["${__dirname}/server/index.js"],
   "env": {
      "ALLOWED_DIRECTORIES": "${user_config.allowed_directories}"
   }
   }
}

Addım 3: Extension-u paketləyin

Hər şeyi .mcpb faylına yığın:

npx @anthropic-ai/mcpb pack

Bu əmr:

  1. Manifest-inizi doğrulayır
  2. .mcpb arxivini yaradır

Addım 4: Lokal olaraq test edin

.mcpb faylınızı Claude Desktop-un Parametrlər pəncərəsinə sürükləyin. Görəcəksiniz:

  • Extension-unuz haqqında insan tərəfindən oxuna bilən məlumat
  • Tələb olunan icazələr və konfiqurasiya
  • Sadə "Install" düyməsi

Təkmilləşdirilmiş xüsusiyyətlər

Çarpaz-platforma dəstəyi

Extension-lar müxtəlif əməliyyat sistemlərinə uyğunlaşa bilər:

"server": {
  "type": "node",
  "entry_point": "server/index.js",
  "mcp_config": {
    "command": "node",
    "args": ["${__dirname}/server/index.js"],
    "platforms": {
      "win32": {
        "command": "node.exe",
        "env": {
          "TEMP_DIR": "${TEMP}"
        }
      },
      "darwin": {
        "env": {
          "TEMP_DIR": "${TMPDIR}"
        }
      }
    }
  }
}

Dinamik konfiqurasiya

Runtime dəyərləri üçün template literal-lardan istifadə edin:

  • ${__dirname}: Extension-ın quraşdırma qovluğu
  • ${user_config.key}: İstifadəçi tərəfindən təqdim edilən konfiqurasiya
  • ${HOME}, ${TEMP}: Sistem mühit dəyişənləri

Xüsusiyyət bəyannaməsi

İstifadəçilərə imkanları əvvəlcədən anlamağa kömək edin:

"tools": [
  {
    "name": "read_file",
    "description": "Faylın məzmununu oxuyun"
  }
],
"prompts": [
  {
    "name": "code_review",
    "description": "Kodu ən yaxşı təcrübələrə görə nəzərdən keçirin",
    "arguments": ["file_path"]
  }
]

Extension kataloqu

Biz Claude Desktop-a daxil edilmiş kuratorluq edilmiş extension kataloqu ilə başlayırıq. İstifadəçilər bir kliklə gözdən keçirə, axtarış apara və quraşdıra bilərlər — GitHub-da axtarış aparmadan və ya kodu yoxlamadan.

Həm Desktop Extension spesifikasiyasının, həm də macOS və Windows üçün Claude-dakı tətbiqin zamanla təkamül edəcəyini gözləsək də, extension-ların Claude-un imkanlarını yaradıcı yollarla genişləndirmək üçün istifadə ediləcəyi çoxsaylı üsulları görməyi səbirsizliklə gözləyirik.

Extension-unuzu təqdim etmək üçün:

  1. Təqdimetmə formasında olan təlimatlara uyğun olduğundan əmin olun
  2. Windows və macOS-da test edin
  3. Extension-unuzu təqdim edin
  4. Komandamız keyfiyyət və təhlükəsizlik baxımından nəzərdən keçirir

Açıq ekosistem qurmaq

Biz MCP serverləri ətrafındakı açıq ekosistemə sadiqik və onun bir çox tətbiq və xidmət tərəfindən universal şəkildə qəbul edilmə qabiliyyətinin cəmiyyətə fayda verdiyinə inanırıq. Bu öhdəliyə uyğun olaraq, Desktop Extension spesifikasiyasını, alətlər dəstini və macOS və Windows üçün Claude-un Desktop Extensions dəstəyini tətbiq etmək üçün istifadə etdiyi sxemləri və əsas funksiyaları açıq mənbə olaraq paylaşırıq. Ümidimiz budur ki, MCPB formatı yalnız Claude üçün deyil, digər AI masaüstü tətbiqləri üçün də lokal MCP serverlərini daha portativ edəcək.

Açıq mənbə olaraq paylaşdıqlarımız:

  • Tam MCPB spesifikasiyası
  • Paketləmə və doğrulama alətləri
  • İstinad tətbiqi kodu
  • TypeScript tipləri və sxemləri

Bu o deməkdir ki:

  • MCP server developerləri üçün: Bir dəfə paketləyin, MCPB dəstəkləyən hər yerdə işlədin
  • Tətbiq developerləri üçün: Sıfırdan qurmadan extension dəstəyi əlavə edin
  • İstifadəçilər üçün: Bütün MCP-dəstəkli tətbiqlərdə ardıcıl təcrübə

Spesifikasiya və alətlər dəsti qəsdən 0.1 versiyası olaraq versiyalanıb, çünki formatın təkamülü və dəyişdirilməsi üzərində daha geniş cəmiyyətlə işləməyi səbirsizliklə gözləyirik. Sizdən eşitməyi gözləyirik.

Təhlükəsizlik və müəssisə mülahizələri

Başa düşürük ki, extension-lar yeni təhlükəsizlik mülahizələri gətirir, xüsusilə müəssisələr üçün. Desktop Extensions-un ön baxış buraxılışı ilə bir neçə qoruma tədbirini daxil etmişik:

İstifadəçilər üçün

  • Həssas məlumatlar ƏS keychain-ində qalır
  • Avtomatik yeniləmələr
  • Hansı extension-ların quraşdırıldığını yoxlama imkanı

Müəssisələr üçün

  • Group Policy (Windows) və MDM (macOS) dəstəyi
  • Təsdiqlənmiş extension-ları əvvəlcədən quraşdırma imkanı
  • Xüsusi extension-ları və ya naşirləri bloklama
  • Extension kataloqunu tamamilə deaktiv etmə
  • Şəxsi extension kataloqularının yerləşdirilməsi

Extension-ları təşkilatınızda necə idarə edəcəyiniz haqqında daha ətraflı məlumat üçün sənədləşdirməmizə baxın.

Başlamaq

Öz extension-unuzu qurmağa hazırsınız? Başlamaq üçün:

MCP server developerləri üçün: Developer sənədləşdirməmizi nəzərdən keçirin — və ya birbaşa lokal MCP serverlərinizin qovluğunda aşağıdakı əmrləri işə salaraq başlayın:

npm install -g @anthropic-ai/mcpb
mcpb init
mcpb pack

Claude Desktop istifadəçiləri üçün: Ən son versiyaya yeniləyin və Parametrlərdə Extensions bölməsinə baxın

Müəssisələr üçün: Yerləşdirmə seçimləri üçün müəssisə sənədləşdirməmizi nəzərdən keçirin

Claude Code ilə qurmaq

Anthropic daxilində biz aşkar etdik ki, Claude minimal müdaxilə ilə extension qurmaqda əladır. Əgər siz də Claude Code istifadə etmək istəyirsinizsə, tövsiyə edirik ki, extension-unuzun nə etməsini istədiyinizi qısaca izah edəsiniz və sonra prompt-a aşağıdakı konteksti əlavə edəsiniz:

$1b

Nəticə

Desktop Extensions istifadəçilərin lokal AI alətləri ilə qarşılıqlı əlaqəsində fundamental dəyişikliyi təmsil edir. Quraşdırma sürtünməsini aradan qaldıraraq, güclü MCP serverlərini hər kəs üçün — yalnız developerlər üçün deyil — əlçatan edirik.

Daxili olaraq, biz yüksək eksperimental MCP serverlərini paylaşmaq üçün desktop extension-lardan istifadə edirik — bəziləri əyləncəli, bəziləri faydalı. Bir komanda modellərimizin birbaşa GameBoy-a qoşulduqda nə qədər irəli gedə biləcəyini görmək üçün təcrübə apardı — bu "Claude Pokémon oynayır" araşdırmasımıza bənzəyir. Biz populyar PyBoy GameBoy emulyatorunu açan və Claude-a nəzarəti verən tək bir extension-u paketləmək üçün Desktop Extensions-dan istifadə etdik. İnanırıq ki, modelin imkanlarını istifadəçilərin lokal maşınlarında artıq mövcud olan alətlərə, məlumatlara və tətbiqlərə bağlamaq üçün saysız-hesabsız fürsət mövcuddur.

PyBoy MCP ilə Super Mario Land başlanğıc ekranını göstərən masaüstü

Nə quracağınızı görməyi səbirsizliklə gözləyirik. Bizə minlərlə MCP server gətirən eyni yaradıcılıq indi yalnız bir kliklə milyonlarla istifadəçiyə çata bilər. MCP serverinizi paylaşmağa hazırsınız? Extension-unuzu nəzərdən keçirmə üçün təqdim edin.

{{relatedArticles}}