Troubleshooting

Fix common Social0 MCP connection, auth, media, and publish issues.

Remote connector

Use when you need MCP (no CLI). Hosted URL: https://mcp.social0.app/mcp.

SymptomCauseFix
Connector won’t connectWrong URLUse exactly https://mcp.social0.app/mcp
OAuth fails / loopsSession or popup blockedAllow popups; retry Connect; revoke old connector key in API keys and reconnect
Tools missing after connectHost cacheDisconnect/reconnect the connector; restart the AI app
Media upload fails with file_pathHosted server can’t read sandbox pathsUse upload_media with a public url or base64 data

Local npx auth

SymptomCauseFix
SOCIAL0_API_KEY is requiredMissing env varSet SOCIAL0_API_KEY in MCP host config env
401 / invalid_api_keyRevoked or wrong keyCreate a new key in Developer settings
npx failsOld NodeInstall Node.js 20+

Accounts and platforms

SymptomCauseFix
No connected accountsPlatforms not linkedConnect accounts first
Multiple accounts on one platformAmbiguous nameCall list_accounts, then pass a UUID

Publish status

SymptomCauseFix
Status stuck on processingVideo still uploadingPoll get_publish_status every few seconds; video can take minutes
partialMixed platform resultsCheck per-platform errors; reconnect failed accounts