# Connect your agent

Copy one line into the agent you already use. It does the rest. New accounts start with $1 of free credit.

```
Fetch and execute the instructions to set me up for Ownhand from https://ownhand.dev/agent-setup/prompt.md. If your web tool can't open it, download it with curl or Invoke-WebRequest.
```

Paste it into Claude Code, Codex, Cursor, Gemini CLI or any MCP agent. It connects Ownhand itself and signs you in through your browser. No key to copy.

## Or do it yourself

Add one URL to your MCP client. A browser opens, you sign in or sign up, pick your Hand, and you're done. No API key to copy.

```
https://ownhand.dev/mcp
```

Pick your client

### Claude Code

```
claude mcp add --transport http --scope user ownhand https://ownhand.dev/mcp
```

Then run `/mcp` in Claude Code, pick `ownhand` and sign in.

### Claude

1. In Claude, open [Settings, Connectors](https://claude.ai/settings/connectors).
2. Choose **Add custom connector** and paste `https://ownhand.dev/mcp`.
3. Click **Connect** and sign in.

Works in claude.ai, Claude Desktop and the mobile apps once added.

### ChatGPT

1. In ChatGPT settings, turn on **Developer mode**.
2. Add a connector (an app) and paste `https://ownhand.dev/mcp` as its URL.
3. Sign in when ChatGPT asks.

### Cursor

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=ownhand&config=eyJ1cmwiOiJodHRwczovL293bmhhbmQuZGV2L21jcCJ9)

Then click **Connect** next to ownhand in Cursor's MCP settings. Or add it to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "ownhand": {
      "url": "https://ownhand.dev/mcp"
    }
  }
}
```

### VS Code

[Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22ownhand%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fownhand.dev%2Fmcp%22%7D)

For GitHub Copilot agent mode. [Insiders](vscode-insiders:mcp/install?%7B%22name%22%3A%22ownhand%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fownhand.dev%2Fmcp%22%7D). Or from a terminal:

```
code --add-mcp '{"name":"ownhand","type":"http","url":"https://ownhand.dev/mcp"}'
```

### Codex

```
codex mcp add ownhand --url https://ownhand.dev/mcp
```

Codex opens a browser to sign in. If it doesn't, run:

```
codex mcp login ownhand
```

Codex loads MCP servers when it starts. If it was already running, restart it so the tools show up:

```
codex resume --last
```

### Gemini CLI

```
gemini mcp add --transport http --scope user ownhand https://ownhand.dev/mcp
```

Then run `/mcp auth ownhand` in Gemini CLI to sign in.

### Windsurf

Add this to `mcp_config.json` (Cascade, MCP servers, View raw config), then sign in when asked.

```json
{
  "mcpServers": {
    "ownhand": {
      "serverUrl": "https://ownhand.dev/mcp"
    }
  }
}
```

### Zed

Add this to your Zed settings. Zed asks you to sign in the first time it connects.

```json
{
  "context_servers": {
    "ownhand": {
      "url": "https://ownhand.dev/mcp"
    }
  }
}
```

### Goose

[Add to Goose](goose://extension?url=https%3A%2F%2Fownhand.dev%2Fmcp&type=streamable_http&id=ownhand&name=Ownhand&description=Write+in+your+own+voice)

Or run `goose configure`, add a remote extension (streamable HTTP) and paste `https://ownhand.dev/mcp`.

### Cline

In Cline's MCP servers, add a remote server, or put this in `cline_mcp_settings.json`. Then click to sign in.

```json
{
  "mcpServers": {
    "ownhand": {
      "type": "streamableHttp",
      "url": "https://ownhand.dev/mcp"
    }
  }
}
```

## After you connect

Ask your agent to set up your Hand. It will ask for 5 to 10 things you wrote and learn your voice from them. Clients that show MCP prompts also list `set_up_my_hand`.

Then ask it to write anything you'll send as yourself. It shows you the draft first and learns from what you actually send. The [agent blurb](https://ownhand.dev/docs#blurb) makes this automatic.

## Use an API key instead

For clients without sign-in, scripts, and CI. Create a key in the [dashboard](https://ownhand.dev/dashboard#keys) and send it as a header. `X-Ownhand-Hand` is optional and sets the default Hand.

```
claude mcp add --scope user --transport http ownhand https://ownhand.dev/mcp --header "Authorization: Bearer $OWNHAND_API_KEY"
```

Any client that takes a URL and headers:

```json
{
  "mcpServers": {
    "ownhand": {
      "url": "https://ownhand.dev/mcp",
      "headers": {
        "Authorization": "Bearer <OWNHAND_API_KEY>",
        "X-Ownhand-Hand": "prof_..."
      }
    }
  }
}
```

The [dashboard Connect page](https://ownhand.dev/dashboard/connect) fills in your key and Hand for each client. The HTTP API is at `https://ownhand.dev/v1`.

---

Page: https://ownhand.dev/connect. Index for agents: https://ownhand.dev/llms.txt