Quickstart

Get an agent connected to Conductor in under 5 minutes. Conductor is a knowledge base with a minimal MCP transport — the compiler has been archived.

Prerequisites

You need two things installed and configured:

1. ntn CLI — Notion access tool. Install: pip install ntn or equivalent
2. Bitwarden Secrets Manager — bws CLI. Install from Bitwarden's download page
3. Conductor MCP auth token — retrieved from Bitwarden via secret-gate

Verify each:

bash ntn --version bws --version

Step 1: Get your auth token

Conductor uses a token stored in Bitwarden Secrets Manager. Retrieve it:

Windows (PowerShell): powershell & "_repos/tools/secret-gate/secret-gate.ps1" $env:CONDUCTOR_MCP_AUTH_TOKEN = bws secret get conductor-mcp-auth-token | ConvertFrom-Json | % Text

Linux/macOS: bash source _repos/tools/secret-gate/secret-gate.sh export CONDUCTOR_MCP_AUTH_TOKEN=$(bws secret get conductor-mcp-auth-token | jq -r '.text')

The token is now in your environment for the current session.

Step 2: Connect your agent

Configure your agent client to connect to the Conductor MCP server:

Cursor (.cursor/mcp.json): json { "mcpServers": { "conductor": { "url": "https://conductor-konstant.hectorsanchez.eu/mcp", "headers": { "Authorization": "Bearer ${CONDUCTOR_MCP_AUTH_TOKEN}" } } } }

opencode (opencode.json): json { "mcpServers": { "conductor": { "url": "https://conductor-konstant.hectorsanchez.eu/mcp", "headers": { "Authorization": "Bearer ${CONDUCTOR_MCP_AUTH_TOKEN}" } } } }

Step 3: Verify connectivity

Test that your agent can reach Conductor:

list_business_lines

Expected: returns 6 lines: portfolio, product, software, editorial, services, operate.

Then discover your workflow:

list_stages --business_line software

Expected: returns the 7 Software stages: frame, design, implement, verify, promote, deploy, document.

Where to go next

You want to...	Read
Understand what Conductor is	about/product.md
Understand the org model	about/organization.md
See the stage contracts	reference/contracts/stage-contracts.md
Discover prior work before building	guides/estate-discovery.md
Set up Notion access	guides/notion-setup.md

Troubleshooting

Problem	Check
list_business_lines fails	Is CONDUCTOR_MCP_AUTH_TOKEN set? Is the token valid?
Notion reads fail	Is ntn authenticated? Is CONDUCTOR_NOTION_READ_TOKEN set?