# Gemini CLI

Step-by-step guide to connect Screpy MCP to Gemini CLI with OAuth.

Use this guide to add Screpy as a remote HTTP MCP server in Gemini CLI. The connection is stored at user scope and authorizes through your browser.

## Connect Screpy MCP to Gemini CLI

### Open a local terminal

Use a terminal on a computer that can open a browser. The first Screpy OAuth connection cannot finish in a headless SSH session or container.

### Add the Screpy MCP server

Run:

```
gemini mcp add --scope user --transport http screpy https://mcp.screpy.com
```

This adds Screpy to your user-level Gemini CLI configuration. It does not need a Screpy REST API key.

### Authorize Screpy

Start Gemini CLI. When it asks to authenticate Screpy, open the browser link, sign in to the correct Screpy account, and approve access.

### Verify project access

Ask Gemini:

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

## If the server is connected but tools are unavailable

Run `/mcp reload` in Gemini CLI, then try the project-list prompt again. If authorization cannot open, finish the first connection from a local terminal and review Troubleshooting.