Remote MCP · Streamable HTTP · OAuth

Connect your agents to the same project context.

Read and update your private pm projects from coding agents and IDEs. Changes stay in sync with ChatGPT and pm-web.

Choose your client

pm-mcp · connection record

Add the remote server

Endpoint

https://pm-mcp.unbrained.dev/mcp

OAuth client ID

pm-gpt-openai

Use the hosted endpoint for synchronized projects. The local pm CLI MCP server serves local data.

pm-mcp · account access

Sign in, then choose a workspace

Your client discovers OAuth automatically. Complete Authorization Code + PKCE S256 in the browser. No client secret or GitHub account required.

Ask your agent to list pm workspaces before reading or changing items. Owner, direct-share, and group-share permissions apply.

Read the tool documentation

Client configurations

Copy the configuration for your client, then follow its sign-in prompt. Keep passwords and tokens out of configuration files.

Codex CLI / desktop / IDE

~/.codex/config.toml

[mcp_servers.pm_gpt]
url = "https://pm-mcp.unbrained.dev/mcp"
auth = "oauth"
oauth_resource = "https://pm-mcp.unbrained.dev"
scopes = ["openid", "profile", "pm.identity", "pm.workspace.read", "pm.workspace.write", "pm.items.read", "pm.items.write"]

[mcp_servers.pm_gpt.oauth]
client_id = "pm-gpt-openai"

Run codex mcp login pm_gpt after saving, then start a new session.

Claude Code

Run in a terminal

claude mcp add --transport http --scope user pm-gpt https://pm-mcp.unbrained.dev/mcp
# Then open Claude Code and run /mcp to sign in.

Open /mcp in Claude Code and select pm-gpt to authenticate.

VS Code + GitHub Copilot

.vscode/mcp.json or user MCP configuration

{
  "servers": {
    "pm-gpt": {
      "type": "http",
      "url": "https://pm-mcp.unbrained.dev/mcp",
      "oauth": {
        "clientId": "pm-gpt-openai"
      }
    }
  }
}

VS Code opens the browser for OAuth.

Cursor

.cursor/mcp.json or ~/.cursor/mcp.json

{
  "mcpServers": {
    "pm-gpt": {
      "url": "https://pm-mcp.unbrained.dev/mcp"
    }
  }
}

Complete the OAuth flow when prompted.

Windsurf / Cascade

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pm-gpt": {
      "serverUrl": "https://pm-mcp.unbrained.dev/mcp"
    }
  }
}

Refresh MCP servers in Settings, then complete OAuth.

Zed Agent

Zed settings.json

{
  "context_servers": {
    "pm-gpt": {
      "url": "https://pm-mcp.unbrained.dev/mcp"
    }
  }
}

Zed starts the MCP OAuth flow automatically.

Connection details

Clients must accept application/json and text/event-stream. OAuth discovery metadata describes the required access.

JetBrains AI Assistant documents remote Streamable HTTP, but its MCP guide does not document standard MCP OAuth. Use a listed client with native OAuth support.

Connect the ChatGPT app