Skip to main content
Start with the symptom you see. Most issues come from the app’s own settings, an expired or revoked access, or a limit.

Connecting

  • Check the address is exactly https://mcp.spyro.app/mcp with no extra spaces or trailing text.
  • The server uses streamable HTTP. If your app has a transport option, choose HTTP or Streamable HTTP, not SSE. In Cline set "type": "streamableHttp".
  • Restart your app after editing a config file. Some apps read it only at launch.
  • Check that your app supports remote MCP servers on your plan.
Sign-in requests last a few minutes and work once. Start the connection again from your app.
The app sent a return address that does not match its registration. Remove the connector in your app, add it again, and retry. If you use an OAuth client, check its redirect URIs match the app exactly.
A workspace can connect only if you are its admin, its plan includes MCP and its subscription is active. The screen tells you which one is missing. AppSumo License Tier 1 does not include MCP.
Spyro AI verifies only a few web apps (claude.ai, ChatGPT, Perplexity). Apps on your own computer, such as Claude Code, Cursor, VS Code, Codex and Gemini CLI, and Gemini always show this warning. It still works. Continue only if you started the connection yourself, and check the address it will send you back to.
These options depend on your plan and workspace settings, and may need a workspace admin to turn them on or to enable developer mode. Check your app’s own help.

Errors your app may show

  • Invalid MCP key: the key was revoked, mistyped, or its creator is no longer a workspace admin. Create a new key.
  • Missing credential: the app did not send a key or sign in. Check the header is Authorization: Bearer sk_mcp_... or X-API-Key: sk_mcp_.... Keys in a URL are ignored.
  • Invalid or expired access token: sign in again from the app. Tokens refresh on their own, but a revoked or long-unused connection must be reconnected.
  • No workspace is connected to this app: the connection lost all its workspaces. Reconnect and tick a workspace.
MCP is included on every plan except AppSumo License Tier 1, and your subscription (or trial) must be active. Check Plans, billing & usage. With a sign-in connection the same problem shows as a tool message instead: “MCP is not included in this workspace’s plan” or “This workspace’s Spyro AI subscription is not active”.
Paid tools (10 credits) and actions that spend credits stop when the pool is empty. The message shows the date credits reset. Free tools keep working. You can upgrade your plan to continue sooner.
The daily cap resets at midnight UTC. To raise it, create a new key with a higher cap, or disconnect the app and connect it again with a higher limit.
Every change waits for your confirmation. Open the link, check the summary and click Confirm, then ask your app to run the same request again to get the result. Nothing changes until you confirm. See Confirming changes.
Links last 10 minutes, work once, and only for the person who connected the app. Ask your app to make the change again to get a new link.
You clicked Cancel on the confirmation page. Ask your app again if you change your mind.
You hit the rate limit of 60 calls per minute per connection, or a per-tool daily limit. Wait the time shown. See Credits and limits.
The same paid call ran 3 times in 10 minutes. Reuse the earlier answer or change the request.
The same paid call is still in progress. Wait a moment and ask again.
A temporary problem on the data side. The credits for a failed paid call are refunded. Try again, and contact support at hello@spyro.app if it keeps happening.
You signed in with more than one workspace. The app must call listWorkspaces and pass one of the returned ids as workspace. Ask it: “List my Spyro AI workspaces, then use the one for example.com.”
You approved Read only. Disconnect the app and connect it again with Read and take actions. For a key, create a new key with Read + actions.

Questions about answers

Connect it in Spyro AI first. See Google Search Console. Bing’s and Google’s AI performance reports have no public data feed yet, so they are not available.
New workspaces need their first crawl and audit to finish. Check your dashboard, then ask again.
Reading your own Spyro AI data is free. Tools that search the web, read other pages or run a model cost 10 credits. Some actions, such as writing an article or running keyword research, cost what they cost in the dashboard. See Credits and limits.

FAQ

Signing in gives the app a token that works for Spyro AI only, never your password. You choose the workspaces, the access level and a daily credit cap, and you can revoke it any time. Spyro AI stores which tool ran and the credits used, not the results.
No. A key works for one workspace. A sign-in works only for the workspaces you ticked, and each call re-checks that you are still an admin there.
No. Apps like Claude, ChatGPT and Gemini need only a web address and a sign-in.
It reads the same data and shares most read and research tools, plus MCP-only tools that make changes and read deeper into each area. A few agent tools, such as live keyword data and SERP lookups, are not on MCP; use manageKeywords instead. The in-app AI agent charges a flat 10 credits per answer. Over MCP each tool call is priced on its own, and most are free.

Still stuck?

Email hello@spyro.app with the app you use, the time of the problem and the exact message you saw. Never include a key.