Skip to content
Scroll Guides home
Scroll Guides home

MCP Client Instructions

Use this guide to connect to a Scroll agent shared with you over MCP.

Before you start

  • Keep your invite email open while following this guide. You will need to copy the Scroll MCP URL from that email.

  • If the agent is invite-only, sign in to Scroll with the same email address that received the invite when your MCP client prompts you to authenticate.

  • If a step asks you to "use the MCP URL", copy the full URL from your invite email.

  • When a client asks you to name the connection, use the agent's name from the invite email.

Claude

Add this Scroll agent as a remote connector in Claude:

  1. Open Claude and go to Customize → Connectors.

  2. Click Add custom connector.

  3. Name it <AGENT NAME>, or any name you prefer.

  4. Use the MCP URL from your invite email.

  5. Save the connector, then complete the Scroll sign-in prompt when Claude asks for authentication.

Claude docs: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

ChatGPT

Add this Scroll agent as a custom MCP app in ChatGPT on the web:

  1. Open ChatGPT on the web at chatgpt.com.

  2. Enable developer mode in Settings → Apps → Advanced settings.

  3. Go to Settings → Apps and click Create app.

  4. Choose a custom MCP app.

  5. Name it <AGENT NAME>, or any name you prefer.

  6. Use the MCP URL from your invite email.

  7. Choose OAuth for authentication.

  8. Save the app, then click Connect.

  9. Complete the Scroll sign-in flow when ChatGPT opens the OAuth prompt.

ChatGPT docs: https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta

Claude Code

Add this Scroll agent from the CLI:

  1. Run the command below in your terminal.

  2. Add --scope user to make it available across all projects.

  3. Run /mcp in Claude Code and complete the Scroll sign-in flow with an invited user if the server needs authentication.

Claude Code CLI

claude mcp add --transport http "<AGENT NAME>" "<MCP URL FROM EMAIL>"

If longer queries time out in Claude Code, increase the MCP tool timeout in Claude Code settings before retrying.

Claude Code docs: https://docs.anthropic.com/en/docs/claude-code/mcp

Claude Desktop

Add this Scroll agent as a remote connector in Claude Desktop:

  1. Open Claude Desktop and go to Customize → Connectors.

  2. Click Add custom connector.

  3. Name it <AGENT NAME>, or any name you prefer.

  4. Use the MCP URL from your invite email.

  5. Save the connector, then complete the Scroll sign-in prompt when Claude asks for authentication.

Claude Desktop docs: https://support.claude.com/en/articles/11503834-building-custom-connectors-via-remote-mcp-servers

Cursor

Add this Scroll agent to your Cursor MCP config:

  1. Open .cursor/mcp.json in your project, or ~/.cursor/mcp.json for a global config.

  2. Add the entry below under mcpServers.

  3. Save and restart Cursor if needed.

Cursor config

{
  "mcpServers": {
    "<AGENT NAME>": {
      "url": "<MCP URL FROM EMAIL>"
    }
  }
}

Cursor docs: https://docs.cursor.com/context/model-context-protocol

Codex

Add this Scroll agent from the Codex CLI:

  1. Run the command below in a terminal.

  2. Restart Codex if the server does not appear.

Codex CLI

codex mcp add "<AGENT NAME>" --url "<MCP URL FROM EMAIL>"

Codex docs: https://developers.openai.com/codex/mcp

OpenClaw

Add this Scroll agent through the OpenClaw config wizard:

  1. Run openclaw onboard for a new install, or openclaw config for an existing one.

  2. When prompted for a remote MCP server URL, paste the MCP URL from your invite email.

  3. Run openclaw config validate to verify your config.

OpenClaw commands

openclaw onboard
openclaw config
openclaw config validate

OpenClaw docs: https://docs.openclaw.ai/gateway/configuration

Powered by Plain