Troubleshooting

If every tool call comes back saying permission was denied, stop here. That is not a broken install. Your project has not been approved for Developer Preview yet, and nothing else will work until it is.

Installing and upgrading

What you see	What it means
The installer has no MCP Hub section	Access follows a licence, granted per account. Buy one at hub.magicmealkits.com/buy with the same address you sign in to the installer with
Deploying stops on billing	The project has no billing account linked. The message has a button that opens the right page. Link one, then deploy again
No Upgrade now button, though a newer version exists	You are already on the newest version. If your hub predates version tracking, write to us at hub.magicmealkits.com and we will move you
Every connector suddenly wants to connect again	Something reissued your admin token. Stopping the hub and deploying again does that. Upgrading does not
Everything stops, and the screen says this hub is not licensed	Your beta period has ended. Write to us at hub.magicmealkits.com and we will extend it
You want to change the region	It is fixed once deployed. Changing it means stopping the hub and deploying again, which reissues your admin token so every connector reconnects
You upgraded the hub, and Claude still does not see the change	Claude keeps its own copy of the tool list. See refreshing Claude’s tool list

Developer Preview

What you see	What it means
Permission denied on every tool call	Your project is not approved yet. See Developer Preview
Google tools answer that the client isn’t marked as an AI agent	One checkbox on your OAuth client, see marking the client for an AI agent
The check reports APIs it could not enable	Expected before approval. Those are the ones approval unlocks
No reply a week after applying	Check spam, then contact workspace-dpp-mod@google.com
The application was rejected	Almost always a Gmail address, service account or group address in the registered email field. Reapply with a Workspace address
Approved, but still permission denied	The approved project is not the one holding that account’s credentials. Approval is per project. Clients in the admin screen now flags this for you
One account works, another does not	Same cause. That account’s credentials live in a project that was never registered
You pasted the client id and secret from the wrong project	Move the account to the right client and reconnect it. See connecting an account with the wrong OAuth client
You want to move an account onto a different client	Open the account and press Change client. See connecting an account with the wrong OAuth client for the full steps

Checking this yourself

The admin screen checks it for you now. Open Clients and any OAuth client whose project does not match the one your hub runs in gets a highlighted box naming both project numbers.

The Clients screen, with a highlighted warning box naming the OAuth client's project number and the hub's own project number, which do not match

This is a warning, not an error, so it never blocks adding the account or the client. Having a client in a different project is normal for the second-project case in Developer Preview. It only means something if that second project was never registered: check the two numbers the box gives you against what you applied with. If you did not mean to use two projects at all, and the client simply came from the wrong one, replacing it is the fix rather than registering it. See connecting an account with the wrong OAuth client. If the second project is deliberate, press This is what I meant on the warning and it stops coming back for that client. Claude can do this too. Ask it to move an account onto a different client and it will do the swap and give you the sign-in link. No need to open the admin screen. The sign-in itself is still yours to do.

Connecting a Google account

What you see	What it means
The account connects, but can do nothing	Select all was left unticked on Google’s permissions screen. Reconnect the account and tick it
Google says the redirect address does not match	The address from the installer’s OAuth card is not in your client’s authorised redirect URIs, or was pasted with a character missing
Google warns the app is not verified	Expected on your own app. Choose Advanced, then the “go to” link
An account keeps needing reconnecting, about weekly	Your consent screen is still in Testing. Publish it and this stops. Verification is not what fixes it
An account is marked as needing attention	Its sign-in expired or was revoked. Press Reconnect on the account
You want the hub to stop using an account for a while, without deleting it	Open the account, then its menu, then Disconnect. The account and its settings stay, the sign-in is removed, and Connect brings it back. Google will ask for permission again
Adding a service asks you to reconnect	Expected. The new service needs permissions the account has not granted yet. Removing a service does not ask

Connecting a Notion workspace

