ThunderPhone को MCP सर्वर के रूप में उपयोग करें

Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code या किसी अन्य Streamable HTTP MCP क्लाइंट से ThunderPhone वॉइस एजेंट बनाएं, टेस्ट करें, वैलिडेट करें और संचालित करें।

ThunderPhone यहां एक स्ट्रीमेबल HTTP मॉडल कॉन्टेक्स्ट प्रोटोकॉल सर्वर उपलब्ध कराता है:

https://api.thunderphone.com/v1/mcp

यह किसी रिमोट MCP सर्वर को वॉइस एजेंट से कनेक्ट करने की विपरीत दिशा है:

प्रमाणित करें#

डायरेक्टरी क्लाइंट्स के लिए डिफ़ॉल्ट रूप से OAuth का उपयोग करें: साइन इन करें, एक संगठन चुनें, और मांगी गई अनुमतियों को अनुमोदित करें। संगठन → API कीज़ → अधिकृत ऐप्स में जाकर एक्सेस रद्द करें।

API key के साथ कॉन्फ़िगर किए गए क्लाइंट्स के लिए, संगठन → कीज़ में sk_live_ key बनाएं और इसे अपने MCP क्लाइंट में THUNDERPHONE_API_KEY के रूप में उपलब्ध कराएं। key एक संगठन से बंधी होती है; किसी दूसरे संगठन के स्वामित्व वाली id न मिलने जैसा व्यवहार करती है।

CLI और stdio विकल्प#

ThunderPhone CLI असंबंधित सर्वर्स को बनाए रखते हुए क्लाइंट कॉन्फ़िगरेशन लिख सकता है:

npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope user

@thunderphone/mcp के ग्लोबल इंस्टॉल के बाद, समान विकल्पों के साथ thunderphone-mcp setup का उपयोग करें। सेटअप Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop और Windsurf को सपोर्ट करता है। सीधा HTTP प्राथमिक है; Desktop stdio का उपयोग करता है।

किसी भी stdio-सक्षम क्लाइंट के लिए, command: "npx" को args: ["-y", "@thunderphone/mcp"] के साथ कॉन्फ़िगर करें। रैपर पहले THUNDERPHONE_API_KEY का उपयोग करता है, फिर thunderphone login के क्रेडेंशियल्स का, एक्सपायर हुए टोकन्स को रीफ्रेश करता है, और उसके बाद mcp-remote के माध्यम से OAuth का उपयोग करता है। डिवाइस लॉगिन और OAuth के लिए संबंधित API OAuth रोलआउट आवश्यक है। API key पाथ के लिए नहीं। सीधे HTTP कॉन्फ़िगरेशन CLI क्रेडेंशियल स्टोर को नहीं पढ़ते; डिवाइस लॉगिन को दोबारा उपयोग करने के लिए stdio रैपर का उपयोग करें।

ये नीचे दिए गए मैन्युअल क्लाइंट कॉन्फ़िगरेशन के विकल्प हैं।

क्लाइंट कॉन्फ़िगरेशन#

Claude और ChatGPT OAuth के साथ साइन इन करते हैं; इसमें कोई API key शामिल नहीं होती। अगर आपका अभी तक ThunderPhone अकाउंट नहीं है, तो साइन-इन पेज पर अकाउंट बनाएं चुनें और अपना ईमेल सत्यापित करने के बाद आप अप्रूवल स्क्रीन पर वापस आ जाएंगे।

Claude (वेब, डेस्कटॉप और मोबाइल)#

1. कस्टमाइज़ → कनेक्टर्स खोलें (पुराने वर्ज़न में सेटिंग्स → कनेक्टर्स)। अगर ThunderPhone कनेक्टर डायरेक्टरी में दिखता है, तो उसे चुनें। अन्यथा कस्टम कनेक्टर जोड़ें चुनें, उसका नाम ThunderPhone रखें और https://api.thunderphone.com/v1/mcp दर्ज करें।
2. कनेक्ट चुनें, ThunderPhone में साइन इन करें, संगठन चुनें और परमिशन अप्रूव करें।
3. किसी चैट में, टूल्स मेनू से ThunderPhone सक्षम करें और अपनी ज़रूरत के लिए पूछें, उदाहरण के लिए "मेरे एजेंट्स की सूची दिखाएं"।

