MCP सर्वर

Nordlet https://api.nordlet.com/mcp पर Model Context Protocol प्रदान करता है। इससे जुड़ा हुआ AI सहायक (AI assistant) सीधे अनुरोध की तरह ही समान API की (API key), कंपनी और स्कोप (scopes) के साथ API को खोज सकता है, किसी भी ऑपरेशन का अनुरोध स्कीमा (request schema) पढ़ सकता है और उसे कॉल कर सकता है। प्रत्येक टूल कॉल एक साधारण API अनुरोध होता है: इसे अन्य अनुरोधों की तरह ही प्रमाणित (authenticated), रेट-लिमिटेड (rate limited) और मीटर (metered) किया जाता है, और एक डेटा-परिवर्तन कॉल (mutating call) कंपनी के खातों (books) में बदलाव करता है।

कनेक्ट करें (Connect)

यह एंडपॉइंट (endpoint) स्ट्रीम करने योग्य HTTP (Streamable HTTP) पर काम करता है और Getting started से प्राप्त Bearer API की (API key) द्वारा प्रमाणित होता है। Claude Code में:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp --header "Authorization: Bearer nl_..."

कोई भी अन्य MCP क्लाइंट समान URL और हेडर का उपयोग करता है। *:read स्कोप वाली की (key) केवल रीड ऑपरेशंस (read operations) को कॉल कर सकती है; टूल्स किसी गायब स्कोप को API के 403 त्रुटि (error) के रूप में रिपोर्ट करते हैं।

टूल्स (Tools)

तीन टूल्स API के हर ऑपरेशन को कवर करते हैं:

टूल (Tool)	यह क्या करता है (What it does)
search_operations	नाम, पथ (path), सारांश या विवरण में दिए गए शब्दों के आधार पर ऑपरेशंस खोजता है, वैकल्पिक रूप से किसी एक मॉड्यूल (sales, bank, reports, आदि) के भीतर। बिना किसी क्वेरी के यह मॉड्यूलों की सूची देता है।
describe_operation	किसी एक ऑपरेशन का मेथड, पथ, विवरण और JSON अनुरोध स्कीमा (JSON request schema) लौटाता है; includeResponse: true विकल्प 200 प्रतिक्रिया (response) का स्कीमा भी जोड़ता है।
call_operation	JSON बॉडी के साथ एक ऑपरेशन चलाता है। प्रतिक्रिया बॉडी (response body) JSON के रूप में वापस आती है; 4xx या 5xx उत्तर स्टेटस और त्रुटि लिफाफे (error envelope) के साथ एक टूल त्रुटि के रूप में वापस आता है। एक वैकल्पिक idempotencyKey को Idempotency-Key हेडर के रूप में भेजा जाता है, जिससे उसी की (key) के साथ बार-बार किया गया कॉल प्रभाव को दोहराने के बजाय पहले वाले उत्तर को ही दोबारा दिखाता है।

सबसे अधिक उपयोग किए जाने वाले ऑपरेशंस अपने स्वयं के अनुरोध स्कीमा (request schemas) के साथ सीधे टूल्स भी हैं, ताकि सहायक (assistant) बिना किसी खोज के उनके फ़ील्ड्स देख सके: partners_list, partners_get, partners_create, partners_find_or_create, catalog_items_list, sales_invoices_list, sales_invoices_get, sales_invoices_create, sales_invoices_issue, sales_invoices_send, purchases_invoices_list, purchases_invoices_create, purchases_invoices_register, bank_transactions_list, bank_transactions_import, bank_transactions_match, ledger_journal_transactions_list, reports_trial_balance, reports_financial_statements, reports_vat_summary और reports_debt_aging। प्रत्येक टूल में MCP एनोटेशन (readOnlyHint, destructiveHint) होते हैं जो क्लाइंट को बताते हैं कि क्या यह डेटा लिखता है।

ऑपरेशन इंडेक्स और स्कीमा उसी OpenAPI विवरण से जनरेट होते हैं जिससे API reference और SDK जनरेट होते हैं, इसलिए API में जोड़ा गया कोई भी ऑपरेशन उसे जोड़ने वाले रिलीज़ के साथ ही search_operations में दिखाई देने लगता है। सर्वर के निर्देश सहायक को सम्मेलनों (conventions) की याद दिलाते हैं: राशियाँ दशमलव स्ट्रिंग (decimal strings) होती हैं, सूचियों (lists) में page, pageSize, sort और filter का उपयोग होता है, और किसी उस देश के बाहर की कंपनी के लिए देश-विशिष्ट फ़ाइलिंग 422 उत्तर देती है।