क्या Serena MCP सुरक्षित है? टोकन उपयोग और Claude Code सेटअप

Serena MCP सुरक्षित है, अगर आप इसे किसी भी ऐसे टूल की तरह देखें जो आपका कोड एडिट कर सकता है, क्योंकि असल में यह वही है। सर्वर आपकी अपनी मशीन पर चलता है, इसका सोर्स सार्वजनिक है, और claude-code कॉन्टेक्स्ट में इसका शेल टूल बंद रहता है। असली सवाल ज़्यादा सीमित हैं: यह डिस्क पर क्या लिख सकता है, बाहर क्या भेजता है, और आपके एक भी प्रॉम्प्ट टाइप करने से पहले यह कितने टोकन खर्च कर देता है? यह लेख तीनों का जवाब देता है, सटीक कमांड, कॉन्फ़िग के नाम और रोलआउट का क्रम देते हुए, जिसे आप आज ही फ़ॉलो कर सकते हैं।

स्रोतों के बारे में एक छोटी सी बात। नीचे दी गई कमांड और सेटिंग्स Serena की रिपॉज़िटरी और उसके क्लाइंट सेटअप पेज से ली गई हैं। टोकन के आँकड़े एक थर्ड-पार्टी रैपर और एक सिक्योरिटी लेख से आए हैं, और मैंने उन्हें ऐसा ही लेबल किया है। किसी भी नंबर पर भरोसा करने से पहले अपने सेटअप पर खुद मापें, मेरे नंबर पर भी।

Serena असल में क्या करता है

Oraios द्वारा बनाया गया Serena एक MCP सर्वर है, जो कोडिंग एजेंट को IDE-जैसे टूल देता है। पूरी फ़ाइलें पढ़ने और टेक्स्ट मिलाने के बजाय एजेंट सिंबल माँगता है: क्लास, फ़ंक्शन, मेथड और वे जगहें जहाँ उन्हें रेफ़र किया गया है। रिपॉज़िटरी में रिट्रीवल टूल (find symbol, symbol overview, find referencing symbols), सिंबॉलिक एडिटिंग (किसी सिंबल की बॉडी बदलना, किसी सिंबल से पहले या बाद में इन्सर्ट करना), regex सर्च, फ़ाइल ऑपरेशन, शेल एग्ज़िक्यूशन और एक पर्सिस्टेंट मेमोरी सिस्टम सूचीबद्ध हैं। लैंग्वेज सपोर्ट लैंग्वेज सर्वर के ज़रिए 40 से ज़्यादा भाषाओं तक जाता है।

इससे किसे फ़ायदा होता है? उन्हें जो ऐसी रिपॉज़िटरी पर काम करते हैं जो एक प्रॉम्प्ट में नहीं समा सकती: मल्टी-मॉड्यूल बैकएंड, मोनोरेपो, लंबे समय से चल रहे ऐप जहाँ एक रीनेम तीस फ़ाइलों को छू लेता है। अगर आपका प्रोजेक्ट कुछ स्क्रिप्ट्स भर है, तो Claude Code के सादे टूल पहले से काफ़ी हैं, और सर्वर जोड़ने से ज़्यादातर बस सतह क्षेत्र बढ़ता है। सुरक्षित है या नहीं, यह पूछने से पहले समस्या के आकार के हिसाब से टूल चुनें।

सिंबल, कच्चे टेक्स्ट की जगह

एक सादा एजेंट टेक्स्ट सर्च करके फ़ंक्शन ढूँढता है, फिर पक्का करने के लिए आसपास की फ़ाइलें पढ़ता है कि उसे सही फ़ंक्शन मिला है। Serena इसके बजाय लैंग्वेज सर्वर से पूछता है, इसलिए जवाब फ़ाइलों का ढेर नहीं, बल्कि परिभाषा खुद होता है।

कोड कहाँ रहता है