What you see	What it means
Pressing Connect opens the Notion app on your phone, and the account stays unconnected	The app claims Notion’s sign-in link. Connect from a computer instead. See connecting a Notion workspace
Claude does not see the Notion account you just connected	Claude keeps its own copy of the tool list. See refreshing it
A Notion account needs reconnecting	Notion ended the connection on its side. Press Reconnect on the account, from a computer

Connecting a Plaud account

What you see	What it means
Claude does not see the Plaud account you just connected	Claude keeps its own copy of the tool list. See refreshing it
A Plaud account needs reconnecting	Plaud ended the connection on its side. Press Reconnect on the account. See connecting a Plaud account
Claude says it cannot change something in Plaud	Expected. Plaud’s tools only read recordings, transcripts and notes

Diagnostics

The admin screen can check the hub over and tell you what it finds. Open Diagnostics. Each item says what it found, the actual values it read to decide, and what to do about it. Some items have a button, because the hub can try that one itself: fetching the tool list from Google again, rebuilding the list of tools it offers, reloading the addresses an account can send from. Pressing one runs the check again straight away, so the page shows the result rather than telling you to look again.

What you see	What it means
A tool does not offer an account you connected	This is the one to open Diagnostics for. It names the account and the service and offers to rebuild the tool list
Nothing looks wrong here, but Claude disagrees	Claude may still be on the tool list it fetched earlier. Start a new chat
Tool definitions came from the saved copy	Normal shortly after the hub starts. It fetches them again on its own; the button does it now
An OAuth client is in a different project	The same warning the Clients screen gives, gathered here with everything else. See Developer Preview

Claude can do this too. Ask it to check the hub and it will read the same report and, where the hub can fix something itself, offer to run it. That covers only the hub checking its own state: it never touches your mail, calendar or files.

Connecting Claude or another connector

What you see	What it means
Claude connects but shows no tools	Nothing could be registered while Developer Preview was closed. Press Refresh next to the schema status in the admin screen, once
Claude does not see a change you just made	Adding an account, enabling a service, and upgrading the hub all change the tool list, and Claude keeps its own copy. See refreshing Claude’s tool list
Claude cannot reach the server	The address does not match what your hub publishes. Copy it again from the installer rather than retyping it
You want to use ChatGPT or something else	The same address works anywhere that takes a custom MCP server. Only the name of the screen changes

Sending mail

What you see	What it means
Claude writes drafts but will not send	Sending is off for that account until you turn it on. Open the account in the admin screen, under Sending
Mail from two addresses arrives looking the same	Gmail keeps a display name per address, and they usually start out identical. How to change it
Mail went out from the wrong address	Name the address in the request. Without one it goes from the address that account normally sends from

Deleting and labelling Gmail messages

If Claude cannot move mail to the bin, add or remove a label, or mark mail as read, and says a permission is missing, reconnect that Google account once. Changing a message needs Gmail’s modify permission, and accounts connected before v0.42.0 were connected without it. Reading mail and writing drafts keep working whether or not you reconnect.

Upgrade the hub to v0.42.0 or later.
Open the Google account in the admin screen and press Reconnect, top right.
Choose the account on Google’s screen and allow the new Gmail permission. If Google says the app is unverified, go on through Advanced, as you did when you first connected.
Ask Claude again.

A Google account opened in the admin screen, with the Reconnect button at the top right circled in red

If you have several Google accounts connected, reconnect each one you want to tidy mail in.

Still stuck

Setting up, from the beginning
Developer Preview, in full

​Installing and upgrading

​Developer Preview

​Checking this yourself

​Connecting a Google account

​Connecting a Notion workspace

​Connecting a Plaud account

​Diagnostics

​Connecting Claude or another connector

​Sending mail

​Deleting and labelling Gmail messages

​Still stuck

Installing and upgrading

Developer Preview

Checking this yourself

Connecting a Google account

Connecting a Notion workspace

Connecting a Plaud account

Diagnostics

Connecting Claude or another connector

Sending mail

Deleting and labelling Gmail messages

Still stuck