> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Setup

> Connect AI clients to the Macro MCP server.

Macro's MCP endpoint is:

```text theme={null}
https://mcp-server.macro.com/mcp
```

The server is remote; no local process is required. Authentication happens through Macro's OAuth flow when the client connects.

## Claude Code

```bash theme={null}
claude mcp add --transport http macro https://mcp-server.macro.com/mcp
```

Start Claude Code, use the `macro` MCP server, and complete the browser sign-in flow when prompted.

## Codex CLI

```bash theme={null}
codex mcp add macro --url https://mcp-server.macro.com/mcp
```

Start Codex CLI, invoke the `macro` MCP server, and complete the OAuth login flow in the browser.

## IDE / JSON Configuration

For editors that accept JSON MCP server config, add this under `mcpServers`:

```json theme={null}
{
  "macro": {
    "type": "http",
    "url": "https://mcp-server.macro.com/mcp"
  }
}
```

Trigger a connection from the editor and finish the browser login flow.