Claude Code Serena को एक लोकल प्रोसेस के रूप में लॉन्च करता है, और लैंग्वेज सर्वर भी लोकली चलते हैं। Serena कोई होस्टेड सर्विस नहीं है, और सार्वजनिक डॉक्स जहाँ तक दिखाते हैं, कोई Serena क्लाउड नहीं है जो आपकी रिपॉज़िटरी प्राप्त करे। एक बात खुलकर कहने लायक है: Serena टूल जो भी लौटाता है वह Claude के कॉन्टेक्स्ट में जाता है, और वह कॉन्टेक्स्ट बाकी हर टूल रिज़ल्ट की तरह मॉडल API तक जाता है। Serena सेशन को ज़्यादा प्राइवेट नहीं बनाता। वह रीड को छोटा और ज़्यादा सटीक बनाता है।

क्या Serena MCP सुरक्षित है?

अपनी रिपॉज़िटरी पर काम करने वाले ज़्यादातर डेवलपर्स के लिए, शर्तों के साथ, हाँ। जोखिम आम किस्म के हैं, और हर एक के लिए कुछ मिनटों में सेट होने वाला कंट्रोल है।

खतरे के मॉडल से शुरू करें। आपको इस बात की चिंता नहीं है कि कोई अनजान व्यक्ति Serena में घुस जाए। आपको तीन शांत खतरों की चिंता है: एजेंट ऐसी फ़ाइलें बदल दे जिन्हें आपने बदलने के लिए नहीं कहा था, एजेंट ऐसा कमांड चला दे जिसे आपने चलाने के लिए नहीं कहा था, और किसी फ़ाइल के अंदर का टेक्स्ट एजेंट को इनमें से कोई भी करने के लिए राज़ी कर ले। आख़िरी खतरे को प्रॉम्प्ट इंजेक्शन कहते हैं, और यह हर उस टूल पर लागू होता है जो अविश्वसनीय कंटेंट पढ़ता है। क्लोन की हुई रिपॉज़िटरी, डाउनलोड की गई डिपेंडेंसी या चिपकाया गया इश्यू, इन सबमें मॉडल को संबोधित कोई वाक्य हो सकता है, आपको नहीं। एक छोटी टूल सूची और लिखने से पहले परमिशन प्रॉम्प्ट सबसे अच्छा बचाव है, क्योंकि ये हाईजैक किए गए निर्देश की पहुँच सीमित कर देते हैं।

ओपन सोर्स वाला हिस्सा

Serena का एप्लिकेशन कोड GPL-3.0-or-later है, और उसके साथ आने वाली SolidLSP लेयर MIT है। ओपन कोड का मतलब है कि आप ठीक-ठीक पढ़ सकते हैं कि आपकी मशीन पर क्या चल रहा है, जो एक असली सुरक्षा गुण है। अपनी रिपॉज़िटरी पर GPL टूल चलाने से आपकी रिपॉज़िटरी का लाइसेंस नहीं बदलता। लाइसेंस तब मायने रखने लगता है जब आप Serena में बदलाव करके उसे दूसरों तक पहुँचाते हैं, और उस समय आपको ब्लॉग से नहीं, वकील से पूछना चाहिए।

शेल टूल की समस्या

इस सेट का सबसे खतरनाक टूल execute_shell_command है। Serena पर एक सिक्योरिटी लेख इसे सबसे खतरनाक क्षमता बताता है, जिसकी विफलता के तरीके हैं अनचाहा फ़ाइल डिलीशन, लीक हुए क्रेडेंशियल और बिगड़ा हुआ सिस्टम कॉन्फ़िगरेशन, और सुझाव देता है कि इसे लोकल काम के बजाय CI एनवायरनमेंट के लिए रखें।

claude-code कॉन्टेक्स्ट इसे पहले से हटा देता है। वह कॉन्टेक्स्ट छह टूल बाहर रखता है: create_text_file, read_file, execute_shell_command, find_file, list_dir और search_for_pattern। कारण डर नहीं है। Claude Code के अपने फ़ाइल और शेल टूल हैं, इसलिए Serena उन पर पीछे हट जाता है और सिंबल का काम अपने पास रखता है।

