डेवलपर्स · API कुंजियाँ
TypeHop API कुंजी रेफ़रेंस
API कुंजी से कोई AI ऐप या आपका अपना कोड, आपके TypeHop खाते में सिंक हुए डिक्टेशन किसी भी डिवाइस से पढ़ सकता है। कुंजियाँ रीड-ओनली होती हैं: वे डिक्टेशन और आपके कस्टम शब्द खोज और पढ़ सकती हैं, पर कुछ भी बदल या हटा नहीं सकतीं। एक्सेस एक ही रिमोट MCP एंडपॉइंट के ज़रिए होता है, इसलिए Claude Code, Cursor और Codex जैसे ऐप्स सिर्फ़ एक लाइन के सेटअप से काम करने लगते हैं।
कुंजी बनाएँ
- TypeHop Mac ऐप खोलें और यहाँ जाएँ: Integrations → API keys।
- फिर Create API key दबाएँ और उसे उस ऐप या मशीन का नाम दें जो उसका इस्तेमाल करेगी, जैसे “Cursor on my laptop”।
- कुंजी को तुरंत कॉपी कर लें। TypeHop सिर्फ़ उसका हैश सहेजता है, इसलिए पूरी कुंजी एक ही बार दिखाई जाती है। खो गई? नई कुंजी बनाएँ और पुरानी रद्द कर दें।
कुंजियाँ thp_mcp_ से शुरू होती हैं। ऐप की सूची में हर कुंजी के शुरुआती अक्षर, उसके बनने का समय और आखिरी बार इस्तेमाल का समय दिखता है। कुंजी रद्द करते ही उसका इस्तेमाल करने वाले हर ऐप का एक्सेस तुरंत बंद हो जाता है।
ऑथेंटिकेशन
हर रिक्वेस्ट में कुंजी को Bearer टोकन के रूप में भेजें। कोई OAuth फ़्लो नहीं है और खोलने के लिए कोई सेशन भी नहीं।
- एंडपॉइंट
https://api.typehop.com/v1/mcp- मेथड
- सिर्फ़
POST।GETऔरDELETE405 लौटाते हैं। - हेडर
Authorization: Bearer thp_mcp_YOUR_KEY- बॉडी
- JSON-RPC 2.0,
Content-Type: application/json
कुंजी न होना या रद्द होना
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="typehop-mcp"
{ "jsonrpc": "2.0", "id": null, "error": { "code": -32001, "message": "This token is invalid or was revoked." } }AI ऐप कनेक्ट करें
ज़्यादातर लोग एंडपॉइंट को कभी हाथ से कॉल नहीं करते। Mac ऐप Connect an app के तहत Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Zed और Claude Desktop के लिए सटीक सेटअप दिखाता है, जिसमें आपकी नई कुंजी पहले से भरी होती है। यही स्निपेट MCP पेज पर भी हैं। उदाहरण के लिए, Claude Code:
claude mcp add --transport http typehop https://api.typehop.com/v1/mcp --header "Authorization: Bearer thp_mcp_YOUR_KEY"
Streamable HTTP पर रिमोट MCP सर्वर को सपोर्ट करने वाला कोई भी दूसरा क्लाइंट, एंडपॉइंट URL और ऊपर दिए हेडर के साथ काम करता है। Claude.ai और ChatGPT के कस्टम कनेक्टर के लिए OAuth चाहिए, जिसे TypeHop अभी सपोर्ट नहीं करता।
कोड से कॉल करना
एंडपॉइंट Model Context Protocol बोलता है: एक POST में JSON-RPC 2.0 संदेश, और बदले में एक JSON रिस्पॉन्स। यह स्टेटलेस है, इसलिए न कोई सेशन हेडर है और न server-sent events। समर्थित प्रोटोकॉल संस्करण: 2025-06-18, 2025-03-26, 2024-11-05.
1. Initialize (वैकल्पिक, पर MCP क्लाइंट इसे करते हैं)
curl https://api.typehop.com/v1/mcp \
-H "Authorization: Bearer thp_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0.0"}}}'2. टूल की सूची लें
curl https://api.typehop.com/v1/mcp \
-H "Authorization: Bearer thp_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'3. कोई टूल कॉल करें
curl https://api.typehop.com/v1/mcp \
-H "Authorization: Bearer thp_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_dictations","arguments":{"query":"launch plan","limit":5}}}'रिस्पॉन्स · 200
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"content": [
{
"type": "text",
"text": "[2026-11-03T09:14:22.000Z · Slack · id 3f6c1a2e-8b1d-4c55-9a0e-6b2f7d1e4c90]\nThe launch plan moves to next Tuesday..."
}
],
"isError": false
}
}नतीजे में हर डिक्टेशन एक हेडर लाइन से शुरू होता है: [created at · app · id <id>], फिर साफ़ किया हुआ टेक्स्ट। रॉ ट्रांसक्रिप्ट के लिए वही id get_dictation को दें। आप एक ही रिक्वेस्ट में 20 तक संदेशों की array भी भेज सकते हैं; नोटिफ़िकेशन (बिना id वाले संदेश) को बिना बॉडी के 202 मिलता है। ping समर्थित है।
टूल
हर टूल रीड-ओनली है और result.content[0].text में सादा टेक्स्ट लौटाता है।
search_dictations · डिक्टेशन खोजें
यूज़र के बोले हर डिक्टेशन पर फ़ुल-टेक्स्ट खोज। सबसे नए मिलान पहले लौटाता है।
query(string, ज़रूरी): ढूँढने के लिए शब्द या वाक्यांश।limit(integer 1–50, डिफ़ॉल्ट 20)
recent_dictations · हाल के डिक्टेशन
यूज़र के सबसे नए डिक्टेशन, चाहें तो सिर्फ़ पिछले कुछ दिनों के।
limit(integer 1–50, डिफ़ॉल्ट 20)days(integer 1–365): सिर्फ़ पिछले N दिनों के डिक्टेशन।
get_dictation · कोई डिक्टेशन पाएँ
id से एक डिक्टेशन: साफ़ किया हुआ टेक्स्ट और रॉ ट्रांसक्रिप्ट।
id(string, ज़रूरी): खोज या हाल के नतीजों में दिखाई गई id।
list_dictionary · कस्टम शब्द
यूज़र के कस्टम शब्द और वर्तनी (नाम, जार्गन)।
कोई आर्ग्युमेंट नहीं।
जब कोई टूल जवाब नहीं दे पाता (खाली क्वेरी, अज्ञात id, अस्थायी रीड विफलता), तब भी उत्तर एक 200 नतीजा ही होता है, जिसमें isError: true और एक ऐसा वाक्य होता है जिसे मॉडल पढ़ सकता है।
त्रुटियाँ
प्रोटोकॉल त्रुटियाँ JSON-RPC error ऑब्जेक्ट के रूप में लौटती हैं: { "code": <number>, "message": "<text>" }।
401 · -32001Authorization हेडर मौजूद नहीं है, या कुंजी अमान्य या रद्द की जा चुकी है।400 · -32700बॉडी मान्य JSON नहीं है।413 · -32600बॉडी 256 KB से बड़ी है।200 · -32600संदेश JSON-RPC 2.0 नहीं है ("jsonrpc": "2.0" या "method" गायब है)।200 · -32601अज्ञात मेथड।200 · -32602tools/call में ऐसे टूल का नाम दिया गया जो मौजूद नहीं है।500 · -32603सर्वर त्रुटि। बैकऑफ़ के साथ दोबारा कोशिश करें।
सीमाएँ और सुरक्षा
- सक्रिय कुंजियाँ
- प्रति खाता 10 तक। नई बनाने के लिए एक रद्द करें।
- रिक्वेस्ट का आकार
- प्रति रिक्वेस्ट 256 KB, प्रति बैच 20 संदेश तक।
- नतीजे
- प्रति कॉल 50 डिक्टेशन तक;
recent_dictationsअधिकतम 365 दिन पीछे तक देखता है। - दायरा
- आपके खाते में सिंक हुए डिक्टेशन, और आपके कस्टम शब्द। कुछ भी लिखा नहीं जाता।
- हर ऐप या मशीन के लिए एक अलग कुंजी इस्तेमाल करें, ताकि एक को रद्द करने से बाकी न टूटें।
- कुंजियाँ अपने कंप्यूटर या बैकएंड पर रखें। उन्हें कभी ब्राउज़र कोड, मोबाइल ऐप बंडल या पब्लिक रेपो में न डालें।
- कुंजी लीक हो जाए तो: Integrations → API keys में उसे रद्द करें। अगली रिक्वेस्ट से वह काम करना बंद कर देती है।
सवाल: support@typehop.com। इसके बजाय ओवरव्यू चाहिए? देखें TypeHop API।