PromptScout Docs: Connect MCP with OAuth and Brand Access

PromptScout MCP beta

PromptScout MCP is in beta for eligible Growth-and-higher teams. It lets an MCP client use PromptScout context and selected actions for one approved brand without sharing a manual token.

Availability is intentionally limited during beta. If MCP access is not available in your brand's Integrations page, your team or plan is not enabled for this connection yet. This guide does not guarantee that every MCP client supports the required OAuth flow.

Before you connect

You need:

A PromptScout account with an eligible team and a selected brand.
Access to that brand's Integrations page.
An MCP client your team has confirmed can connect to a remote server through OAuth.
Authority to approve access for the selected brand and any requested write permissions.

Connect a client

Open your brand dashboard and go to Integrations.
In MCP access, copy the displayed MCP server URL: https://mcp.promptscout.app/mcp.
Add that URL in your MCP client's server settings.
Complete the OAuth sign-in and review the client, selected brand, and requested permissions before approving.
Return to Integrations to confirm the connected client, authorization date, and last-used state.

Each connection is limited to the brand you approve. A connected client is not a general PromptScout account connection.

Connect a specific client

Every client below uses the same server URL and the same browser OAuth approval. Your brand's Integrations page shows the exact command or configuration for the client you pick.

Claude

Open Customize → Connectors → Add custom connector, name it PromptScout, and paste the server URL. Team and Enterprise owners use Organization settings → Connectors. Choose Connect and approve access to your brand.

Claude Code

Run claude mcp add --transport http promptscout https://mcp.promptscout.app/mcp. Then run /mcp inside Claude Code, select promptscout, and approve access in your browser.

Cursor

Add the server to ~/.cursor/mcp.json, or to .cursor/mcp.json for a single project. Open Cursor Settings → MCP, find promptscout, choose Connect, and approve access in your browser.

Codex

Run codex mcp add promptscout --url https://mcp.promptscout.app/mcp, then codex mcp login promptscout. Approve access in your browser and return to Codex.

VS Code

Run MCP: Add Server from the Command Palette, choose HTTP, and paste the server URL. VS Code discovers PromptScout OAuth and opens the approval page in your browser.

ChatGPT

Add PromptScout as a connector in Settings → Connectors, using the server URL. Approve access to your brand when ChatGPT opens the PromptScout consent screen. Connector availability depends on your ChatGPT plan.

Factory Droid

Add PromptScout as a remote MCP server with the server URL. Droid registers itself through OAuth Dynamic Client Registration and opens the approval page in your browser.

Another client

Any client that supports remote MCP over Streamable HTTP with OAuth works. Add the server URL, let the client discover PromptScout OAuth, then approve your brand. Do not paste a manual token, and do not add PromptScout permissions to the OAuth scope field.

What a connected client can do

Every approved connection can read PromptScout context for its granted brand, including brand availability, setup state, prompts and prompt groups, AI provider configuration, and current Tasks with their evidence or execution package.

The OAuth approval can also request write permissions. When you explicitly approve them, a client can:

Manage prompts, prompt groups, and enabled prompt state.
Update enabled AI providers within your plan and billing limits.
Generate eligible Tasks and record a completion receipt.

Write access is separate from ordinary read context. PromptScout does not add it silently; adding a new write permission requires reconnecting the client and approving it in OAuth. MCP actions do not run monitors, crawls, publishing, outreach, or pull requests.

Manage or revoke access

Use Integrations to review each OAuth client separately. You can remove a granted write permission for a connection, or revoke that connection entirely. Revoking one client removes its access; other connected MCP clients remain connected. A revoked client must be authorized again before it can reconnect.

OAuth discovery reference

Most teams can let their MCP client complete discovery automatically. This reference is for client configuration and troubleshooting; it is not a second public documentation route.

MCP resource: https://mcp.promptscout.app/mcp
Protected-resource metadata: https://mcp.promptscout.app/.well-known/oauth-protected-resource/mcp
Compatibility metadata URL: https://mcp.promptscout.app/.well-known/oauth-protected-resource
Authorization server: https://sbrmhaklobcvrywmsksd.supabase.co/auth/v1

An unauthenticated request to the MCP resource returns an OAuth bearer challenge that points to the protected-resource metadata. That metadata identifies the MCP resource, the authorization server, and bearer-header authentication. The authorization server publishes its own OAuth metadata; a compatible client follows that metadata to start OAuth.

PromptScout brand permissions are managed in the approval flow and are distinct from OAuth identity scopes. Do not assume custom PromptScout permissions can be supplied as arbitrary OAuth scope values. Keep the resource bound to https://mcp.promptscout.app/mcp and let the client follow the discovery metadata.

The MCP endpoint accepts POST only. It keeps no session and offers no event stream, so a GET or DELETE request returns 405. PromptScout negotiates MCP protocol version 2025-11-25 and 2025-06-18.

Troubleshooting

The client reports an authentication failure right after you approve access

Check that the client points at https://mcp.promptscout.app/mcp and uses the remote or HTTP transport, not a local command. Then remove the server from the client and add it again, so the client runs a fresh OAuth flow. Integrations shows whether PromptScout recorded the authorization.

Keep the approved Brand accurate so the connection stays tied to the right business context.
Manage the prompts a client can work with in Prompts.
Use Weekly workflow to review Task evidence and completion receipts.

Connect PromptScout MCP