Troubleshooting

The client can’t connect or keeps asking to sign in

• Check the URL: https://mcp.warmup.social/mcp, including /mcp at the end.
• Make sure the client supports remote servers over Streamable HTTP. Older clients that only run local (stdio) servers can’t connect directly.
• If you revoked the app in MCP → Connected apps, remove the server in the client and add it again.

“401 Unauthorized” in the middle of a session

The access token expired. Good clients refresh it automatically; if yours doesn’t, reconnect the server (in Claude Code: /mcp → warmup → re-authenticate).

With an API token, a 401 means the token was revoked or expired — create a new one in API tokens.

The agent says a network needs re-authorization

A connection with status needs_reauth lost access in Meta (password change, expired permissions, revoked app). Ask the agent to reconnect it — it calls start_connection again and gives you a new link. You can also reconnect on the project page in the dashboard.

Facebook: “choose a Page”

If your Facebook account manages several Pages, sign-in ends on a page picker in the dashboard. Pick the Page there, or give the agent the selectionId from the URL so it can call list_pending_facebook_pages and select_facebook_page.

“project_limit_reached”

Your plan allows a limited number of projects. Delete or archive one, or upgrade the plan in the dashboard.

Analytics is empty

• Analytics covers tracked accounts, added in the dashboard under Analytics → Accounts. Connecting a network to a project doesn’t add it to analytics.
• Check role: competitors are only included with role: competitor.
• New accounts need some time for the first data collection.