Skip to main content
Ayrshare MCP सर्वर एक AI agent को Ayrshare API चलाने देता है। यह पृष्ठ बताता है कि इससे कैसे कनेक्ट करें और authentication कैसे काम करता है।

​
Endpoint और transport

Production MCP सर्वर यहाँ उपलब्ध है: https://api.ayrshare.com/mcp यह Streamable HTTP transport का उपयोग करता है और stateless है — calls के बीच बनाए रखने के लिए कोई session नहीं है।

​
समर्थित clients

Action MCP Server केवल एक static Authorization: Bearer request header से authenticate करता है। यही एक आवश्यकता नीचे की सभी बातें तय करती है: जो client Streamable HTTP connection पर custom HTTP header सेट कर सकता है, वह authenticate कर सकता है, और जो client नहीं कर सकता, वह नहीं कर सकता। सेटअप शुरू करने से पहले अपना client खोजें।

​
Personal connectors authenticate क्यों नहीं कर सकते

Ayrshare के Action MCP को एक static Authorization: Bearer header की आवश्यकता है। इसे claude.ai, Claude Desktop, या Claude mobile पर personal custom connector के रूप में जोड़ना काम नहीं करता, क्योंकि Ayrshare कोई OAuth metadata प्रकाशित नहीं करता और request-header विकल्प एक beta है जो अनुमोदित organizations तक सीमित है। Personal connector पर, आपकी ओर की कोई भी setting इसे ठीक नहीं करती: Authorization header के लिए कोई field नहीं है, और कोई API key, profile, या account setting नहीं है जो इसे सक्षम करे। Ayrshare OAuth metadata प्रकाशित नहीं करता, इसलिए connector के OAuth path के पास कनेक्ट करने के लिए कुछ नहीं है। इसके बजाय ऊपर दी गई तालिका से कोई client उपयोग करें: Claude Code, Claude Code plugin, या कोई भी client जो आपको custom Authorization header सेट करने देता है। यदि आप Anthropic के request-header beta में शामिल किसी organization के administrator हैं, तो नीचे Team और Enterprise organizations देखें।
यदि आपका connector स्वस्थ दिखता है लेकिन हर tool विफल होता है। Connector बिना समस्या के जुड़ जाता है, healthy रिपोर्ट करता है, और पूर्ण tool catalog सूचीबद्ध करता है — और फिर हर tool call Ayrshare 403 / code 102, “API Key not valid” लौटाती है। यह यही सीमा है, खराब key नहीं — आपका client वह static Authorization: Bearer header नहीं भेज सकता जिसकी इस सर्वर को आवश्यकता है। initialize और tools/list authentication से पहले पहुँच योग्य हैं (नीचे Authentication देखें), इसलिए पहली tool call तक कुछ भी विफल नहीं होता, जब यह स्पष्ट हो जाता है कि कोई credential कभी भेजा ही नहीं गया।Client की क्षमता, या वास्तव में खराब key? दोनों बिल्कुल एक जैसी error लौटाते हैं, इसलिए उन्हें अलग पहचानने के लिए signature का उपयोग करें। Client-capability विफलता का अर्थ है कि connector healthy है और हर tool विफल होता है, जबकि वही key कहीं और काम करती है। खराब key वही error देती है लेकिन connector के बाहर भी reproducible है — वह REST call पर भी विफल होती है। स्वयं error semantics के लिए, नीचे Authentication errors देखें।

​
Team और Enterprise organizations

Anthropic का static_headers mechanism एक custom connector को OAuth का उपयोग करने के बजाय request header के रूप में एक fixed credential भेजने देता है। यह organizations के एक सीमित समूह में organization administrators के लिए beta में उपलब्ध है, और यह personal connector जोड़ने वाले व्यक्तिगत users के लिए उपलब्ध नहीं है। यदि आपके organization के पास access है, तो administrator को header value को Bearer और उसके बाद आपकी Ayrshare API key के रूप में दर्ज करना होगा, space सहित — Claude value को ठीक वैसे ही भेजता है जैसे वह दर्ज की गई है और आपके लिए scheme नहीं जोड़ता। वर्तमान उपलब्धता और सेटअप के लिए, Anthropic का connector authentication documentation देखें।
यह key पूरे organization द्वारा साझा की जाती है। Anthropic का request-header credential एक administrator द्वारा एक बार दर्ज किया जाता है और organization के हर सदस्य द्वारा उपयोग किया जाता है, इसलिए वे सभी उस एकल Ayrshare account के रूप में कार्य करते हैं जिसकी वह key है — Business key पर उसके अंतर्गत हर User Profile तक पहुँच के साथ, और आपके Ayrshare history या analytics में कोई प्रति-user attribution नहीं। इसे व्यक्तिगत access के रूप में नहीं, बल्कि एक साझा service credential के रूप में मानें।

​
Authentication

