OAuth & Directory
There are two ways to connect Claude Code (or any MCP client) to your PugBase workspace. Both give Claude the same tools - they just connect in different ways.
Two ways to connect
API key (manual)
Create a pgb_ key in Settings -> Developer and paste it into a .mcp.json or the claude mcp add command. Best for a project you wire up yourself; the key is scoped to one workspace. See Installation.
OAuth (Connect button)
Click Connect in a client that supports the MCP Connectors Directory - no key to copy. You sign in to PugBase, pick a workspace, and approve. This is how PugBase appears in the Claude Connectors Directory.
Connecting over OAuth
- 1In the client, add PugBase and press Connect. It opens a PugBase page in your browser.
- 2Sign in to PugBase if you are not already - your normal account, no separate password.
- 3Choose which workspace to grant, then press Allow. The client receives access and the connection goes live.
- 4The grant is scoped to that one workspace and can be revoked anytime.
Manage connected apps
Every app you authorize over OAuth appears under Connected apps in Settings -> Developer, with the workspace it can reach. Press Disconnect to revoke its access immediately.
For developers
PugBase is a standards-compliant OAuth 2.1 server, so any MCP client connects with the normal Connect flow - it registers itself automatically (using PKCE), with nothing to set up by hand. Tokens are short-lived and refresh on their own. You sign in with your normal PugBase account; OAuth just lets the client act on your behalf until you disconnect it.
Discovery endpoints
https://pugbase.io/.well-known/oauth-protected-resource https://pugbase.io/.well-known/oauth-authorization-server