💡 Serena का शेल टूल बाहर रखने से सेशन की शेल क्षमता खत्म नहीं होती। Claude Code का अपना Bash टूल फिर भी मौजूद है, लेकिन वह Claude Code के परमिशन प्रॉम्प्ट से होकर चलता है, और यही वह जगह है जहाँ आप वह फ़ैसला रखना चाहते हैं।

टेलीमेट्री और नेटवर्क कॉल

Serena गुमनाम उपयोग रिपोर्टिंग के लिए एक ऑप्ट-आउट दस्तावेज़ करता है: सर्वर लॉन्च करने वाले एनवायरनमेंट में SERENA_USAGE_REPORTING=false सेट करें। लैंग्वेज सर्वर अलग प्रोग्राम हैं, और भाषा के हिसाब से, किसी एक को पहली बार इस्तेमाल करते समय डाउनलोड करना पड़ सकता है। किसी नई भाषा पर पहली बार चलाते समय थोड़ी नेटवर्क गतिविधि की उम्मीद करें, और अगर आपका एनवायरनमेंट सख्त है तो फ़ायरवॉल लॉग देखें।

असली सेशन में टोकन उपयोग

Serena दो तरीकों से टोकन खर्च करता है। फ़िक्स्ड कॉस्ट वे टूल डेफ़िनिशन हैं जो हर सेशन में लोड होते हैं। वेरिएबल कॉस्ट वह है जो टूल काम के दौरान लौटाते हैं। पहला अनुमान लगाने योग्य है, और दूसरा इस पर निर्भर करता है कि आप कैसे काम करते हैं।

टोकन कहाँ जाते हैं

रैपर प्रोजेक्ट serena-slim अनुमान लगाता है कि मूल Serena 29 टूल लोड करता है, जिनकी कीमत Claude Code में लगभग 23,878 टोकन है, और उसका समूहित वर्ज़न, जिसमें 18 ऑपरेशन हैं, इसे लगभग 11,874 टोकन तक ले आता है। यह एक थर्ड-पार्टी रैपर का वेंडर आँकड़ा है, आपके इंस्टॉल का माप नहीं। claude-code कॉन्टेक्स्ट में छह टूल पहले से बाहर रखे गए हैं, इसलिए आपका नंबर मूल से शायद कम होगा।

खुद मापें। सर्वर जोड़ने से पहले और बाद में Claude Code में /context चलाएँ, और MCP tools वाली लाइन की तुलना करें। वह एक तुलना इस लेख के किसी भी अनुमान से बेहतर है।

फ़िक्स्ड कॉस्ट क्यों मायने रखती है, यह समझने के लिए यह गणित है, माप नहीं। मान लें डेफ़िनिशन 12,000 टोकन लेते हैं और आप दिन में 20 सेशन खोलते हैं। यह किसी एक सवाल के पूछे जाने से पहले ही 240,000 टोकन का ओवरहेड है। पेलोड आधा कर दें तो हर दिन उतनी ही बचत होती है, चाहे उस सेशन में Serena अपनी जगह कमाए या न कमाए।

वेरिएबल कॉस्ट तीन हिस्सों में बँटी है:

• Symbol overview नाम और स्थान लौटाता है, बॉडी नहीं, इसलिए बड़ी फ़ाइल में दिशा पाना उसे पूरा पढ़ने से कहीं सस्ता पड़ता है।
• हर जगह इस्तेमाल होने वाले फ़ंक्शन पर Find referencing symbols लंबी सूची लौटा सकता है। बड़े कोडबेस पर सवाल ज़्यादा सीमित और सटीक पूछें।
• किसी नए प्रोजेक्ट पर ऑनबोर्डिंग में एजेंट कोड का सर्वे करता है और नोट्स को मेमोरी के रूप में सेव करता है। जब आप हल्का सेशन चाहते हैं, तब no-onboarding और no-memories मोड इसे बंद कर देते हैं।

