PlugsightDocs

Troubleshooting

How to find out why something isn't working, where Plugsight shows the reason, and every error message explained by symptom.

When your AI can't see an account, can't send, or shows an error, Plugsight almost always says why in one of four places. Check them in this order.

1. The account's row on Connections

Open Connections and find the account.

  • Status shows Connected or Reconnect needed. With Reconnect needed, the line underneath gives the reason, such as "Google sign-in was revoked or has expired." Click Reconnect on the row. See Reconnect needed.
  • The line under the account's name says which MCP servers it's in. "not in any MCP server" means your AI can't use it yet. See Your AI can't see an account.
  • The line under the account's switch (in Write access) says whether your AI can make changes with it, and if not, the one thing stopping it:
Line under the switch What it means
Ready: your AI asks you in the chat before each change. Changes can happen, after your yes in the chat.
Off: your AI can read, but can't change anything. The switch is off. Click it to turn it on. Email accounts say "can read and write drafts".
Not in any MCP server yet. Add it to one on MCP servers. Put the account in an MCP server first.
Not yet: the MCP servers with this account are read-only. Open the MCP server, click Edit configuration and tick Allow changes.

Instead of a switch, you may see:

  • Read-only with a lock: the service only reads, or the account was connected with read access only. Click it for the reason.
  • Drafts only · Upgrade or Read-only · Upgrade: changes are on the Pro plan. See Plans and limits.
  • Paused: changes of this type are paused on Permissions.

2. The red banners at the top of the page

  • "1 connection needs reconnecting." (or more): lists each account whose login stopped working, with the reason and a Reconnect button. AI apps can't use those accounts until you reconnect.
  • "All changes are paused." or, for example, "Email changes are paused.": a pause on the Permissions page is on. Your AI can still read and write drafts, but can't send or change anything of that type, whatever the account switches say. Click Resume, or Manage to open Permissions.
  • "Refresh Claude to use your changes" (or ChatGPT, Cursor and so on): your AI app still has an old list of tools. Follow the steps in the notice. See Your AI can't see an account.

3. Activity

Activity lists everything your AI did, with a result for each:

Result What it means
Succeeded The read or change went through.
Blocked One of your own safety settings stopped it before anything happened: the account's switch was off, the MCP server is read-only, changes were paused, or the daily email limit was reached. The reason is shown underneath.
Failed The service refused it or didn't answer, for example an expired sign-in or a ticket that no longer exists. Nothing was changed. The service's message is shown underneath.

Find the message under the badge in the articles below.

4. What your AI says

When a tool is refused, your AI gets a message explaining why, and usually passes it on. Ask your AI to "list my accounts" to see which accounts it can reach and whether each one may send or make changes.

Find your problem

Still stuck?

Email info@plugsight.app with what you tried, the exact message you saw and roughly when it happened.