Quickstart

Connect ctx| to your first repository and MCP client in minutes.

Prerequisites

  • A ctx| account (hosted) or a running ctx| instance (self-hosted)
  • A GitHub repository
  • Cursor, Claude Code, or any MCP-compatible agent

1. Connect a repository

From the ctx| dashboard, navigate to Repositories and add your repo URL. ctx| will clone and index your codebase — this typically takes 1–5 minutes depending on size.

2. Configure your MCP client

Add the following to your MCP client configuration (e.g. .cursor/mcp.json):

{
  "mcpServers": {
    "ctxpipe": {
      "url": "https://app.ctxpipe.ai/mcp?orgSlug=your-org-slug",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with the key from Settings → API Keys and your-org-slug with the slug shown in Settings → Organization.

The orgSlug query parameter is required. Requests without it are rejected. See ctx| MCP for full transport and auth documentation.

3. Start your agent

Your agent now has access to the knowledge graph. It will automatically query ctx| via the ctx_advisor tool during planning and execution to understand your architecture and follow your standards.

For best results, ensure your agent calls ctx_advisor early in any new task — before writing code — and again whenever a major decision changes.

Self-hosting the same flow

Point URLs at your own AUTH_BASE_URL and follow Self hosting for Compose or Railway.