ThunderPhone-ஐ MCP சர்வராகப் பயன்படுத்துங்கள்

Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code அல்லது வேறு Streamable HTTP MCP கிளையண்டிலிருந்து ThunderPhone குரல் ஏஜென்ட்களை உருவாக்கி, சோதித்து, சரிபார்த்து, இயக்குங்கள்.

ThunderPhone ஒரு Streamable 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-இன் உள்ளீட்டு prompt மூலம் விசையை உள்ளிடவும்:

{
  "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 என்பது திறந்த-உலகம்/நெட்வொர்க் தொடர்பு என்பதைக் குறிக்கும். கோடு என்றால் எந்தக் குறியீடும் அமைக்கப்படவில்லை என்பதாகும்.

ஏஜென்ட்கள்#

தொலைபேசி எண்கள் மற்றும் கேரியர்கள்#

அழைப்புகள்#

சோதனை மற்றும் சரிபார்ப்பு#

அறிவு#

ஒருங்கிணைப்புகள், webhook-கள் மற்றும் தொலைநிலை 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 இந்தப் படிநிலையைத் தவிர்க்கும்; இதனால் இயங்கிக்கொண்டிருக்கும் பிரச்சாரத்தை எப்போதும் உடனடியாக நிறுத்தலாம்.

தொடக்க 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 பெயர் மற்றும் அதற்காக அறிவிக்கப்பட்ட arguments உடன் prompts/get ஐப் பயன்படுத்தவும்.

வளங்கள்#

resources/list பொதுவான, கேச் செய்யப்பட்ட குறிப்புகளை வழங்குகிறது:

ஒன்றைப் படிக்க resources/read ஐப் பயன்படுத்தவும். பொதுவான பெறுதல்கள் குறுகிய காலவரம்பு, 2 MiB வரம்பு மற்றும் பத்து நிமிட in-process கேச்சைப் பயன்படுத்துகின்றன.

நெறிமுறை மற்றும் பிழைகள்#

சர்வர் 2025-06-18 மற்றும் 2025-03-26 நெறிமுறை பதிப்புகளை ஆதரிக்கிறது; ஆதரிக்கப்படும் கிளையன்ட் பதிப்பை எதிரொலிக்கும், இல்லையெனில் 2025-06-18 ஐத் தேர்ந்தெடுக்கும். இது initialize, ping, கருவிகள், prompt-கள், வளங்கள் மற்றும் அறிவிப்புகளைச் செயல்படுத்துகிறது. அறிவிப்புகள் 202 Accepted ஐத் திருப்பும். இந்த நிலையற்ற சர்வர் SSE listener அல்லது session நீக்கலை வழங்காது; எனவே 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 batch-கள் MCP 2025-06-18 ஆல் ஆதரிக்கப்படுவதில்லை; அவை சுத்தமான -32600 தவறான-கோரிக்கை பிழையைத் திருப்பும்.