Choosing a workspace and permissions for MCP

Understand which workspace a connected AI tool can use and how OAuth permissions differ from API keys.

The hosted MCP connection signs in through OAuth. It acts as your account in the workspace approved for that connection, subject to your current access there.

Choose the workspace

Choose the intended workspace on the connection's consent screen. You can select a workspace you belong to, including one you were invited to; membership does not automatically give you permission for every action or app.

New connections stay bound to the approved workspace. Switching workspaces in the Overskill dashboard does not move that connection. Reconnect and approve the intended workspace when you need a different one. Older connections created before the workspace picker may use your current workspace; reconnect them to make the choice explicit.

Have the connected tool list the apps it can access before asking it to change anything. Builder work spends the workspace's credits.

Read-only access

Read and write permissions are checked separately. An OAuth client can request read scopes, but the scopes shown on its consent screen are the ones that client requested. Do not approve a request for write access and assume the connection is read-only because you told the assistant not to edit.

Whether your MCP client lets you customize requested scopes depends on that client. The hosted /mcp endpoint requires OAuth; a read-only Partner API key is not a replacement credential for it. For programmatic reads with a key, use the Partner REST API and a key with only the required read permissions.

Was this helpful?

Thanks for the signal — it helps us improve the docs.

More in Advanced

Using Overskill from AI agents (Claude, Cursor, Codex)

Connect your assistant to Overskill with the hosted MCP URL and browser sign-in. Check the connected team, access and credits before building.

Getting started with the Overskill partner API

Generate, manage, and deploy apps programmatically. Auth, the core call sequence, and working code in Node, Python, and curl.

Overskill API errors and how to handle them

What 401s, rate limits, credit exhaustion, and other API errors look like — and the right way for your code (or your agent) to respond.

Still need help?

If this didn't answer your question, our team is one click away.