Claude हर टूल का पहली बार उपयोग करने से पहले पूछता है। इनमें से ज़्यादातर प्रॉम्प्ट छोड़ने के लिए, कस्टमाइज़ → कनेक्टर्स → ThunderPhone खोलें और रीड-ओनली टूल्स को हमेशा अनुमति देने के लिए सेट करें। ये टूल्स केवल जानकारी देखते हैं: एजेंट्स, कॉल्स, ट्रांसक्रिप्ट्स, बैलेंस, डॉक्स। अगर आप हर बदलाव होने से पहले उसे देखना चाहते हैं, तो राइट/डिलीट टूल्स को अप्रूवल पर ही रखें।

कस्टम कनेक्टर्स के लिए पेड Claude प्लान चाहिए। Team और Enterprise प्लान में, पहले कोई ओनर संगठन की कनेक्टर सेटिंग्स के अंतर्गत कनेक्टर जोड़ता है, फिर हर सदस्य अपना ThunderPhone अकाउंट कनेक्ट करता है।

ChatGPT#

1. अगर ThunderPhone ChatGPT ऐप डायरेक्टरी में दिखता है, तो उसे चुनें और कनेक्ट करें।
2. अन्यथा सेटिंग्स → ऐप्स और कनेक्टर्स → एडवांस्ड सेटिंग्स खोलें, डेवलपर मोड चालू करें और URL https://api.thunderphone.com/v1/mcp तथा OAuth ऑथेंटिकेशन के साथ एक कनेक्टर बनाएं।
3. ThunderPhone में साइन इन करें, संगठन चुनें और परमिशन अप्रूव करें। टूल्स मेनू से ThunderPhone को किसी चैट में जोड़ें।

किसी एजेंट या फोन नंबर को हटाने, ड्राफ्ट को छोड़ने, कैंपेन लॉन्च करने और किसी बाहरी सिस्टम में लिख सकने वाले टेस्ट अनुरोध को भेजने पर दोनों ऐप्स में दूसरी पुष्टि मांगी जाती है; देखें विनाशकारी कार्रवाइयों की पुष्टि करना।

Claude Code#

claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
  --header "Authorization: Bearer $THUNDERPHONE_API_KEY"

Codex#

इसे ~/.codex/config.toml में जोड़ें:

[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"

Cursor#

.cursor/mcp.json बनाएं:

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}

Claude Desktop#

Claude Desktop कॉन्फ़िगरेशन में एक mcp-remote ब्रिज जोड़ें:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.thunderphone.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${THUNDERPHONE_API_KEY}"
      ],
      "env": {
        "THUNDERPHONE_API_KEY": "sk_live_YOUR_API_KEY"
      }
    }
  }
}

VS Code#

.vscode/mcp.json बनाएं और VS Code के इनपुट प्रॉम्प्ट के माध्यम से key दर्ज करें:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "thunderphone-api-key",
      "description": "ThunderPhone organization API key",
      "password": true
    }
  ],
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:thunderphone-api-key}"
      }
    }
  }
}

टूल्स#

हर टूल में MCP एनोटेशन होते हैं। तालिकाओं में R का अर्थ केवल-पढ़ने योग्य, D का अर्थ विनाशकारी, I का अर्थ आइडेम्पोटेंट, और O का अर्थ ओपन-वर्ल्ड/नेटवर्क इंटरैक्शन है। डैश का अर्थ है कि कोई संकेत सेट नहीं है।

कनेक्शन#

एजेंट्स#

फ़ोन नंबर और कैरियर्स#

SMS#

कॉल्स#

टेस्टिंग और वैलिडेशन#

नॉलेज#

इंटीग्रेशन्स, वेबहुक्स और रिमोट MCP सर्वर्स#

कैंपेन्स#

वॉइस, बिलिंग और दस्तावेज़#

सभी प्रोडक्ट टूल्स सार्वजनिक API के समान REST कोड पाथ्स का उपयोग करते हैं। इसलिए REST वैलिडेशन, संगठन स्कोपिंग, रोल्स, बिलिंग एडमिशन, कोटा, TCPA पुष्टि, प्रोवाइडर सुरक्षा और ऑडिट व्यवहार बिना बदलाव के लागू होते हैं।

विनाशकारी कार्रवाइयों की पुष्टि#

D से चिह्नित टूल किसी चीज़ को बदलते या हटाते हैं, या वास्तविक लोगों को डायल करना शुरू करते हैं। जिन कार्रवाइयों को वापस नहीं किया जा सकता, उनके लिए दो अनुरोध लगते हैं। पहला अनुरोध कुछ नहीं बदलता और यह लौटाता है:

