ScrepyDocs

ChatGPT

Enable ChatGPT developer mode, add Screpy as a custom MCP plugin, complete OAuth, and verify project access.

Use this guide to connect Screpy MCP to ChatGPT on the web. Your ChatGPT workspace must allow developer mode and custom MCP plugins; managed workspaces may require an owner or admin to enable these features first.

ChatGPT Plugins settings with installed plugins and permission controls
Open ChatGPT plugin settings after developer mode is available in your workspace. UI current as of September 2026.

Use OAuth, not an API key

ChatGPT connects to Screpy through OAuth. Do not enter a Screpy REST API key.

Connect Screpy MCP to ChatGPT

Enable developer mode

In ChatGPT, open Settings, then Security and login. Open the developer mode section and enable it if your workspace allows custom MCP connections.

Open Plugins and add a custom connection

Return to Settings > Plugins. Choose the custom plugin or MCP option available to your workspace and give the connection the name Screpy. ChatGPT labels can differ between personal and managed workspaces.

Add the Screpy MCP server

Enter this server URL and select OAuth when ChatGPT asks how to authenticate:

https://mcp.screpy.com

Sign in to Screpy

Let ChatGPT scan the available tools. When the Screpy sign-in window opens, sign in and approve access to the correct account.

Test the connection in a new chat

Start a chat with Screpy enabled and ask:

Use Screpy to list my projects and summarize the latest completed crawl for each one.

If Screpy does not connect

Confirm that developer mode and custom MCP plugins are allowed in your workspace. Remove the incomplete connection, create it again with the URL above, and complete OAuth in the same browser session. See Troubleshooting if the plugin connects but projects or tools are missing.

On this page