Skip to main content

Connecting to Claude

Use MCP Proxy to bridge Claude Desktop to your running HyperStudio application.

Prerequisites​

Before connecting
  • Your application is generated and running
  • Claude Desktop is installed
  • You have the application's MCP endpoint URL

Setup Process​

1

Locate Claude Configuration

Find the Claude Desktop configuration file:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json
2

Configure MCP Server

Add your application to the mcpServers configuration:

{
  "mcpServers": {
    "your-app-name": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-proxy",
        "http://localhost:3000/mcp"
      ]
    }
  }
}

Replace:

  • your-app-name with your agent name
  • http://localhost:3000/mcp with your application's MCP endpoint
3

Restart Claude Desktop

Close and reopen Claude Desktop to load the new configuration.

4

Verify Connection

In Claude Desktop, you should see your application listed as an available MCP server. Try asking Claude to use one of your tools.

Example Configuration​

{
  "mcpServers": {
    "finance-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-proxy",
        "http://localhost:3000/mcp"
      ]
    },
    "inventory-manager": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-proxy",
        "http://localhost:4000/mcp"
      ]
    }
  }
}

Troubleshooting​

IssueSolution
Server not appearingRestart Claude Desktop after config changes
Connection refusedVerify application is running on correct port
Tools not workingCheck tool permissions in ACL configuration

Next Steps​