Claude Code कॉन्टेक्स्ट क्यों मदद करता है

कॉन्टेक्स्ट स्टार्टअप पर चुने जाते हैं और सेशन के बीच में बदले नहीं जा सकते। डिफ़ॉल्ट desktop-app है, जो Claude Code से अलग क्लाइंट के लिए बना है। --context claude-code के बिना उम्मीद करें कि Claude Code के अपने टूल जैसे फ़ाइल टूल डुप्लिकेट होंगे, साथ में एक शेल टूल और एक बड़ा डेफ़िनिशन पेलोड, सब एक साथ। सेटअप के बाद /mcp टाइप करें और टूल सूची की तुलना ऊपर के छह बाहर रखे गए टूल से करें। एक फ़्लैग टोकन लागत और सुरक्षा जोखिम दोनों को एक साथ ठीक कर देता है।

स्लिम वेरिएंट और टूल सर्च

Claude Code MCP टूल डेफ़िनिशन को स्टार्टअप के बजाय टाल सकता है और माँग पर लोड कर सकता है। एक सेटअप लेख इसे ENABLE_TOOL_SEARCH=true से चालू करता है; अपने Claude Code वर्ज़न के रिलीज़ नोट्स देखें, क्योंकि स्विच अलग हो सकता है। एक स्लिम रैपर आपके और आपके कोड के बीच एक और थर्ड-पार्टी पैकेज जोड़ता है। बचाए गए टोकन को उस जोखिम के मुकाबले तौलें, क्योंकि बचत तभी मायने रखती है जब आप अतिरिक्त लेयर पर भरोसा करते हों।

Claude Code सेटअप, क़दम दर क़दम

पूरी प्रक्रिया में कुछ मिनट लगते हैं। uv एकमात्र पूर्व-आवश्यकता है।

इंस्टॉल और इनिशियलाइज़

uv tool install -p 3.13 serena-agent
serena init

प्रॉम्प्ट कॉपी करें

Serena उसी काम के लिए एक शॉर्टकट, serena setup claude-code, भी देता है। नीचे के मैन्युअल कमांड दिखाते हैं कि आप किस चीज़ से सहमत हो रहे हैं, इसलिए मैं पहली बार इन्हीं को पसंद करता हूँ।

सर्वर को हाथ से जोड़ें

एक ही प्रोजेक्ट के लिए, प्रोजेक्ट फ़ोल्डर से यह चलाएँ:

claude mcp add serena -- serena start-mcp-server --context claude-code --project "$(pwd)"

प्रॉम्प्ट कॉपी करें

मशीन के हर प्रोजेक्ट के लिए, ग्लोबल फ़ॉर्म है:

claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwd

प्रॉम्प्ट कॉपी करें

मैं प्रति-प्रोजेक्ट कमांड की सलाह देता हूँ। Claude Code इसे डिफ़ॉल्ट रूप से लोकल स्कोप में सेव करता है, इसलिए यह सिर्फ़ उसी प्रोजेक्ट पर लागू होता है, जबकि ग्लोबल फ़ॉर्म आपके खोले हुए किसी भी फ़ोल्डर में Serena चालू कर देता है, तो गलत डायरेक्टरी में भटका हुआ सेशन भी वही एडिटिंग टूल पा जाता है। claude mcp list से नतीजा जाँचें, या Claude Code के अंदर /mcp टाइप करें। अगर सर्वर शुरू होने में धीमा है, तो export MCP_TIMEOUT=60000 से टाइमआउट बढ़ाएँ।

💡 Windows पर ये कमांड PowerShell में चलाएँ, और अगर आपका शेल शिकायत करे तो "$(pwd)" की जगह "$PWD" लगाएँ। प्रोजेक्ट पाथ में बेवजह के कोट न रखें, क्योंकि गलत पाथ का मतलब है कि Serena गलत फ़ोल्डर एक्टिवेट कर देगा।

