Quickstart

Connect the pctx gateway, finish OAuth sign-in, and verify that your agent can reach the workspace.

Before you start

You need:

A Port of Context account
An MCP-compatible agent
Access to the services your workspace has enabled

The fastest path is to paste Set up pctx.ai/onboard.md into an agent with shell access. It can connect the gateway and inspect your existing MCP configuration.

Connect your agent

The gateway is a remote HTTP MCP server at https://mcp.pctx.ai/mcp.

Codex
Claude Code
Cursor
Other clients

Terminal

codex mcp add pctx --url https://mcp.pctx.ai/mcp
codex mcp login pctx

Start a new Codex session if the tools do not appear after sign-in.

Terminal

claude mcp add --transport http --scope user pctx https://mcp.pctx.ai/mcp

Restart Claude Code, open /mcp, select pctx, and authenticate.

Add this entry to your user-level MCP configuration:

~/.cursor/mcp.json

{
  "mcpServers": {
    "pctx": {
      "url": "https://mcp.pctx.ai/mcp"
    }
  }
}

Reload Cursor and complete the OAuth prompt.

Create a remote HTTP MCP connection with these values:

Field	Value
Name	`pctx`
URL	`https://mcp.pctx.ai/mcp`
Authentication	OAuth with dynamic client registration

Verify the connection

Ask the agent to inspect the gateway before giving it real work.

Verify Port of Context

A working connection lists Port of Context tools and returns information from your workspace. If you see an authentication error, reconnect from your client and finish signing in in the browser.

Scan existing MCP servers

The platform CLI can find MCP servers already configured across supported local agents. The scan is read-only.

Download the installer

Download the script to a temporary file. Do not pipe it directly into a shell.

Terminal

curl -fsSL https://pctx.ai/install.sh -o /tmp/pctx-install.sh
less /tmp/pctx-install.sh
sh /tmp/pctx-install.sh

Terminal

~/.local/bin/pctx login --url https://mcp.pctx.ai

Run the scan

Terminal

~/.local/bin/pctx mcp scan

The result lists services, the agents or repository files that configure them, and repeated configurations. Localhost servers are excluded from this scan.

pctx mcp configure can enable workspace connectors and edit local agent configuration. Review its plan before applying it.

Next: MCP gateway

Learn what the gateway exposes and how an agent chooses the right source.

Getting started

Core concepts

Skills

Administration

Reference

Before you start

Connect your agent

Verify the connection

Scan existing MCP servers

Next: MCP gateway

​Before you start

​Connect your agent

​Verify the connection

​Scan existing MCP servers

Next: MCP gateway

Before you start

Connect your agent

Verify the connection

Scan existing MCP servers