AI एजेंट के लिए Notiamo
वह सब कुछ जो किसी AI एजेंट को अपने मालिक के लिए मुफ़्त खाता खोलने, वेबसाइट पर विजेट लगाने और टिप्पणियां व काम संभालने के लिए चाहिए, बिना ब्राउज़र के।
प्रक्रिया
- अपने मालिक के लिए खाता मांगें:
email,name,agent,localeऔर, अगर आपके पास हों,company,projectUrl(वेबसाइट का पता) औरreferralके साथPOST https://my.notiamo.com/api/agent/signupभेजें। जवाब मेंrequestId,pollSecretऔरpollAfterSecondsहोते हैं। - मालिक से कहें कि Notiamo जो पुष्टि का ईमेल भेजता है उसे खोलकर पुष्टि करे। जब तक वे ऐसा नहीं करते, कुछ नहीं होता।
- हर
pollAfterSecondsसेकंड परAuthorization: Bearer <pollSecret>के साथGET https://my.notiamo.com/api/agent/signup/{requestId}पोल करें। स्टेटसpending,confirmed,expiredयाreportedहोता है। - जब स्टेटस
confirmedहो, तो जवाब में आपकी कुंजी (token, जोntm_से शुरू होती है) औरmcpUrlएक बार आते हैं। कुंजी को तुरंत सहेजें: बाद के पोल उसे नहीं लौटाते। पुष्टि के 7 दिन के भीतर उसे ले लें। https://my.notiamo.com/api/mcpपर MCP सर्वर से हेडरAuthorization: Bearer ntm_…के साथ जुड़ें। अगर आपका ऐप MCP साइन-इन सपोर्ट करता है, तो वह कुंजी की जगह Notiamo से साइन इन इस्तेमाल कर सकता है (नीचे देखें)।- अपने लिए बना प्रोजेक्ट ढूंढने के लिए
list_projects(याfind_project) कॉल करें: उसके पते के रूप में पहले से आपकाprojectUrlहै। अगर पता गायब या गलत हो, तोupdate_project_addressकॉल करें। फिरget_install, स्निपेट इंस्टॉल करें, औरcheck_install।create_workspaceऔरcreate_projectतभी इस्तेमाल करें जब प्लान में जगह हो (सशुल्क प्लान या Studio ट्रायल);create_projectकोlist_workspacesसेworkspaceIdचाहिए। वर्कस्पेस प्रोजेक्ट को समूह में रखता है, उदाहरण के लिए हर क्लाइंट का एक। प्रोजेक्ट में वेब पता न हो सकता है (originछोड़ दें): तब उसमें टास्क, काम और समाचार होते हैं, पर विजेट नहीं। इंस्टॉल के बादget_badgeफ़ुटर बैज देता है: साइट के फ़ुटर के लिए एक छोटा Notiamo लोगो, जो समीक्षकों के लिए समीक्षा टूल खोलता है और बाकी सबके लिए Notiamo का सादा लिंक है, साइट की भाषा में (update_project_language, याcreate_projectमेंlanguage)। - फिर टिप्पणियों पर काम करें:
list_comments,get_comment,replyऔरset_status। नया कुछ है या नहीं जांचने के लिएlist_commentsकोsinceदें:Zपर खत्म होने वाला UTC समय (जैसे2026-10-17T08:00:00Z), या उसके पिछले जवाब काcursor। आपको सिर्फ़ वही मिलता है जो बदला है, एक प्रोजेक्ट पर या,projectIdके बिना, आपके सभी प्रोजेक्ट पर। अगली जांच के लिए नयाcursorरखें,more: trueहो तो तुरंत आगे बढ़ें, औरidसे डुप्लिकेट हटाएं: एक आइटम दो बार आ सकता है। - दूसरे संगठन के लिए
nameके साथcreate_organizationकॉल करें: ओनर उसका एडमिन बनता है और उसे ईमेल मिलता है, और जवाब में सिर्फ़ उस संगठन के लिए नयाtokenहोता है। अगर ओनर के पास कोई मुफ़्त संगठन नहीं है तो यह मुफ़्त है, वरना इसे प्लान चाहिए: नए टोकन के साथget_payment_linkकॉल करें, या 14 दिन के Studio ट्रायल के लिएstart_trial(प्रति व्यक्ति एक बार; ओनर लिंक खोलकर कार्ड डालता है)। रोज़ की एक सीमा है; इनकार में बताया जाता है कि आप दोबारा कब कोशिश कर सकते हैं। - किसी प्रोजेक्ट को दूसरे वर्कस्पेस में ले जाने के लिए (
kindproject,projectId,toWorkspaceId), या किसी वर्कस्पेस को उसके प्रोजेक्ट के साथ दूसरे संगठन में, जहां मालिक भी एडमिन है (kindworkspace,workspaceId,toOrganizationId),request_moveकॉल करें। अभी कुछ नहीं हिलता: मालिक को ईमेल मिलता है और उसे 24 घंटे के भीतर उसमें दिए पेज पर पुष्टि करनी होती है। स्टेटस के लिएget_move_requestकॉल करें:pending,done,cancelled,expiredयाfailed। - किसी पेज से न जुड़ा काम जोड़ने के लिए
projectIdऔरtitleके साथcreate_taskकॉल करें, और चाहें तोtextऔरpageUrlभी। उसके शब्द बदलने के लिएtaskIdऔर नएtitle,textया दोनों के साथupdate_taskकॉल करें। दोनों नए वर्कस्पेस, प्रोजेक्ट और टास्क की दैनिक सीमा में गिने जाते हैं; सीमा पर पहुंचने पर इनकार आपको बताता है।list_commentsटास्क को[Task]से चिह्नित दिखाता है औरtypeलेता है:taskयाcomment। - जॉब रिपोर्ट (Studio, Agency और ट्रायल) ऐसे टास्क हैं जिन्हें क्लाइंट किए गए काम के बारे में भरता है: जगह, तारीख, अंतिम ग्राहक और चरण (
before,during,after,other) के अनुसार फ़ाइलें, कैप्शन के साथ।list_job_reportsकॉल करें (statereadyआपके इंतज़ार वाली रिपोर्ट गिनाता है), किसी एक कोget_commentसे पढ़ें, और उसकी भाषा मेंrolearticleके साथ जवाब दें। मंज़ूरी सिर्फ़ कोई व्यक्ति देता है: उन्हें मंज़ूरी का लिंक दें याrequest_approvalकॉल करें। मंज़ूरी मिलने परrolepostsऔरfiles(इस्तेमाल होने वाली फ़ाइलों के id) के साथ जवाब दें।update_fileफ़ाइल काphaseयाcaptionसेट करता है;create_taskऔरupdate_taskjobReportलेते हैं। - वॉइस नोट और AI (Studio, Agency और ट्रायल):
get_commentहर रिकॉर्डिंग को ऑडियो के लिंक और AI के ट्रांसक्रिप्ट के साथ सूचीबद्ध करता है (और बाद का कोई ट्रांसक्रिप्ट, जो पोस्ट नहीं किया गया), लगभग 20 सेकंड से लंबे हर वीडियो को समय नोट (m:ss–m:ssक्या होता है) के साथ, और AI कैप्शन जिन पर कोई व्यक्ति जांच ले तब तक(AI, not checked)लिखा रहता है। जब AI किसी फ़ाइल को प्रोसेस नहीं कर पाता, तो वह वही सादे शब्दों में बताता है जो लोग देखते हैं, सहायता के लिए एक रेफ़रेंस कोड (AI-…) के साथ।list_plansऔरget_billingमहीने के वॉइस और AI मिनट देते हैं।
pollAfterSeconds से तेज़ पोल न करें। अगर rate_limited मिले, तो retryAfter सेकंड रुकें। गलत या अनजान id या secret पर {"code":"not_found"} के साथ 404 लौटता है।
अगर आपका प्लेटफ़ॉर्म अपने अनुरोधों पर Web Bot Auth से हस्ताक्षर करता है (HTTP संदेश हस्ताक्षर, कुंजी निर्देशिका के साथ Signature-Agent) और Notiamo उस पर भरोसा करता है, तो साइन-अप और MCP सर्वर आपको पते के बजाय प्लेटफ़ॉर्म से गिनते हैं, ज़्यादा सीमाओं के साथ। बिना हस्ताक्षर वाले अनुरोध पहले की तरह चलते हैं।
उदाहरण: खाता मांगना
curl -X POST https://my.notiamo.com/api/agent/signup \
-H "Content-Type: application/json" \
-d '{"email":"owner@example.com","name":"Ada Owner","agent":"my-agent","locale":"en","projectUrl":"https://example.com"}'मुफ़्त प्लान
मुफ़्त प्लान में 1 वर्कस्पेस, 1 प्रोजेक्ट, 3 लोग (टीम के सदस्य, क्लाइंट सदस्य और लंबित आमंत्रण, हर ईमेल एक बार) और हर प्रोजेक्ट का 1 सार्वजनिक पता होता है। प्रोजेक्ट की पहली सार्वजनिक टिप्पणी के बाद पता एक बार बदला जा सकता है। इसमें 100 MB फ़ाइलें रखी जा सकती हैं, एक फ़ाइल 5 MB; 100 MB से ऊपर जाने पर संगठन के एडमिन को दो ईमेल मिलते हैं, फिर सबसे पुरानी फ़ाइलें हटाई जाती हैं, और टिप्पणियां, टास्क और जवाब बने रहते हैं। दुरुपयोग रोकने के लिए अपलोड अस्वीकार किए जा सकते हैं। वीडियो शामिल नहीं है: उसके लिए Studio, Agency या ट्रायल चाहिए। खाता खुलते समय एक वर्कस्पेस और एक प्रोजेक्ट पहले से मौजूद होते हैं।
मुफ़्त प्लान पर विजेट Notiamo का बैज दिखाता है।
टिप्पणी वाली लाइन को स्क्रिप्ट टैग के ऊपर रखें। मुफ़्त प्लान की शर्तें इसकी मांग करती हैं:
<!-- Notiamo (notiamo.com): website feedback. Free plan: keep this line. -->plan_limit का इनकार बताता है कि आप कौन-सी सीमा पर पहुंचे और आगे क्या करना है।
इनकार
साइन-अप और टूल एक कोड के साथ जवाब देते हैं। साइन-अप के कोड HTTP स्टेटस के साथ आते हैं:
| कोड | HTTP स्टेटस | इसका मतलब |
|---|---|---|
signup_blocked | 403 | इस नेटवर्क को साइन अप करने की अनुमति नहीं है। मालिक खुद साइन अप करता है। |
country_blocked | 403 | जिस देश से अनुरोध आया है वहां Notiamo उपलब्ध नहीं है। ओनर भी वहां से साइन अप नहीं कर सकता। |
rate_limited | 429 | बहुत ज़्यादा अनुरोध। retryAfter सेकंड रुकें। |
agent_signup_paused | 503 | एजेंट द्वारा साइन-अप अभी रुका हुआ है। मालिक खुद साइन अप करता है। |
agent_signup_closed | 503 | एजेंट द्वारा साइन-अप बंद है। मालिक खुद साइन अप करता है। |
account_exists | 409 | इस ईमेल का खाता पहले से है। मालिक लॉग इन करके सेटिंग > AI एजेंट > एजेंट टोकन में कुंजी बनाता है। |
email_not_accepted | 422 | यह ईमेल पता इस्तेमाल नहीं हो सकता। मालिक खुद साइन अप करता है। |
invalid_input | 422 | कोई फ़ील्ड सही नहीं है। field उसका नाम बताता है। |
plan_limit | 402 | प्लान की सीमा आ गई। MCP टूल लौटाते हैं, अगले कदम (start_trial या get_payment_link) के साथ। |
read_only | 403 | यह कुंजी या ऐप केवल-पढ़ने वाला है: देख सकता है, बदल नहीं सकता। MCP टूल लौटाते हैं। |
permission_missing | 403 | इस कुंजी या ऐप को यह करने की अनुमति नहीं है। permission छूटे हुए समूह (या full) का नाम बताता है। MCP टूल लौटाते हैं। |
इनकार अपने मालिक को दिखाएं। उन्हें कभी घुमाकर पार न करें।
Notiamo से साइन इन (OAuth)
कुंजी की जगह, साइन-इन सपोर्ट करने वाला MCP क्लाइंट OAuth से जुड़ सकता है। ऑथराइज़ेशन सर्वर का मेटाडेटा https://my.notiamo.com/.well-known/oauth-authorization-server पर है, और MCP सर्वर 401 के साथ WWW-Authenticate हेडर लौटाता है जो उसके प्रोटेक्टेड रिसोर्स मेटाडेटा (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728) की ओर इशारा करता है, जिसमें इस सर्वर का नाम है, और स्कोप notes replies status tasks सुझाता है। क्लाइंट खुद को रजिस्टर करते हैं और PKCE (S256) इस्तेमाल करते हैं, बिना क्लाइंट सीक्रेट के।
आपका मालिक लॉग इन करता है, संगठन चुनता है, आप क्या बदल सकते हैं (फ़ीडबैक पर काम चिह्नित है) और कौन-से प्रोजेक्ट, और अनुमति दें दबाता है। स्कोप नीचे दिए अनुमति समूह हैं। आपका मालिक ऐप को सेटिंग > AI एजेंट > जुड़े हुए ऐप में देखता है और उसे कभी भी डिस्कनेक्ट कर सकता है।
अनुमतियां
पढ़ने के लिए किसी अनुमति की ज़रूरत नहीं। कुछ बदलने के लिए कुंजी या जुड़े हुए ऐप को उसके लिए समूह चाहिए:
notes replies status tasks setup invites billing moves
केवल-पढ़ने में कोई समूह नहीं है। फ़ीडबैक पर काम में notes, replies, status और tasks हैं। पूरा में सब हैं; टीम के सदस्यों को आमंत्रित करने के लिए पूरा चाहिए। समूह के बिना टूल permission_missing के साथ इनकार करता है और permission में समूह का नाम बताता है; केवल-पढ़ने वाली कुंजी को read_only मिलता है। इसे अपने मालिक को दिखाएं: ज़्यादा एक्सेस सिर्फ़ वही दे सकते हैं।
भुगतान
list_plans प्लान दिखाता है (कीमतें कीमत के पेज पर देखें)। start_trial ट्रायल शुरू करता है, प्रति व्यक्ति एक बार। कीमतें
get_payment_link भुगतान का लिंक बनाता है जिसे मालिक खोलकर भुगतान करता है। कार्ड का डेटा आप कभी नहीं संभालते।
रेफ़रल
अगर Notiamo का कोई बैज या लिंक आपको यहां लाया, तो उसका कोड साइन-अप की JSON बॉडी के referral फ़ील्ड में दें। ?via=<code> रूप सिर्फ़ उस साइन-अप वेब लिंक के लिए है जिसे लोग खोलते हैं।
MCP टूल
जुड़ने के बाद आप ये कॉल कर सकते हैं:
whoami list_projects find_project list_comments list_activity get_comment reply set_status assign list_team list_people get_account list_plans get_billing start_trial list_workspaces create_workspace create_project update_project_address update_project_language get_install get_badge check_install invite get_payment_link create_organization request_move get_move_request create_task update_task list_job_reports update_file request_approval