हुक्स और सिस्टम प्रॉम्प्ट

Serena के अपने डॉक्स चेतावनी देते हैं कि हाल के Claude Code और मॉडल अपडेट ने एजेंट की Serena के टूल से जुड़े निर्देशों को मानने की क्षमता कम कर दी है, और लंबे सेशन उनसे भटक सकते हैं। इसका समाधान है Claude Code को सिस्टम प्रॉम्प्ट ओवरराइड के साथ शुरू करना:

claude --system-prompt="$(serena prompts print-cc-system-prompt-override)"

प्रॉम्प्ट कॉपी करें

डॉक्स .claude/settings.json में रिमाइंडर हुक्स की भी ज़ोरदार सिफ़ारिश करते हैं, चार कमांड के साथ: remind, activate, cleanup और auto-approve। इन्हें जोड़ने से पहले पढ़ें कि auto-approve क्या करता है। कोई भी चीज़ जो आपके लिए टूल कॉल मंज़ूर करती है, उन क्षणों की संख्या घटा देती है जब आप ना कह सकते हैं।

पहले दिन से पहले लॉक करें

इसे क्रम से करें। हर चरण अगले चरण के लिए सबूत देता है।

रीड-ओनली से शुरू करें

Serena सेटिंग्स एक ग्लोबल फ़ाइल ~/.serena/serena_config.yml से पढ़ता है (Windows पर %USERPROFILE%\.serena\serena_config.yml), और एक project.yml से, जो एक प्रोजेक्ट के लिए उसे ओवरराइड करती है। दोनों में से किसी को serena config edit से खोलें। पहले सेशनों के लिए, प्रोजेक्ट फ़ाइल में यह सेट करें:

read_only: true

प्रॉम्प्ट कॉपी करें

इस मोड में Serena फ़ाइलें पढ़ सकता है, स्ट्रक्चर देख सकता है, सिंबल सर्च कर सकता है और इंडेक्स बना सकता है, पर लिख नहीं सकता। रीड्स वही जगह हैं जहाँ सिंबल टूल टोकन बचाते हैं, इसलिए यहाँ से शुरू करने में आप बहुत कम खोते हैं, और ऐसी कोई चीज़ नहीं छोड़ते जिसे आप बाद में चालू नहीं कर सकते।

डैशबोर्ड देखें

Serena एक लोकल डैशबोर्ड चलाता है, आमतौर पर http://localhost:24282/dashboard/index.html पर। सिक्योरिटी लेख सुझाता है कि लगभग एक दिन रीड-ओनली चलाएँ और देखें: कौन सी फ़ाइलें छुई जाती हैं, कौन से टूल कॉल होते हैं, और क्या एरर बार-बार आते हैं। अगर कोई ऐसा टूल चलता है जिसकी आपने उम्मीद नहीं की थी, तो आपको यह तब पता चलता है जब वह नुकसानरहित था।

टूल एक-एक करके खोलें

जब लॉग साफ़ दिखें, तो लिखने की अनुमति दें और शेल बाहर रखें। नीचे के नाम उसी थर्ड-पार्टी लेख से हैं, इसलिए उन्हें अपने Serena वर्ज़न की टूल सूची से मिलाएँ:

read_only: false
included_optional_tools:
  - edit_file
excluded_tools:
  - execute_shell_command

प्रॉम्प्ट कॉपी करें

हर सेशन से पहले साफ़ git ट्री कमिट करें। फिर git diff ठीक-ठीक दिखाता है कि Serena ने क्या बदला, और एक git restore कोई गलत एडिट वापस कर देता है। यह आदत ऊपर की किसी भी सेटिंग से ज़्यादा काम की है।

पहले हफ़्ते के लिए एक छोटी चेकलिस्ट:

