Agent Setup

Connect the development server to Codex or another MCP-compatible coding agent.

Field guide · 03

Start the installed server

Start Waypoint after installing it from a GitHub Release or npm. The local server listens on IPv4 loopback.

waypoint start

Add Waypoint to supported agents

Add MCP can detect supported coding agents and guide you through the configuration it will update. It configures the connection but does not install or start Waypoint.

npx add-mcp http://127.0.0.1:3846/mcp --name logbook-waypoint --global

Connect Codex

Add the local streamable HTTP endpoint to Codex configuration. The server remains on IPv4 loopback and does not require a LAN binding.

[mcp_servers.logbook-waypoint]
url = "http://127.0.0.1:3846/mcp"

Connect another MCP client

JSON-based clients can register the same provider-neutral endpoint. Pi, OpenCode, and other MCP-compatible agents may present the setting in different places, but Waypoint’s tools and lifecycle do not change.

{
  "mcpServers": {
    "logbook-waypoint": {
      "url": "http://127.0.0.1:3846/mcp"
    }
  }
}

Explore the MCP tool surface

Open the Signal Chart for a visual explanation of how work travels from Annotation → Queue → MCP → agent, including lifecycle transitions and all 19 Waypoint MCP tools.

Open the Waypoint Signal Chart