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. જો ThunderPhone ChatGPT એપ ડિરેક્ટરીમાં દેખાય, તો તેને પસંદ કરો અને કનેક્ટ કરો.
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 ઓપન-વર્લ્ડ/નેટવર્ક ઇન્ટરૅક્શન છે. ડૅશનો અર્થ છે કે કોઈ સંકેત સેટ નથી.

એજન્ટ્સ#

ફોન નંબર્સ અને કેરિયર્સ#

કૉલ્સ#

પરીક્ષણ અને માન્યતા#

જ્ઞાન#

ઇન્ટિગ્રેશન્સ, વેબહૂક્સ અને રિમોટ 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": "…"
}

assistant વપરાશકર્તાને શું અસરગ્રસ્ત છે તે બતાવે છે અને હા માટે પૂછે છે. ત્યારબાદ તે સમાન દલીલો સાથે અને confirmation_token ઉમેરીને વિનંતિ ફરી કરે છે. ટોકન 10 મિનિટ માટે માન્ય હોય છે અને એક સંસ્થા, એક ટૂલ અને દલીલોના એક ચોક્કસ સમૂહને આવરી લે છે, તેથી ત્રણ એજન્ટ કાઢી નાખવા માટે ત્રણ પુષ્ટિઓ જરૂરી છે. pause અથવા stop સાથેનું campaign_action આ પગલું છોડી દે છે જેથી ચાલી રહેલી કેમ્પેઇનને હંમેશાં તરત રોકી શકાય.

પ્રારંભિક prompts#

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 વડે એક વાંચો. જાહેર ફેચ ટૂંકા timeout, 2 MiB મર્યાદા અને દસ મિનિટના in-process cache નો ઉપયોગ કરે છે.

પ્રોટોકોલ અને ભૂલો#

સર્વર 2025-06-18 અને 2025-03-26 પ્રોટોકોલ વર્ઝનને સપોર્ટ કરે છે; તે સપોર્ટેડ ક્લાયન્ટ વર્ઝનને echo કરે છે અને અન્યથા 2025-06-18 પસંદ કરે છે. તે initialize, ping, ટૂલ્સ, prompts, resources અને notifications અમલમાં મૂકે છે. Notifications 202 Accepted પરત કરે છે. આ stateless સર્વર SSE listener અથવા session deletion પ્રદર્શિત કરતું નથી, તેથી 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: prefix જાળવી રાખવામાં આવે છે. અજાણી JSON-RPC methods HTTP 200 પ્રતિભાવમાં -32601 પરત કરે છે. JSON-RPC batches ને MCP 2025-06-18 દ્વારા સપોર્ટ કરવામાં આવતા નથી અને તે સ્વચ્છ -32600 invalid-request ભૂલ પરત કરે છે.