# Connect Tanjiren MCP to VS Code, Cursor, Claude, and ChatGPT

Use this page when you want to connect a real MCP client to the hosted Tanjiren MCP server.

## Canonical server details

- MCP endpoint: `https://mcp.tanjiren.app/mcp`
- Registry descriptor: `https://tanjiren.app/server.json`
- OAuth authorization server: `https://mcp.tanjiren.app/.well-known/oauth-authorization-server`
- OAuth protected resource: `https://mcp.tanjiren.app/.well-known/oauth-protected-resource`

Tanjiren uses:

- Streamable HTTP
- OAuth 2.1
- PKCE (`S256`)
- Dynamic Client Registration

## VS Code

VS Code supports MCP servers through the Extensions view, the `MCP: Add Server` command, `mcp.json`, and `vscode:mcp/install` links.

### Fast path

1. Open Command Palette.
2. Run `MCP: Add Server`.
3. Choose workspace or user configuration.
4. Add an HTTP server with this URL:

```text
https://mcp.tanjiren.app/mcp
```

5. When prompted, complete OAuth in your browser.

### Example `.vscode/mcp.json`

```json
{
  "servers": {
    "tanjiren": {
      "type": "http",
      "url": "https://mcp.tanjiren.app/mcp"
    }
  }
}
```

### Example install link

VS Code supports install links of the form `vscode:mcp/install?...`. If you want to distribute Tanjiren internally, use a JSON payload equivalent to:

```json
{
  "name": "tanjiren",
  "type": "http",
  "url": "https://mcp.tanjiren.app/mcp"
}
```

## Cursor

Cursor supports remote MCP servers via HTTP and OAuth. You can add Tanjiren through the UI or through `.cursor/mcp.json`.

### Fast path

1. Open Cursor settings.
2. Go to MCP.
3. Add a remote HTTP server.
4. Use this URL:

```text
https://mcp.tanjiren.app/mcp
```

5. Complete OAuth in your browser.

### Example `.cursor/mcp.json`

Project-specific:

```json
{
  "mcpServers": {
    "tanjiren": {
      "type": "http",
      "url": "https://mcp.tanjiren.app/mcp"
    }
  }
}
```

Global:

```text
~/.cursor/mcp.json
```

### Cursor CLI

Cursor CLI uses the same `mcp.json` configuration as the editor. Once Tanjiren is configured in Cursor, the same server is available to `cursor-agent`.

## Claude Code

Claude Code supports remote HTTP MCP servers and OAuth.

### Add Tanjiren

```bash
claude mcp add --transport http tanjiren https://mcp.tanjiren.app/mcp
```

Then open the MCP menu:

```text
/mcp
```

Claude Code will open the browser for OAuth. If the browser callback does not return automatically, Claude Code supports pasting the callback URL manually.

### Fixed callback port

If you want Claude Code to use a fixed localhost redirect URI:

```bash
claude mcp add --transport http \
  --callback-port 33419 \
  tanjiren https://mcp.tanjiren.app/mcp
```

### Example `.mcp.json`

```json
{
  "mcpServers": {
    "tanjiren": {
      "type": "http",
      "url": "https://mcp.tanjiren.app/mcp"
    }
  }
}
```

## ChatGPT

ChatGPT Developer mode supports remote MCP servers over Streamable HTTP and OAuth.

### Add Tanjiren in ChatGPT

1. Enable Developer mode in ChatGPT settings.
2. Open Apps settings.
3. Choose `Create app`.
4. Use the remote MCP server URL:

```text
https://mcp.tanjiren.app/mcp
```

5. Complete OAuth when prompted.

ChatGPT uses Dynamic Client Registration when static OAuth credentials are not provided.

## What to expect after auth

Once connected, a client should be able to:

- read `whoami`
- list workstations and workers
- inspect tasks and investigations
- create bounded tasks with `create_task`

## Troubleshooting

### `No pending authorization`

This was previously caused by a browser-state handoff issue in the consent flow. The current flow uses a signed authorization request token instead of a transient pending cookie.

### Browser opens but callback fails

Check:

- the client supports OAuth for remote MCP servers
- the redirect URI is accepted by the client
- the client is using Streamable HTTP rather than a deprecated SSE-only path

### Server not visible in client discovery

Use:

- `https://tanjiren.app/server.json`
- the official MCP Registry entry for `app.tanjiren/tanjiren-mcp`

## Related docs

- [Tanjiren MCP Server](mcp-server.md)
- [Tanjiren MCP Authentication](mcp-auth.md)
- [Tanjiren MCP Overview](mcp-overview.md)