HTTP Transport

This method lets AI apps connect to Macuse over your network. It's useful for web-based AI tools or when connecting from another device.

Most users should use stdio instead — it's simpler and works with most AI apps.

Server Address

When you open Macuse, it automatically starts a local server at:

http://127.0.0.1:35729/mcp

Custom Server Address

You can change the server address and port in Macuse → Server → Settings:

Server Address — Choose which network interface the server listens on. Use 127.0.0.1 (default) for local-only access, or select another interface to allow connections from other devices on your network.
Server Port — Change the port number (default: 35729). Useful if the default port conflicts with another application.

Changes take effect immediately — the server restarts automatically with the new address.

Authentication

Macuse uses OAuth for secure authentication. When you configure the server URL in your AI app, an authorization window will automatically appear to complete the connection.

Configuration

Add this to your AI app's configuration:

{
  "mcpServers": {
    "macuse": {
      "url": "http://127.0.0.1:35729/mcp"
    }
  }
}

After saving the configuration, your AI app will prompt you to authorize the connection.

API Key Authentication

Some AI apps don't support OAuth (e.g., Cursor, Windsurf). For these apps, Macuse provides API Key authentication. See the API Keys page for setup instructions.