MCP Troubleshooting Guide

Quick Diagnostics

1. Check Server Status

curl -I https://www.pantrypersona.com/api/mcp

Expected: HTTP/2 200 or 405 (Method Not Allowed for GET is normal)

2. Verify Tool Discovery

curl -X POST https://www.pantrypersona.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Should return a JSON list of 20 tools.

Common Issues

Connection Refused / Timeout

Symptoms:

"Connection refused" error
"Request timeout" error
MCP client shows server as offline

Solutions:

Check your internet connection
Verify URL is exactly: https://www.pantrypersona.com/api/mcp
Ensure using HTTPS (not HTTP)
Check if corporate firewall blocks external MCP connections

OAuth Authorization Fails

Symptoms:

"Authorization failed" error
Redirect loop during sign-in
"Invalid client" error

Solutions:

Clear browser cookies for pantrypersona.com
Try in an incognito/private window
Disable password manager autofill temporarily
Use a supported browser (Chrome, Firefox, Safari, Edge)

Tools Not Appearing

Symptoms:

Server connects but no tools visible
"No tools available" message

Solutions:

Restart your MCP client
Verify authorization completed successfully
Check server is listed in client's MCP settings
For Claude Code: run /mcp to check status

Authentication Expired

Symptoms:

"Token expired" error
"Please re-authorize" message
Tools stop working after period of time

Solutions:

Most clients auto-refresh tokens - just retry the operation
If persistent, disconnect and reconnect the server
Clear any cached credentials in your client

Platform-Specific Issues

ChatGPT

Developer Mode Not Available

Ensure you're on web (not mobile app)
Check Settings > Apps & Connectors > Advanced Settings
Clear browser cache and reload

Connection Keeps Disconnecting

Check that "Pantry Persona" appears in your Apps list
Try removing and re-adding the connection
Verify OAuth completed (should see "Connected" status)

Claude Code

Server Not Recognized

Check config file location:
- macOS/Linux: ~/.config/claude/config.json
- Windows: %USERPROFILE%\.config\claude\config.json
Verify JSON syntax is valid
Restart Claude Code after config changes

OAuth Window Doesn't Open

Check popup blocker settings
Run Claude Code from a terminal with browser access
Manually open the authorization URL if shown

Error Reference

Error	Meaning	Fix
ECONNREFUSED	Can't reach server	Check URL, internet, firewall
401 Unauthorized	Token invalid/expired	Re-authorize
403 Forbidden	No permission	Check account status
429 Too Many Requests	Rate limited	Wait and retry
500 Internal Error	Server issue	Wait and retry; contact support

Reset Connection

If nothing else works, try a complete reset:

Remove Pantry Persona from your MCP client
Clear browser data for pantrypersona.com
Restart your MCP client
Re-add the server with URL: https://www.pantrypersona.com/api/mcp
Complete OAuth authorization

Still having issues?

Before contacting support, please note your MCP client version and any error messages.

Contact Support