Setup
Step-by-step setup for connecting a compatible AI client to Screpy MCP with OAuth.
Use this guide when you are new to MCP. The steps are the same for every supported AI client; your client-specific guide shows where to paste the server URL.
Before you begin
You need:
- A Screpy account that can access the projects you want to analyze.
- An AI client with remote HTTP MCP and OAuth support.
- A browser on the device where you complete the first sign-in.
Do not use a REST API key
Screpy MCP authorizes through OAuth. Do not paste a Screpy REST API key into your AI client or create a token manually.
Connect Screpy MCP
Open your AI client's MCP or connector settings
Look for MCP servers, Connectors, Apps, or Tools. If you do not see one of these options, check whether your client and workspace support remote MCP servers.
Add the Screpy MCP server URL
Create a new remote HTTP server and enter:
https://mcp.screpy.comName it Screpy when your client asks for a name. Do not add an authorization header or API key.
Complete the Screpy sign-in page
Your client opens a browser window or shows an Authenticate button. Sign in to the Screpy account that has the right project access, then approve the requested connection.
Confirm that Screpy is available
Return to your AI client and ask:
List my Screpy projects.
If the expected projects appear, the server, OAuth connection, and project permissions are all working.
If you need a client-specific guide
ChatGPT
Connect Screpy as a custom app.
Claude
Add Screpy as a remote connector.
Codex
Configure the Screpy MCP server and sign in.
Cursor
Add and authorize Screpy in Cursor.
VS Code & Copilot
Add Screpy through mcp.json.
Gemini CLI
Add and authorize Screpy from your terminal.
Common setup questions
Why does my AI client ask me to sign in again?
The OAuth approval may have been cancelled, completed with another Screpy account, or expired in the client. Reconnect from the client's MCP settings and finish the browser flow in the same local session.
Can I connect from a headless server?
The first OAuth connection needs a browser and callback path. Complete the connection from a local computer first when an SSH session, container, or server cannot open a browser.
My projects are missing after I connect
Screpy shows only projects you own or that are shared with your account. Check that you signed in to the intended Screpy account, then see Troubleshooting.