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.