Claude MCP Add Atlassian: Jira और Confluence को जोड़ने के आसान चरण
एक `claude mcp add` कमांड से Claude Code को Jira और Confluence से जोड़ें। v2 एंडपॉइंट, स्कोप के विकल्प, OAuth साइन-इन, API टोकन हेडर, पहले प्रॉम्प्ट, टीम के लिए `.mcp.json` और उन एररों की ट्रबलशूटिंग टेबल देखें जो आपके सामने सच में आएँगी।
आपका Jira बैकलॉग कभी छोटा नहीं होता, और Confluence में कोई कुछ ढूँढ नहीं पाता। Claude दोनों को पढ़ सकता है, दोनों में लिख सकता है, और चैट विंडो में एक भी टिकट पेस्ट किए बिना उनके बारे में सवालों के जवाब दे सकता है। पूरा लिंक एक टर्मिनल लाइन है: claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp। इसे चलाएँ, ब्राउज़र में एक बार साइन इन करें, और Claude Code JQL से Jira खोज सकता है, वर्क आइटम बना सकता है, और Confluence पेज पढ़ या एडिट कर सकता है, सब आपकी अपनी अनुमतियों के तहत।
यह वॉकथ्रू claude mcp add atlassian को उसी क्रम में समझाता है जिस क्रम में आपको इसकी ज़रूरत पड़ेगी: सर्वर क्या देता है, पहले क्या जाँचें, सटीक कमांड, तीनों स्कोप, OAuth साइन-इन, प्रॉम्प्ट का पहला दौर, ऑटोमेशन के लिए API टोकन विकल्प, टीम के साथ शेयरिंग, और एक ट्रबलशूटिंग टेबल। नीचे दिया हर कमांड और एंडपॉइंट Atlassian और Claude Code के मौजूदा दस्तावेज़ों से लिया गया है, जिसे अक्टूबर 2026 में जाँचा गया था।
Atlassian MCP असल में क्या करता है
MCP (Model Context Protocol) एक ओपन स्टैंडर्ड है जो AI क्लाइंट को बाहरी टूल्स कॉल करने देता है। Atlassian अपना रिमोट सर्वर चलाता है, Atlassian Rovo MCP Server, इसलिए आपको कुछ भी लोकल इंस्टॉल नहीं करना पड़ता। Claude Code एक URL से कनेक्ट होता है, और उसके पीछे की authentication, अनुमतियाँ और Jira व Confluence की कॉल्स Atlassian संभालता है।
एक सर्वर में Jira और Confluence
एक ही एंडपॉइंट Jira, Jira Service Management, Confluence, Bitbucket, Projects, Goals और Loom रिकॉर्डिंग की सेवा देता है। यह आर्टिकल Jira और Confluence पर केंद्रित है, वह जोड़ी जिसे ज़्यादातर टीमें सबसे पहले जोड़ती हैं। साइन-इन OAuth 2.1 से होता है, और हर एक्शन आपके मौजूदा एक्सेस कंट्रोल का सम्मान करता है। Claude वही देखता है जो आपका अकाउंट देखता है, उससे ज़्यादा कुछ नहीं।
Claude कौन-से कॉल कर सकता है
आपको टूल के नाम कभी टाइप नहीं करने पड़ते। आप सामान्य अनुरोध लिखते हैं, और Claude सही टूल चुन लेता है। फिर भी मेनू जानने से आप बेहतर प्रॉम्प्ट लिख पाते हैं:
💡 टिप: रीड-ओनली टूल्स आज़माने के लिए सबसे सुरक्षित हैं। राइट टूल्स असली टिकट और असली पेज बदलते हैं, इसलिए उन्हें कनेक्शन चालू होने के बाद के लिए रखें।
कमांड चलाने से पहले
चेकलिस्ट छोटी है, पर इसका कोई एक भी आइटम छूटने पर ज़्यादातर सेटअप अटक जाते हैं:
Claude Code इंस्टॉल है। टर्मिनल में claude --version चलाएँ। अगर वह वर्ज़न दिखाता है, तो आप तैयार हैं।
आपके पास Atlassian Cloud साइट है। जिस अकाउंट से आप कनेक्ट करना चाहते हैं, उससे आपको ब्राउज़र में Jira और Confluence दोनों खुलने चाहिए।
इस मशीन पर ब्राउज़र उपलब्ध है। OAuth एक साइन-इन पेज खोलता है। SSH के ज़रिए रिमोट सर्वर पर एक फ़ॉलबैक फ़्लैग मौजूद है, जो नीचे दिखाया गया है।
Rovo क्रेडिट का हिसाब कोई रखता है। Atlassian के अनुसार हर कॉल संदर्भ की मात्रा और उसमें लगे रीज़निंग के आधार पर Rovo क्रेडिट खर्च करती है, इसलिए अपने एडमिन से पूछें कि कोई बजट लागू होता है या नहीं।
आपके एडमिन ने API टोकन चालू किए हैं (वैकल्पिक)। यह तभी ज़रूरी है जब आप OAuth की जगह टोकन authentication चाहते हैं।
ये बॉक्स टिक होने के बाद पूरा सेटअप कुछ ही मिनटों का काम है।
एक कमांड में Claude MCP Add Atlassian
सटीक कमांड
कोई भी टर्मिनल खोलें और चलाएँ:
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
हर हिस्सा एक अलग काम करता है:
claude mcp add Claude Code में एक नया MCP सर्वर रजिस्टर करता है।
--transport http वह स्ट्रीमेबल HTTP ट्रांसपोर्ट चुनता है जिसे रिमोट सर्वर इस्तेमाल करते हैं।
atlassian लोकल नाम है। यही नाम आपको /mcp और claude mcp list में दिखेगा।
https://mcp.atlassian.com/v2/mcp Atlassian का v2 एंडपॉइंट है।
💡 टिप: पुराने लेखों में v1 एड्रेस दिखता है। Atlassian का मौजूदा दस्तावेज़ v2 की ओर इशारा करता है, इसलिए किसी पुराने फ़ोरम जवाब की जगह ऊपर दिया URL ही कॉपी करें।
सही स्कोप चुनें
डिफ़ॉल्ट रूप से कमांड सर्वर को लोकल स्कोप में सेव करता है। आप --scope से चुन सकते हैं कि यह कहाँ रहे:
स्कोप
फ़्लैग
कहाँ लोड होता है
टीम के साथ शेयर
कहाँ सेव होता है
Local (डिफ़ॉल्ट)
--scope local
केवल मौजूदा प्रोजेक्ट में
नहीं
~/.claude.json
Project
--scope project
केवल मौजूदा प्रोजेक्ट में
हाँ, version control के ज़रिए
प्रोजेक्ट रूट में .mcp.json
User
--scope user
आपके सभी प्रोजेक्ट में
नहीं
~/.claude.json
हर रिपॉज़िटरी में निजी इस्तेमाल के लिए user scope व्यावहारिक विकल्प है:
claude mcp add --transport http atlassian --scope user https://mcp.atlassian.com/v2/mcp
यहाँ project scope भी चलता है, क्योंकि URL में कोई सीक्रेट नहीं होता। फिर भी हर टीममेट को अपने Atlassian अकाउंट से साइन इन करना होगा।
साइन इन करें और जाँचें
सर्वर जोड़ने से आप लॉग इन नहीं हो जाते। इन चरणों को पूरा करें:
Claude Code सेशन शुरू करें और /mcp टाइप करें।
atlassian सर्वर चुनें और ब्राउज़र लॉगिन पूरा करें।
अपनी Atlassian साइट के लिए एक्सेस अनुरोध को मंज़ूरी दें।
टर्मिनल पर लौटें और claude mcp list चलाएँ।
टर्मिनल में ही रहना चाहते हैं? claude mcp login atlassian चलाएँ। हेडलेस मशीन पर claude mcp login atlassian --no-browser ब्राउज़र खोलने के बजाय एक URL प्रिंट करता है। किसी एक सर्वर की जानकारी देखने के लिए claude mcp get atlassian का उपयोग करें। स्टेटस कॉलम बताता है कि आप कहाँ खड़े हैं:
स्टेटस
अर्थ
✔ Connected
सर्वर सक्रिय और तैयार है
! Needs authentication
OAuth साइन-इन अभी बाकी है
✘ Failed to connect
कनेक्शन एरर, आम तौर पर URL या नेटवर्क की समस्या
Jira और Confluence के लिए पहले प्रॉम्प्ट
रीड से शुरुआत करें। एक अच्छा पहला टेस्ट साबित करता है कि साइन-इन काम करता है, और Claude को दिखाता है कि आपका इंस्टेंस कैसे व्यवस्थित है।
JQL से Jira खोजें
सामान्य अंग्रेज़ी में पूछें, या JQL सीधे पेस्ट करें:
"प्रोजेक्ट PAY में इस हफ़्ते अपडेट हुए अनरिज़ॉल्व्ड इश्यू प्राथमिकता के क्रम में सूचीबद्ध करें और शीर्ष पाँच का सारांश दें।"
Claude searchJiraIssuesUsingJql कॉल करता है। अगर आप पूरा नियंत्रण चाहते हैं, तो क्वेरी खुद दे दें:
project = PAY AND status != Done AND assignee = currentUser() ORDER BY priority DESC
जब कोई नाम अस्पष्ट हो, तो असाइनी से फ़िल्टर करने से पहले Claude से किसी साथी के लिए lookupJiraAccountId चलाने को कहें। यह डिस्प्ले नाम या ईमेल को उस account ID में बदलता है जिसकी JQL को ज़रूरत है।
इश्यू बनाएँ और अपडेट करें
राइट ऑपरेशन भी इसी तरह काम करते हैं, और एक आदत अपनाने लायक है: पहले ड्राफ़्ट माँगें।
"प्रोजेक्ट PAY के लिए 'Checkout fails on saved cards' शीर्षक वाला Bug ड्राफ़्ट करें, ऊपर दिए स्टैक ट्रेस का उपयोग करते हुए। फ़ील्ड्स दिखाएँ। मेरे 'हाँ' कहने तक कुछ भी न बनाएँ।"
पर्दे के पीछे Claude प्रोजेक्ट के issue types और ज़रूरी फ़ील्ड्स देखता है, और फिर आपकी मंज़ूरी पर createJiraIssue कॉल करता है। काम आगे बढ़ाना भी उतना ही छोटा है:
"PAY-142 को In Review में ले जाएँ और पull request का लिंक देते हुए एक कमेंट जोड़ें।"
यह अनुरोध transitionJiraIssue और addOrEditJiraIssueComment का उपयोग करता है। डिफ़ॉल्ट रूप से Claude Code MCP टूल चलाने से पहले मंज़ूरी माँगता है, इसलिए हर राइट अनुरोध को स्वीकार करने से पहले पढ़ें।
💡 टिप: अपने पहले मैसेज में प्रोजेक्ट, issue type और प्राथमिकता का नाम लिखें। ऐसे प्रॉम्प्ट में कम टूल कॉल लगती हैं और कम फ़ॉलो-अप सवाल आते हैं, जिससे Rovo क्रेडिट का खर्च भी घटता है।
Confluence पेज पढ़ें और लिखें
Confluence CQL सर्च और पेज टूल्स के ज़रिए काम करता है:
"Confluence में हमारी इंसिडेंट रिस्पॉन्स रनबुक खोजें और एस्केलेशन के स्टेप्स का सारांश दें।"
"ENG स्पेस में 'Release checklist' नाम का पेज बनाएँ, इस फ़ाइल के नोट्स से।"
"ऑनबोर्डिंग पेज पर एक footer कमेंट जोड़ें, जिसमें पूछा जाए कि VPN के चरण अभी भी सही हैं या नहीं।"
मौजूदा पेजों के अपडेट पूरी बॉडी बदल सकते हैं या छोटे-छोटे एडिट लागू कर सकते हैं। जिस चीज़ पर लोग निर्भर रहते हैं, उसके लिए Claude से कहें कि टार्गेटेड एडिट करे और सेव करने से पहले बदलाव दिखाए।
इसके बजाय API टोकन इस्तेमाल करें
OAuth रोज़ाना के इंटरैक्टिव काम के लिए उपयुक्त है। API टोकन ऑथेंटिकेशन पाइपलाइन, बॉट और ऐसे दूसरे नॉन-इंटरैक्टिव रन के लिए उपयुक्त है, जहाँ सहमति स्क्रीन पर क्लिक करने के लिए कोई मौजूद नहीं होता। यह वैकल्पिक है, और इसके लिए पहले किसी ऑर्गनाइज़ेशन एडमिन को Rovo MCP server की सेटिंग में इसे चालू करना होगा।
हेडर बनाएँ
Atlassian दो हेडर फ़ॉर्मेट स्वीकार करता है:
व्यक्तिगत API टोकन:Authorization: Basic <base64(email:api_token)>
⚠️ चेतावनी: टोकन को पासवर्ड की तरह समझें। इसे लोकल या user scope में रखें, कभी भी commit की गई .mcp.json में न डालें, और जब कोई टीम छोड़े तो इसे रोटेट करें।
किन सीमाओं की उम्मीद रखें
Atlassian बताता है कि टोकन authentication के साथ कुछ MCP टूल उपलब्ध नहीं हो सकते, क्योंकि टोकन में चुने जा सकने वाले स्कोप होते हैं जो पूरे OAuth सेशन से संकरे होते हैं। यहाँ एक टेबल में दोनों विकल्पों के बीच का समझौता एक नज़र में है:
OAuth 2.1
API token
सेटअप
/mcp के ज़रिए ब्राउज़र साइन-इन
एडमिन टॉगल और एक हेडर
सबसे अच्छा किसके लिए
रोज़ाना का इंटरैक्टिव काम
CI जॉब, बॉट, ऑटोमेशन
पहचान
आपका यूज़र
आपका यूज़र, या service account
टूल की उपलब्धता
पूरा सेट
कुछ टूल गायब हो सकते हैं
सेटअप शेयर करें और उसे बनाए रखें
प्रोजेक्ट कॉन्फ़िग commit करें
पूरी रिपॉज़िटरी को एक ही कनेक्शन देने के लिए, सर्वर को project scope में जोड़ें या फ़ाइल हाथ से लिखें:
इसे प्रोजेक्ट रूट में .mcp.json नाम से सेव करें और commit करें। इंटरैक्टिव सेशन में Claude Code हर टीममेट से प्रोजेक्ट सर्वर इस्तेमाल करने से पहले मंज़ूरी माँगता है। claude -p जैसे नॉन-इंटरैक्टिव मोड में प्रोजेक्ट सर्वर बिना पूछे लोड हो जाते हैं। इन मंज़ूरियों को रीसेट करने के लिए claude mcp reset-project-choices चलाएँ।
v2 बदलाव की तैयारी करें
Atlassian की अपनी सूचना कहती है: "1 मार्च 2027 से v1 का कोई भी मौजूदा उपयोग अपने-आप v2 टूल्स को एक्सपोज़ और इस्तेमाल करना शुरू कर देगा।" जिन क्लाइंट्स ने पुराने क्रेडेंशियल कैश किए हैं, उन्हें अपने कैश्ड clientIds या .well-known क्रेडेंशियल साफ़ करने पड़ सकते हैं। अगर आपने कुछ महीने पहले v1 एड्रेस रजिस्टर किया था, तो अभी एक साफ़ स्वैप करें:
claude mcp logout atlassian
claude mcp remove atlassian
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
फिर /mcp चलाएँ और दोबारा साइन इन करें।
दो आदतें सेटअप को समय के साथ स्वस्थ रखती हैं:
क्रेडिट के खर्च पर नज़र रखें। बड़े संदर्भ वाली कॉल ज़्यादा Rovo क्रेडिट खर्च करती हैं, इसलिए "सब कुछ" माँगने के बजाय खास प्रोजेक्ट, स्पेस और तारीख़ों की रेंज माँगें।
ऑडिट लॉग जाँचें। Atlassian गतिविधि की निगरानी की सलाह देता है। टिकट में लिखने वाला शेयर्ड कनेक्शन उसी जाँच का हक़दार है जो किसी भी दूसरे इंटीग्रेशन को मिलती है।
आम सेटअप समस्याएँ ठीक करें
ज़्यादातर फ़ेल्योर कुछ गिने-चुने पैटर्न में आते हैं। claude mcp list से शुरू करें, फिर लक्षण से मिलाएँ:
लक्षण
संभावित कारण
समाधान
! Needs authentication
साइन-इन पूरा नहीं हुआ या एक्सपायर हो गया
/mcp या claude mcp login atlassian चलाएँ
✘ Failed to connect
गलत URL, गलत ट्रांसपोर्ट, या नेटवर्क ब्लॉक
claude mcp get atlassian चलाएँ और पुष्टि करें कि टाइप http है और URL /v2/mcp पर खत्म होता है
ब्राउज़र कभी नहीं खुलता
रिमोट या हेडलेस सेशन
claude mcp login atlassian --no-browser इस्तेमाल करें
वर्ज़न बदलने के बाद साइन-इन लूप में फँसता है
पुराना कैश्ड क्लाइंट डेटा
ऊपर दिया logout, remove और add क्रम चलाएँ
कोई अपेक्षित टूल गायब है
टोकन स्कोप OAuth से संकरे हैं
टोकन स्कोप चौड़े करें या OAuth पर जाएँ
जिस प्रोजेक्ट को आप खोल सकते हैं, उसके लिए सर्च कुछ नहीं लौटाती
नाम का मेल नहीं खाना
Claude से वे Jira प्रोजेक्ट सूचीबद्ध करने को कहें जो वह देख सकता है, फिर ठीक वही नाम इस्तेमाल करें
जब कुछ और काम न करे, तो सर्वर को हटाकर दोबारा जोड़ने में लगभग दस सेकंड लगते हैं, और यह खराब लोकल एंट्री की संभावना खत्म कर देता है। किसी भी बदलाव के बाद अपने प्रॉम्प्ट को दोष देने से पहले claude mcp list दोबारा चलाएँ। हरी ✔ Connected लाइन बताती है कि समस्या अनुरोध में है, कनेक्शन में नहीं।
PicassoIA पर खुद आज़माएँ
Claude को Atlassian से जोड़ने पर कनेक्शन का बुनियादी झंझट सुलझ जाता है। इसके आसपास दो काम और बचते हैं: ऐसा टिकट टेक्स्ट लिखना जो पढ़ने लायक हो, और Confluence पेजों को कुछ विज़ुअल वज़न देना। PicassoIA दोनों में मदद करता है, जो आपके Claude Code सेटअप के बगल में एक अलग टूल है। ऊपर का MCP लिंक Claude Code में चलता है, जबकि नीचे के चरण PicassoIA पर होते हैं।
अपनी कच्ची बग रिपोर्ट या मीटिंग नोट्स Prompt फ़ील्ड में पेस्ट करें।
एक बार System Prompt सेट करें, जैसे: "आप Jira टिकट लिखते हैं। एक लाइन का सारांश, रीप्रोडक्शन के चरण, अपेक्षित परिणाम, वास्तविक परिणाम और एक acceptance criteria चेकलिस्ट दें।"
एक effort स्तर चुनें। low गहरी सोच छोड़कर सबसे तेज़ जवाब देता है। जब समस्या कई सिस्टम को छूती हो, तो high या max पर जाएँ।
लंबे runbooks के लिए Max Tokens को डिफ़ॉल्ट 8192 पर छोड़ें, या छोटे टिकटों के लिए इसे घटाएँ।
वैकल्पिक Image फ़ील्ड में स्क्रीनशॉट अटैच करें। मॉडल इमेज पढ़ता है, इसलिए एरर डायलॉग भी अनुरोध का हिस्सा बन सकता है।
नतीजा Claude Code में कॉपी करें और कहें "इस इश्यू को प्रोजेक्ट PAY में बनाएँ।"
किसी उलझी हुई इंसिडेंट रिपोर्ट के लिए ज़्यादा भारी रीज़निंग चाहिए? Claude Opus 4.7 और Claude Fable 5 उसी प्लेटफ़ॉर्म पर उपलब्ध हैं।
Confluence पेजों के लिए विज़ुअल बनाएँ
साफ़ हेडर इमेज वाला runbook, टेक्स्ट की दीवार से ज़्यादा बार खोला जाता है। P-Image, Flux 2 Pro, Seedream 5 Pro और GPT Image 2 सभी एक वाक्य को ऐसी फ़ोटो में बदल देते हैं जिसे आप पेज बैनर के रूप में इस्तेमाल कर सकते हैं। "धूप वाला टीम व्हाइटबोर्ड, स्टिकी नोट्स के साथ, शैलो डेप्थ ऑफ़ फ़ील्ड, प्राकृतिक फ़िल्म ग्रेन" जैसा प्रॉम्प्ट आज़माएँ।
Atlassian टूल लिस्ट में Jira इश्यू के लिए अटैचमेंट अपलोड शामिल है, लेकिन Confluence के लिए केवल डाउनलोड हैं, इसलिए तैयार इमेज को Confluence एडिटर से पेज में डालें।
PicassoIA अपना MCP कनेक्शन भी देता है, जो इमेज और वीडियो जनरेशन के लिए है और आपके अकाउंट से मैनेज होता है। विचार वही है जो आपने अभी सेट किया: एक बार कनेक्ट करें, फिर सामान्य भाषा में पूछें।
कमांड चलाएँ, साइन इन करें, और Claude से अपनी पहली JQL खोज माँगें। फिर PicassoIA खोलें, एक मॉडल चुनें, और वे टिकट ड्राफ़्ट और इमेज बनाएँ जिन्हें आपकी टीम बार-बार टालती रही है। आपकी अगली स्प्रिंट रिव्यू आपको शुक्रिया कहेगी।