Authentication उसी Ayrshare API chain द्वारा लागू किया जाता है जो REST API को शक्ति प्रदान करती है।
  • आवश्यक: Authorization: Bearer YOUR_API_KEY — आपकी account API key (profiles और sub-profiles के लिए Business plan key)।
  • वैकल्पिक: Profile-Key: YOUR_PROFILE_KEY — connection पर प्रत्येक call के लिए एक sub-profile को target करती है।
  • प्रति call वैकल्पिक: एक profileKey tool argument — एकल tool call के लिए sub-profile को target करता है।

​
प्राथमिकता: argument header पर जीतता है

जब एक tool call में profileKey argument शामिल हो और connection में Profile-Key header हो, तो प्रति-call profileKey argument जीतता है। Header का उपयोग केवल तब होता है जब कोई मान्य argument प्रदान नहीं किया गया हो। एक अपवाद: get_platform_history और get_social_network_analytics पर, X/Twitter userId/userName lookup को केवल account API key का उपयोग करना चाहिए; वहाँ profileKey argument या Profile-Key header देने पर Error 400 लौटाया जाता है।
initialize और tools/list MCP methods authentication से पहले पहुँच योग्य हैं — वे केवल metadata लौटाते हैं और कुछ भी execute नहीं करते। प्रत्येक tool call authenticated होती है।

​
Authentication errors

किसी tool call पर unauthenticated या अमान्य key Ayrshare error 403 / code 102 को संदेश “API Key not valid” के साथ लौटाती है। MCP spec के अनुसार, tool-execution errors in-band लौटाई जाती हैं: tool result isError: true और यह संदेश रखता है, जबकि MCP transport स्वयं HTTP 200 से प्रतिक्रिया देता है। (403/102 Ayrshare की application error हैं, transport status नहीं।)

​
कनेक्ट करें

​
विकल्प A: Claude Code plugin

यदि आप Claude Code का उपयोग करते हैं, तो Ayrshare plugin स्थापित करें। यह MCP सर्वर configuration, एक setup command, agents, skills, और एक confirmation hook को बंडल करता है। पूर्ण install steps के लिए Claude Code Plugin पृष्ठ देखें।

​
विकल्प B: कोई भी MCP client

किसी भी MCP client के लिए जो Streamable HTTP का समर्थन करता है और आपको custom request header सेट करने देता है — ऊपर समर्थित clients देखें — सर्वर को सीधे register करें। Claude Code में:
प्रत्येक call पर एक sub-profile को target करने के लिए, वैकल्पिक Profile-Key header जोड़ें:
MCP connection session शुरू होने पर initialize होता है। सर्वर स्थापित करने या अपनी key बदलने के बाद अपने MCP client को restart करें ताकि नया configuration प्रभावी हो।

​
X/Twitter BYO credentials

31 मार्च 2026 से, Ayrshare के माध्यम से X/Twitter operations के लिए आपके स्वयं के OAuth 1.0a credentials आवश्यक हैं। जब कोई tool call X/Twitter को target करता है, तो अपने Authorization (और वैकल्पिक Profile-Key) headers के साथ connection पर ये दो headers forward करें: ये वही headers हैं जिनका उपयोग REST API करता है — प्रति Ayrshare account एक OAuth 1.0a key pair, प्रत्येक X-targeting request पर भेजा जाता है (वही जोड़ी सभी sub-profiles पर लागू होती है)। Ayrshare यहाँ OAuth 2.0 का उपयोग नहीं करता। सेटअप, नीति और troubleshooting के लिए API Overview और X BYO Key Setup Guide देखें।
इन headers के बिना, एक X/Twitter tool call error 419 (x_credentials_required) लौटाती है।

​
BYO headers के साथ कनेक्ट करें

शुरू से X/Twitter BYO credentials सेट अप करने के लिए, अपने Authorization header के साथ दोनों OAuth 1.0a headers जोड़कर सर्वर जोड़ें (यदि आप प्रत्येक call पर sub-profile target करते हैं, तो Profile-Key भी शामिल करें):

​
किसी मौजूदा connection में BYO headers जोड़ें

Connection headers सर्वर जोड़ते समय ही तय हो जाते हैं, इसलिए यदि आप पहले BYO headers के बिना कनेक्ट हो चुके हैं, तो सर्वर हटाएँ और उसे पूर्ण सेट के साथ फिर से जोड़ें (कोई भी headers जो आप पहले से उपयोग कर रहे थे, जैसे Profile-Key, पुनः शामिल करें):
Headers बदलने के बाद अपने MCP client को restart करें ताकि नया configuration प्रभावी हो। raw connection के बजाय Claude Code plugin का उपयोग कर रहे हैं? देखें Claude Code Plugin → X/Twitter BYO credentials।

​
अगले चरण

Tool Catalog

domain के अनुसार समूहित 33 tools, scope और उद्देश्य के साथ।

Claude Code Plugin

Claude Code के लिए Ayrshare plugin स्थापित करें।