Docs

Connect MCP clients

RedMate uses the local HTTP transport. After the app is running, open the MCP Server screen, confirm the service is Running, then add the config for the Agent or MCP client you use.

Before you connect

Keep the RedMate desktop app running and confirm that MCP Server is Running. The default endpoint is http://127.0.0.1:7654/mcp. If the port changes, use the endpoint shown in the app.

Claude Code

Add the RedMate MCP server from your project terminal. Use project scope if you want to share the configuration with your team; keep the default local scope if it is only for you.

After adding it, run /mcp in Claude Code and confirm redmate is enabled.
Before the first write action, ask Claude Code to list xhs_* tools so you know it is connected to the expected server.

Claude Code command

claude mcp add --transport http redmate http://127.0.0.1:7654/mcp

Cursor

Open Cursor Settings -> MCP -> Add new global MCP server, or create .cursor/mcp.json in your project root for project-level sharing.

Save the config and restart Cursor, or use Cursor's MCP reload flow.
Ask Cursor to call account_list to confirm the connection.

.cursor/mcp.json

{
  "mcpServers": {
    "redmate": {
      "url": "http://127.0.0.1:7654/mcp"
    }
  }
}

VS Code / GitHub Copilot

Create .vscode/mcp.json in your workspace, then run MCP: List Servers or MCP: Open User Configuration from the Command Palette.

Workspace config is useful when the server should travel with the project. User config is useful across projects.
After starting the server, Copilot should be able to see RedMate's xhs_* tools.

.vscode/mcp.json

{
  "servers": {
    "redmate": {
      "type": "http",
      "url": "http://127.0.0.1:7654/mcp"
    }
  }
}

Claude Desktop

If your Claude Desktop supports remote MCP connectors, open Settings -> Connectors -> Add custom connector and enter the RedMate endpoint. Older local stdio config is not the same as this HTTP endpoint.

Use http://127.0.0.1:7654/mcp as the connector URL.
Keep the RedMate app running. The connector will fail when the app is closed.

Connector URL

http://127.0.0.1:7654/mcp

Codex

Add RedMate to your Codex config. RedMate is a local service, so no OAuth login is required. Once the app is running, Codex can request this endpoint directly.

For user-level config, edit ~/.codex/config.toml.
For project-level sharing, add the same block to .codex/config.toml in the project root.

Codex config.toml

[mcp_servers.redmate]
url = "http://127.0.0.1:7654/mcp"

Other MCP clients

If your tool is not listed but supports HTTP MCP servers, prefer the url / type:http shape. Only use a local bridge when the client cannot speak HTTP MCP directly.

Use HTTP transport and the /mcp endpoint shown in the RedMate app.
Save the config, restart the client, and confirm tools/list returns xhs_* tools.
Enable human confirmation before write actions, especially publish, delete, and cancel operations.

Generic MCP JSON

{
  "mcpServers": {
    "redmate": {
      "type": "http",
      "url": "http://127.0.0.1:7654/mcp"
    }
  }
}