ThunderPhone चा MCP सर्व्हर म्हणून वापर करा

Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code किंवा दुसऱ्या Streamable HTTP MCP क्लायंटमधून ThunderPhone व्हॉइस एजंट तयार करा, चाचणी करा, पडताळा आणि चालवा.

ThunderPhone येथे स्ट्रीम करण्यायोग्य HTTP Model Context Protocol सर्व्हर उपलब्ध करून देते:

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

हे रिमोट MCP सर्व्हर व्हॉइस एजंटशी जोडण्याच्या उलट दिशेने कार्य करते:

प्रमाणीकरण#

निर्देशिका क्लायंटसाठी डीफॉल्टनुसार OAuth वापरा: साइन इन करा, संस्था निवडा आणि विनंती केलेल्या परवानग्या मंजूर करा. संस्था → API की → अधिकृत अॅप्स अंतर्गत प्रवेश रद्द करा.

API कीसह कॉन्फिगर केलेल्या क्लायंटसाठी, संस्था → की अंतर्गत sk_live_ की तयार करा आणि ती तुमच्या MCP क्लायंटला THUNDERPHONE_API_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 प्राधान्याचे आहे; Claude Desktop stdio वापरते.

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

हे खालील मॅन्युअल क्लायंट कॉन्फिगरेशन्सचे पर्याय आहेत.

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

Claude आणि ChatGPT OAuth सह साइन इन करतात; कोणतीही API की वापरली जात नाही. तुमचे ThunderPhone खाते अद्याप नसल्यास, साइन-इन पृष्ठावर खाते तयार करा निवडा आणि ईमेल सत्यापित केल्यानंतर तुम्ही मंजुरी स्क्रीनवर परत याल.

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

1. सानुकूलित करा → कनेक्टर्स उघडा (जुन्या आवृत्त्यांमध्ये सेटिंग्ज → कनेक्टर्स). कनेक्टर निर्देशिकेत ThunderPhone दिसल्यास ते निवडा. अन्यथा सानुकूल कनेक्टर जोडा निवडा, त्याला ThunderPhone नाव द्या आणि https://api.thunderphone.com/v1/mcp प्रविष्ट करा.
2. कनेक्ट करा निवडा, ThunderPhone मध्ये साइन इन करा, संस्था निवडा आणि परवानग्या मंजूर करा.
3. चॅटमध्ये, टूल्स मेनूमधून ThunderPhone सक्षम करा आणि तुम्हाला हवे ते विचारा, उदाहरणार्थ "माझे एजंट सूचीबद्ध करा".

Claude प्रत्येक टूल प्रथमच वापरण्यापूर्वी विचारते. यांपैकी बहुतांश प्रॉम्प्ट वगळण्यासाठी, सानुकूलित करा → कनेक्टर्स → ThunderPhone उघडा आणि फक्त-वाचन टूल्स नेहमी परवानगीवर सेट करा. ही टूल्स फक्त माहिती शोधतात: एजंट, कॉल, ट्रान्स्क्रिप्ट, शिल्लक रक्कम, दस्तऐवज. प्रत्येक बदल होण्यापूर्वी तुम्हाला तो पाहायचा असल्यास लेखन/हटवणे टूल्स मंजुरीवरच ठेवा.

सानुकूल कनेक्टरसाठी सशुल्क Claude प्लॅन आवश्यक आहे. Team आणि Enterprise प्लॅनमध्ये, मालक प्रथम संस्थेच्या कनेक्टर सेटिंग्जमध्ये कनेक्टर जोडतो, त्यानंतर प्रत्येक सदस्य त्यांचे स्वतःचे ThunderPhone खाते कनेक्ट करतो.

ChatGPT#

1. ChatGPT अॅप निर्देशिकेत ThunderPhone दिसल्यास ते निवडा आणि कनेक्ट करा.
2. अन्यथा सेटिंग्ज → अॅप्स आणि कनेक्टर्स → प्रगत सेटिंग्ज उघडा, डेव्हलपर मोड सुरू करा आणि https://api.thunderphone.com/v1/mcp URL व 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 च्या इनपुट प्रॉम्प्टद्वारे की प्रविष्ट करा:

{
  "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": "…"
}

सहाय्यक वापरकर्त्याला काय प्रभावित होईल ते दाखवतो आणि होकार विचारतो. त्यानंतर तो त्याच arguments सोबत confirmation_token जोडून विनंती पुन्हा पाठवतो. टोकन 10 मिनिटांसाठी वैध असते आणि ते एका संस्थेसाठी, एका टूलसाठी आणि arguments च्या एका अचूक संचासाठी लागू होते, त्यामुळे तीन एजंट हटवण्यासाठी तीन पुष्टीकरणे लागतात. 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 क्लायंट तरीही तुम्हाला त्यांना मंजुरी देण्यास सांगू शकतो.

प्रारंभिक prompt#

prompts/list पाच पुनर्वापरयोग्य वर्कफ्लो उपलब्ध असल्याचे दर्शवते:

• create_inbound_receptionist
• run_agent_tests
• buy_and_attach_number
• review_low_grade_calls
• add_url_to_agent_knowledge

चालवण्यासाठी तयार वापरकर्ता संदेश मिळवण्यासाठी सूचीतील prompt नाव आणि त्याचे घोषित arguments वापरून prompts/get वापरा.

संसाधने#

resources/list सार्वजनिक, कॅश केलेले संदर्भ उघड करते:

resources/read वापरून एक वाचा. सार्वजनिक fetch साठी कमी timeout, 2 MiB मर्यादा आणि दहा मिनिटांचा इन-प्रोसेस कॅश वापरला जातो.

प्रोटोकॉल आणि त्रुटी#

सर्व्हर 2025-06-18 आणि 2025-03-26 या प्रोटोकॉल आवृत्त्यांना समर्थन देतो; तो समर्थित क्लायंट आवृत्ती परत पाठवतो आणि अन्यथा 2025-06-18 निवडतो. तो initialize, ping, साधने, prompt, संसाधने आणि सूचना अंमलात आणतो. सूचनांसाठी 202 Accepted परत येते. हा स्टेटलेस सर्व्हर SSE listener किंवा सत्र हटवणे उघड करत नाही, त्यामुळे 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 अवैध-विनंती त्रुटी परत करतात.