{
  "status": "confirmation_required",
  "action": "Delete agent",
  "target": { "id": 195, "name": "Front Desk Receptionist" },
  "confirmation_token": "…",
  "expires_in_seconds": 600,
  "next_step": "…"
}

असिस्टेंट उपयोगकर्ता को दिखाता है कि क्या प्रभावित होगा और उसकी पुष्टि मांगता है। फिर वह उन्हीं आर्ग्युमेंट्स के साथ, confirmation_token जोड़कर, अनुरोध दोहराता है। टोकन 10 मिनट के लिए वैध होता है और एक संगठन, एक टूल और आर्ग्युमेंट्स के एक सटीक सेट को कवर करता है, इसलिए तीन एजेंट हटाने के लिए तीन पुष्टियों की आवश्यकता होती है। pause या stop के साथ campaign_action इस चरण को छोड़ देता है, ताकि चल रहे कैंपेन को हमेशा तुरंत रोका जा सके; GET के साथ test_integration भी ऐसा ही करता है। कुछ D टूल एक ही अनुरोध में चलते हैं, क्योंकि D उनके प्रभाव को चिह्नित करता है, सर्वर-साइड पुष्टि को नहीं: update_agent ड्राफ्ट में मौजूद कॉन्फ़िगरेशन को बदल देता है (discard_agent_draft इसे वापस करता है), deploy_agent लाइव कॉन्फ़िगरेशन को बदल देता है, update_phone_number लाइव कॉल को दोबारा रूट करता है, sync_mcp_server_tools रिमोट सर्वर के टूल कैटलॉग को बदल देता है, import_voip_numbers नंबरों को आपके कैरियर पर दोबारा पॉइंट करता है, run_agent_tests क्रेडिट खर्च कर सकता है, send_sms और place_call किसी वास्तविक व्यक्ति तक पहुंचते हैं (place_call अपनी अलग सहमति पुष्टि रखता है), और provision_phone_number एक नंबर खरीदता है। आपका MCP क्लाइंट फिर भी आपसे इन्हें मंज़ूरी देने के लिए कह सकता है।

स्टार्टर प्रॉम्प्ट#

prompts/list पाँच दोबारा इस्तेमाल किए जा सकने वाले वर्कफ़्लो उपलब्ध कराता है:

• create_inbound_receptionist
• run_agent_tests
• buy_and_attach_number
• review_low_grade_calls
• add_url_to_agent_knowledge

चलाने के लिए तैयार उपयोगकर्ता संदेश प्राप्त करने हेतु सूचीबद्ध प्रॉम्प्ट नाम और उसके घोषित आर्ग्युमेंट के साथ prompts/get का उपयोग करें।

रिसोर्स#

resources/list सार्वजनिक, कैश किए गए रेफरेंस उपलब्ध कराता है:

किसी एक को resources/read से पढ़ें। सार्वजनिक फ़ेच छोटे टाइमआउट, 2 MiB सीमा और दस मिनट के इन-प्रोसेस कैश का उपयोग करते हैं।

प्रोटोकॉल और त्रुटियां#

सर्वर 2025-06-18 और 2025-03-26 प्रोटोकॉल वर्जन सपोर्ट करता है; यह सपोर्ट किए गए क्लाइंट वर्जन को इको करता है और अन्यथा 2025-06-18 चुनता है। यह initialize, ping, टूल, प्रॉम्प्ट, रिसोर्स और नोटिफ़िकेशन इम्प्लीमेंट करता है। नोटिफ़िकेशन 202 Accepted लौटाते हैं। यह स्टेटलेस सर्वर SSE लिस्नर या सेशन हटाने की सुविधा एक्सपोज़ नहीं करता, इसलिए GET और DELETE, Allow: POST के साथ 405 Method Not Allowed लौटाते हैं।

टूल विफलताएं isError: true के साथ सफल JSON-RPC रिस्पॉन्स ही रहती हैं। इनके टेक्स्ट में एक छोटे वाक्य के बाद JSON ब्लॉक होता है:

{
  "code": "insufficient_balance",
  "detail": "There is not enough prepaid balance.",
  "next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}

place_call के लिए अलग outbound_tcpa_confirmation_required: प्रीफ़िक्स बनाए रखा गया है। अज्ञात JSON-RPC मेथड HTTP 200 रिस्पॉन्स में -32601 लौटाते हैं। MCP 2025-06-18 JSON-RPC बैच को सपोर्ट नहीं करता और एक साफ़ -32600 अमान्य-अनुरोध त्रुटि लौटाता है।