Skip to main content

Connect to Claude

Connect Claude and other AI tools to your running application. Hyper provides two ways to connect: a standard OAuth URL for web-based AI clients and a developer config for IDEs.

Go to your Project and click the MCP icon in the sidebar.

Method 1: Standard Connection (Web Clients)​

Use this method for web-based AI assistants like Claude.ai and ChatGPT.

1

Copy the OAuth URL

In the MCP Configuration screen, select the Standard tab. Click the Copy URL button to copy your unique OAuth connection URL.

2

Add to AI Client

Paste the URL into your AI client's settings:

  • Claude.ai — Go to Settings → Integrations → Add custom connector and paste the URL.
  • ChatGPT — Go to Settings → Connected apps → Add custom connector and paste the URL.

Method 2: Developer Connection (IDEs & CLI)​

Use this method for IDEs like Cursor and VS Code, or for Claude Desktop.

1

Generate Config

Select the Developer tab. Enter a name for your server (for example, shikamaru) and click Copy Config to copy the generated JSON snippet.

The generated snippet uses mcp-remote:

{
  "mcpServers": {
    "your-server-name": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-backend.madeonhyper.com/mcp"
      ]
    }
  }
}
2

Paste into IDE Settings

Paste the copied block into your tool's settings file:

  • Claude Desktop — Add to claude_desktop_config.json
  • Claude Code — Run claude mcp add <your-server-name> -- npx -y mcp-remote <your-mcp-url>, or add to .mcp.json in your project root
  • Cursor — Add to .cursor/mcp.json
  • VS Code — Add to .vscode/mcp.json or go to User Settings → MCP
  • Windsurf — Paste inside the mcpServers block and restart

Troubleshooting​

IssueSolution
Server not appearingRestart your IDE or refresh the web client after adding the connector
Connection refusedVerify your application is running and accessible at the provided URL
Tools not workingCheck tool permissions in your project's ACL setup

Next Steps​