Install

# Add Agentline to your agent

Agentline is a remote MCP server using Streamable HTTP and OAuth 2.1. Pick your client: each uses its own install mechanism, and you sign in to Agentline the first time a tool needs it.

`https://agentline.nz/mcp`

## Clients

### Claude (claude.ai and Claude Desktop)One click

OAuth (sign in to Agentline)

[Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Agentline&connectorUrl=https%3A%2F%2Fagentline.nz%2Fmcp)[Steps](#claude)

### ChatGPTGuided

OAuth (sign in to Agentline)

[Steps](#chatgpt)

### Claude CodeOne line

OAuth, or add --header "Authorization: Bearer al_live_…" for an API key

[Steps](#claude-code)

### CursorOne click

OAuth

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=agentline&config=eyJ1cmwiOiJodHRwczovL2FnZW50bGluZS5uei9tY3AifQ%3D%3D)[Steps](#cursor)

### VS Code (GitHub Copilot)One click

OAuth

[Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22agentline%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fagentline.nz%2Fmcp%22%7D)[Steps](#vscode)

### WindsurfConfig

OAuth

[Steps](#windsurf)

### ClineConfig

OAuth

[Steps](#cline)

### GooseOne click

OAuth

[Add to Goose](goose://extension?type=streamable_http&url=https%3A%2F%2Fagentline.nz%2Fmcp&id=agentline&name=Agentline&description=NZ%20phone%20number%2C%20SMS%20and%20email%20inbox%20for%20your%20agent)[Steps](#goose)

### ZedConfig

OAuth (leave out the Authorization header so Zed runs OAuth)

[Steps](#zed)

### Codex CLIOne line

OAuth, or an API key via bearer_token_env_var

[Steps](#codex)

### Gemini CLIOne line

OAuth (auto-discovered), or --header "Authorization: Bearer al_live_…"

[Steps](#gemini)

### n8nGuided

API key (Bearer) or MCP OAuth2

[Steps](#n8n)

### Any MCP client (JSON)Config

OAuth 2.1 or API key

[Steps](#generic)

## Claude (claude.ai and Claude Desktop)

[Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Agentline&connectorUrl=https%3A%2F%2Fagentline.nz%2Fmcp)

- Click Add to Claude. Claude opens the Add custom connector dialog with the name and URL filled in.
- Check the URL is https://agentline.nz/mcp and confirm.
- Click Connect, sign in to Agentline and approve access.
- Team and Enterprise: an Owner adds the connector under Organisation settings first.

Auth: OAuth (sign in to Agentline). Mechanism checked against [claude.com](https://claude.com/docs/connectors/building/directory-vs-custom).

## ChatGPT

- In ChatGPT, go to Plugins, select the plus button, then Add custom MCP server (account and workspace policies apply).
- Name it Agentline. Under Connection, enter https://agentline.nz/mcp as the MCP server URL and choose OAuth for authentication.
- Review the risk warning, select I understand and want to continue, then Create as a plugin.
- Sign in to Agentline (or create a free account) and approve access. You're returned to ChatGPT; type @ and pick Agentline in a chat.

Auth: OAuth (sign in to Agentline). Mechanism checked against [developers.openai.com](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt).

## Claude Code

```
claude mcp add --transport http agentline https://agentline.nz/mcp
```

- Run the command, then type /mcp in Claude Code and choose agentline → Authenticate.

Auth: OAuth, or add --header "Authorization: Bearer al_live_…" for an API key. Mechanism checked against [docs.claude.com](https://docs.claude.com/en/docs/claude-code/mcp).

## Cursor

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=agentline&config=eyJ1cmwiOiJodHRwczovL2FnZW50bGluZS5uei9tY3AifQ%3D%3D)

Config: `~/.cursor/mcp.json`

```
{
  "mcpServers": {
    "agentline": {
      "url": "https://agentline.nz/mcp"
    }
  }
}
```

- Click Add to Cursor and confirm the install prompt.
- Cursor opens the Agentline sign-in the first time a tool needs it.

Auth: OAuth. Mechanism checked against [cursor.com](https://cursor.com/docs/context/mcp/install-links).

## VS Code (GitHub Copilot)

[Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22agentline%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fagentline.nz%2Fmcp%22%7D)[Install via vscode.dev](https://vscode.dev/redirect/mcp/install?name=agentline&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fagentline.nz%2Fmcp%22%7D)

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

Config: `.vscode/mcp.json (or MCP: Open User Configuration)`

```
{
  "servers": {
    "agentline": {
      "type": "http",
      "url": "https://agentline.nz/mcp"
    }
  }
}
```

- Click Add to VS Code. If your browser doesn't open VS Code, use Install via vscode.dev or run the command.
- Approve the install, then start the server from the MCP view and sign in when prompted.

Auth: OAuth. Mechanism checked against [code.visualstudio.com](https://code.visualstudio.com/api/extension-guides/ai/mcp).

## Windsurf

Config: `Cascade → MCP → Open MCP config file (mcp_config.json)`

```
{
  "mcpServers": {
    "agentline": {
      "serverUrl": "https://agentline.nz/mcp"
    }
  }
}
```

- Paste the config into mcp_config.json, save, and press Refresh in the MCP panel.
- Complete the browser sign-in on first use.

Auth: OAuth. Mechanism checked against [docs.windsurf.com](https://docs.windsurf.com/windsurf/cascade/mcp).

## Cline

Config: `Cline → MCP Servers → Configure → Configure MCP Servers (cline_mcp_settings.json)`

```
{
  "mcpServers": {
    "agentline": {
      "type": "streamableHttp",
      "url": "https://agentline.nz/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

- Or use the Remote Servers tab: name agentline, URL https://agentline.nz/mcp, transport Streamable HTTP, then Add Server.
- Keep "type": "streamableHttp" — without it Cline falls back to legacy SSE.

Auth: OAuth. Mechanism checked against [docs.cline.bot](https://docs.cline.bot/mcp/mcp-overview).

## Goose

[Add to Goose](goose://extension?type=streamable_http&url=https%3A%2F%2Fagentline.nz%2Fmcp&id=agentline&name=Agentline&description=NZ%20phone%20number%2C%20SMS%20and%20email%20inbox%20for%20your%20agent)

Config: `~/.config/goose/config.yaml`

```
extensions:
  agentline:
    name: Agentline
    type: streamable_http
    uri: https://agentline.nz/mcp
    enabled: true
    timeout: 300
```

- Click Add to Goose (Goose Desktop) and confirm, or add the YAML to your config.

Auth: OAuth. Mechanism checked against [github.com](https://github.com/block/goose/blob/main/ui/desktop/src/components/settings/extensions/deeplink.ts).

## Zed

Config: `settings.json (zed: open settings file), or Settings → AI → MCP Servers → Add Remote Server`

```
{
  "context_servers": {
    "agentline": {
      "url": "https://agentline.nz/mcp"
    }
  }
}
```

- Paste the config (note: context_servers, not mcpServers).
- Click Authenticate next to agentline when Zed asks.

Auth: OAuth (leave out the Authorization header so Zed runs OAuth). Mechanism checked against [zed.dev](https://zed.dev/docs/ai/mcp).

## Codex CLI

```
codex mcp add agentline --url https://agentline.nz/mcp && codex mcp login agentline
```

Config: `~/.codex/config.toml`

```
[mcp_servers.agentline]
url = "https://agentline.nz/mcp"
```

- Run the command; codex mcp login opens the Agentline sign-in.
- For an API key instead: --bearer-token-env-var AGENTLINE_API_KEY.

Auth: OAuth, or an API key via bearer_token_env_var. Mechanism checked against [learn.chatgpt.com](https://learn.chatgpt.com/docs/extend/mcp).

## Gemini CLI

```
gemini mcp add --transport http agentline https://agentline.nz/mcp
```

Config: `~/.gemini/settings.json`

```
{
  "mcpServers": {
    "agentline": {
      "httpUrl": "https://agentline.nz/mcp"
    }
  }
}
```

- Run the command, then /mcp auth agentline inside Gemini CLI to sign in.

Auth: OAuth (auto-discovered), or --header "Authorization: Bearer al_live_…". Mechanism checked against [github.com](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md).

## n8n

- Add an AI Agent node, then attach an MCP Client Tool node to its Tools input.
- Endpoint: https://agentline.nz/mcp. Server Transport: HTTP Streamable.
- Authentication: Bearer Auth with a credential holding your Agentline API key (al_live_…), or MCP OAuth2 with dynamic client registration on.
- Tools to Include: All, or pick the ones the workflow needs.

Auth: API key (Bearer) or MCP OAuth2. Mechanism checked against [docs.n8n.io](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp).

## Any MCP client (JSON)

```
{
  "mcpServers": {
    "agentline": {
      "type": "http",
      "url": "https://agentline.nz/mcp",
      "headers": {
        "Authorization": "Bearer ${AGENTLINE_API_KEY}"
      }
    }
  }
}
```

- Streamable HTTP at https://agentline.nz/mcp. OAuth 2.1 discovery starts from the 401's WWW-Authenticate header.
- Or skip OAuth with an API key from the dashboard: Authorization: Bearer al_live_….
- No account yet? Agents can call signup on the keyless server at https://agentline.nz/public/mcp with their human's email.

Auth: OAuth 2.1 or API key. Mechanism checked against [modelcontextprotocol.io](https://modelcontextprotocol.io/specification).