Troubleshooting

setup issues tools icon not showing after restart the 🔧 icon in claude desktop's chat input should appear once the mcp server connects if it doesn't 1\ confirm mcp remote is installed npm list g mcp remote \# should show mcp remote\@x x x if missing npm install g mcp remote 2\ validate your json config open your config file mac /library/application support/claude/claude desktop config json windows %appdata%\claude\claude desktop config json common mistakes trailing comma after the last item in an object missing closing brace } unescaped double quotes inside the auth header string validate with cat /library/application\ support/claude/claude desktop config json | python3 m json tool if it errors, it'll show you the line number 3\ update claude desktop go to claude menu → check for updates the mcp integration requires a recent version 4\ check the logs mac /library/logs/claude/mcp server exotel log "authentication failed" or 401 error your token is wrong or expired regenerate the token echo n "your api key\ your api secret" | base64 common causes space or newline in the token string copied api key but not api secret (or vice versa) account sid doesn't match the credentials verify the account sid — log into my exotel com https //my exotel com → api settings the sid in your config must match exactly check the auth header format — it must be a valid json string with all fields { "token" " ", "from number" " ", "caller id" " ", "account sid" " ", "api domain" "https //api in exotel com", "exotel portal url" "https //my exotel com" } call issues call placed but phone doesn't ring check outbound calling is enabled — log into the dashboard → numbers the number you're calling from needs outbound calling active check account balance — prepaid accounts need credit dashboard → billing check the destination format — the number being called must be in international format ✅ +919xxxxxxxxx ❌ 9xxxxxxxxx ❌ 09xxxxxxxxx call rings but no bot voice / bot goes silent immediately enable greeting interruption is off — if the bot cuts out right after dialing, it's likely being interrupted by silence detection or ivr prompts ask claude to update the bot config update my voicebot to disable greeting interruption ivr screener — some mobile numbers play "record your name" before connecting the bot needs explicit instructions to handle this ask claude update my voicebot's instructions to handle ivr screeners — respond with name and purpose, then wait for connection account balance — insufficient balance can cause the call to connect but the voicebot session to fail silently call completed but claude returns no transcript the transcript takes a few seconds to appear after the call ends wait 10–15 seconds and ask get the transcript of my last voicebot call if it's still missing the call may have ended before the bot said anything (destination rejected, immediate busy) check the recording url from the call details — if there's a recording, there's a transcript bot gives wrong answer / goes off topic the bot's instructions need updating tell claude what the bot should do differently update my voicebot only ask about the delivery status, nothing else if asked anything else, say "i'll pass that to the team" and end the call sms issues sms not delivered check the dlt registration — in india, sms requires dlt (distributed ledger technology) registration templates must be pre approved transactional sms to unregistered templates will fail check the number format — destination must be +91xxxxxxxxxx check sender id — your sender id (the name that appears on the sms) must be registered sms delivered but content is wrong / truncated sms has a 160 character limit per segment longer messages are sent as multi part sms and may appear truncated on some handsets keep messages under 160 characters or confirm multi part delivery is enabled on your account region issues "invalid domain" or connection errors make sure your api domain matches your account type account type api domain india hosted https //api in exotel com globally hosted https //api exotel com how to tell check your exotel dashboard url if it's my in exotel com you're india hosted if it's my exotel com , use the global domain using the wrong one will cause authentication or connection failures getting more help check your logs first — /library/logs/claude/mcp server exotel log often has the exact error from the api exotel developer docs — developer exotel com/api/exotel mcp server https //developer exotel com/api/exotel mcp server exotel support — support exotel com https //support exotel com when contacting support, include your account sid the exact error message from the logs the tool you were trying to use