ज़ीरो-कोड इंटीग्रेशन
टीयर-3 प्लगइन्स हैं शून्य-कोड: आप किसी मौजूदा सेवा को एजेंट्स के लिए उपलब्ध कराते हैं बिना कोई इंटीग्रेशन कोड लिखे या डिप्लॉय किए। दो स्रोत प्रकार हैं — ओपनएपीआई और एमसीपी — और दोनों अपने रहस्यों को स्पष्ट रूप से कॉन्फ़िगरेशन से नहीं बल्कि एन्क्रिप्टेड वॉल्ट से हल करते हैं।
OpenAPI: प्रत्येक ऑपरेशन के लिए एक टूल
AiHummer को किसी भी चीज़ की ओर इशारा करें ओपनएपीआई 3.x इसके माध्यम से विशिष्ट spec_url और मंच प्रत्येक संचालन के लिए एक उपकरण का संश्लेषण करता है विशेष विनिर्देश में। प्रत्येक संचालन एक कॉल करने योग्य उपकरण बन जाता है जिसे एजेंट फ़ंक्शन-कॉलिंग टर्न के दौरान उपयोग कर सकता है — कोई गोंद कोड नहीं, कोई प्रति-एंडपॉइंट वायरिंग नहीं।
{
"version": "1.0.0",
"kind": "openapi",
"scope": "shared",
"openapi": {
"spec_url": "https://api.acme.example/openapi.json"
}
}मैनीफेस्ट में प्लगइन का स्लग या नाम शामिल नहीं होता — ये इंस्टॉलेशन समय पर कैटलॉग/बंडल से आते हैं (देखें प्लगइन एसडीके).
स्पेसिफिकेशन के securityScheme के माध्यम से प्रमाणीकरण
प्रमाणीकरण सीधे स्पेक से लिया गया है। AiHummer OpenAPI को पढ़ता है securityScheme, और असली रहस्य खींचा जाता है तिजोरी कॉल समय पर — जिससे क्रेडेंशियल कभी भी मैनिफेस्ट, प्रॉम्प्ट या लॉग में इनलाइन नहीं होता।
[!NOTE] संश्लेषित उपकरण विशिष्टता की अपनी संचालन और सुरक्षा का पालन करते हैं। अपना बनाए रखें OpenAPI दस्तावेज़ सटीक: जिन संचालन की यह घोषणा करता है वे बिल्कुल वही उपकरण हैं एजेंट देखेगा।
तैयार-निर्मित व्यक्तिगत एकीकरण (प्रत्येक उपयोगकर्ता OAuth)
यही OpenAPI तंत्र बड़ी संख्या में तैयार-निर्मित का समर्थन करता है व्यक्तिगत एकीकरण: प्रत्येक एक प्रति-उपयोगकर्ता OAuth एकीकरण है जिसे कोई व्यक्ति अपने स्वयं के खाते से जोड़ता है, जिसके बाद उपकरण उनकी ओर से कार्य करते हैं। पहले से उपलब्ध हैं Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube, Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings और अधिक। एक व्यक्तिगत खाते को जोड़ना इसमें शामिल है प्रति-उपयोगकर्ता कनेक्शन.
एमसीपी: किसी भी सर्वर से कनेक्ट करें
दूसरा स्रोत प्रकार किसी भी चीज़ को जोड़ता है एमसीपी सर्वर. AiHummer इसके साथ बात करता है over a स्ट्डियो या HTTP ट्रांसपोर्ट, इसे कहते हैं tools/listऔर एजेंट को लौटाए गए टूल्स को एक्सपोज़ करता है। OpenAPI की तरह, इसके लिए किसी इंटीग्रेशन कोड की आवश्यकता नहीं है।
{
"version": "1.0.0",
"kind": "mcp",
"scope": "shared",
"mcp": {
"transport": "http",
"url": "https://mcp.acme.example/"
}
}एक stdio-ट्रांसपोर्ट सर्वर उस कमांड द्वारा कॉन्फ़िगर किया जाता है जो इसे लॉन्च करता है, URL के बजाय:
{
"version": "1.0.0",
"kind": "mcp",
"scope": "shared",
"mcp": {
"transport": "stdio",
"command": "my-mcp-server"
}
}गुप्त बातें वॉल्ट के माध्यम से → एनव
MCP सर्वरों के लिए, रहस्य बहते हैं संग्रह से पर्यावरण में सर्वर इसी के साथ चलता है। आप गुप्त जानकारी को केवल एक बार वॉल्ट में संग्रहीत करते हैं; AiHummer इसे सर्वर को लॉन्च या कनेक्ट करते समय एक वातावरण चर के रूप में इंजेक्ट करता है, ताकि गुप्त सामग्री मैनिफेस्ट और मॉडल संदर्भ से बाहर रहे।
एक नजर में OpenAPI बनाम MCP
| ओपनएपीआई | एमसीपी | |
|---|---|---|
| इनपुट | एक OpenAPI 3.x spec_url |
एक MCP सर्वर (stdio या http) |
| उपकरण बनाए गए | विशेष विवरण में प्रत्येक संचालन के लिए एक | जो भी tools/list लौटाता है |
| प्राधिकरण | विशेष विवरण securityScheme → तिजोरी |
सर्वर के लिए वॉल्ट → वातावरण |
| कोड आवश्यक | कोई नहीं | कोई नहीं |
कब किसका उपयोग करें
- पहुंचना ओपनएपीआई जब सेवा पहले से ही एक OpenAPI दस्तावेज़ प्रकाशित करती है — आपको इसके सभी संचालन सेट टूल्स के रूप में स्वचालित रूप से मिल जाते हैं।
- पहुंचना एमसीपी जब आप किसी मौजूद MCP सर्वर से कनेक्ट करना चाहते हैं, या चलाना चाहते हैं स्थानीय टूल सर्वर स्टडियो के माध्यम से।
[!TIP] दोनों स्रोत प्रकार उसी एक-फ़ाइल द्वारा परिभाषित हैं
manifest.jsonजैसा हर अन्य प्लगइन — देखें प्लगइन एसडीके के लिएopenapiऔरmcpप्रकार औरaihummer plugin validate.
अगला कहाँ
- प्लगइन एसडीके — के लिए फील्ड्स प्रकट करें
openapiऔरmcp. - मार्केटप्लेस अवलोकन और स्तर — कहाँ शून्य-कोड (टीयर 3) बैठता है।
- व्यक्तिगत बनाम साझा प्रमाण पत्र — कैसे वॉल्ट रहस्यों का जो उपयोग ये उपकरण करते हैं, वे सीमित हैं।