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 प्राधान्याचे आहे; 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 प्लॅन आवश्यक आहे. 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 खुल्या-जगातील/नेटवर्क परस्परसंवाद. डॅशचा अर्थ कोणताही संकेत सेट केलेला नाही.

एजंट#

फोन नंबर आणि कॅरियर#

कॉल#

चाचणी आणि प्रमाणीकरण#

ज्ञान#

इंटिग्रेशन्स, वेबहुक्स आणि रिमोट 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 ही पायरी वगळते, त्यामुळे सुरू असलेली मोहीम नेहमी लगेच थांबवता येते.

प्रारंभिक prompt#

prompts/list सहा पुन्हा वापरता येण्याजोगे कार्यप्रवाह दर्शवते:

• create_inbound_receptionist
• run_agent_tests
• import_vapi_assistants
• buy_and_attach_number
• review_low_grade_calls
• add_url_to_agent_knowledge

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

संसाधने#

resources/list सार्वजनिक, कॅश केलेले संदर्भ उपलब्ध करून देते:

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

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

सर्व्हर 2025-06-18 आणि 2025-03-26 या प्रोटोकॉल आवृत्त्यांना समर्थन देतो; तो समर्थित क्लायंट आवृत्ती परत पाठवतो आणि अन्यथा 2025-06-18 निवडतो. तो initialize, ping, साधने, prompt, संसाधने आणि सूचना लागू करतो. सूचना 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 परत करतात. JSON-RPC बॅचेसना MCP 2025-06-18 समर्थन देत नाही आणि त्या स्वच्छ -32600 अवैध-विनंती त्रुटी परत करतात.