• /mcp में पुष्टि करें कि Serena कनेक्टेड दिखता है और कोई शेल टूल नहीं है।
• /context चलाएँ और MCP tools वाला नंबर लिख लें।
• read_only: true तब तक रखें जब तक डैशबोर्ड उबाऊ न लगने लगे।
• हर उस सेशन के बाद git diff देखें जिसमें फ़ाइलें लिखी गई हों।
• .serena फ़ोल्डर एक बार खोलें और पढ़ें कि मेमोरी में क्या है।

PicassoIA पर अपना कॉन्फ़िग जाँचें

अपने कॉन्फ़िग पर दूसरी राय लेना सस्ता है। PicassoIA पर Claude Sonnet 5 कोड, कॉन्फ़िग और स्क्रीनशॉट पढ़ सकता है, इसलिए आप उसे लागू करने से पहले अपने project.yml की समीक्षा करवा सकते हैं।

कॉन्फ़िग की समीक्षा के छह क़दम

1. Claude Sonnet 5 मॉडल पेज खोलें।
2. कॉन्फ़िग से हर टोकन, पासवर्ड और निजी URL हटाएँ, फिर उसे Prompt में एक साफ़ सवाल के साथ चिपकाएँ, जैसे: "इस Serena project.yml की राइट एक्सेस और शेल एक्सपोज़र की समीक्षा करें। जोखिमों की एक टेबल दें और हर एक का समाधान बताएँ।"
3. Effort सेट करें। डिफ़ॉल्ट low है, जो तेज़ और सस्ता है। कई टूल वाले कॉन्फ़िग के लिए high लें, और सिर्फ़ उलझे हुए कॉन्फ़िग के लिए xhigh या max।
4. भूमिका तय करने के लिए System Prompt जोड़ें: "आप डेवलपर टूलिंग के सावधान समीक्षक हैं। साफ़-साफ़ बताएँ और छोटा लिखें।"
5. वैकल्पिक: डैशबोर्ड का स्क्रीनशॉट Image के रूप में जोड़ें। डिफ़ॉल्ट max_image_resolution 0.5 मेगापिक्सल है, जो पढ़ने लायक चार्ट के लिए काफ़ी है।
6. Max Tokens को 8,192 डिफ़ॉल्ट पर रखें, जब तक आपको लंबी रिपोर्ट न चाहिए, फिर हर दावे को Serena के डॉक्स से मिलाएँ।

💡 जवाब को समीक्षक की टिप्पणी मानें, फ़ैसला नहीं। दूसरा नज़रिया पाने के लिए वही प्रॉम्प्ट Claude Fable 5 या GPT 5.6 Sol पर चलाएँ और देखें कि वे कहाँ असहमत हैं।

आम गलतियाँ

Picasso IA पर अपनी इमेज बनाएँ

अगर आप अपने टूलिंग के बारे में लिखते हैं, तो काम का दूसरा हिस्सा आप जानते हैं: README, ब्लॉग पोस्ट और टॉक स्लाइड्स, सबको ऐसे विज़ुअल चाहिए जो उनके साथ सही लगें। Picasso IA इमेज मॉडल एक जगह रखता है, ताकि आप एक प्रॉम्प्ट आज़मा सकें, उसे बदलें और मिनटों में नतीजों की तुलना करें। फ़ोटोरियलिस्टिक दृश्यों के लिए Seedream 4.5 या FLUX 1.1 Pro से शुरू करें, फिर बाकी सब picassoia.com/en/all-models पर देखें।

किसी असली दृश्य का वर्णन करें, उसके लेंस, रोशनी की दिशा और टेक्सचर के साथ, उसे चलाएँ, और एक बार में एक डिटेल बदलें। पहले नतीजे को ड्राफ़्ट मानें, क्योंकि तीसरा अक्सर उससे कहीं करीब होता है जो आपने सोचा था। एक मॉडल खोलें, प्रॉम्प्ट टाइप करें और देखें कि क्या सामने आता है।