Configuration
Troubleshooting
Quick Setup
See the Quickstart for basic setup instructions.Configuration Options
Credentials live in a profile-basedauth.ini shared with
contree-cli;
install the CLI and run contree auth once to populate it. The MCP
server then reads the active profile automatically.
| Option | Environment Variable | Default |
|---|---|---|
| - | CONTREE_HOME | $XDG_CONFIG_HOME/contree (typically ~/.config/contree) |
--profile | CONTREE_PROFILE | active profile from auth.ini |
--token | CONTREE_TOKEN | from profile |
--url | CONTREE_URL | from profile |
--project | CONTREE_PROJECT | from profile (IAM auth only) |
--mode | - | stdio |
--http-port | - | 9452 |
--log-level | - | warning |
--version / -V | - | print User-Agent and exit |
stored profile**.
Supported Clients
- Claude Code
- Claude Desktop
- OpenAI Codex CLI
- Any MCP-compatible client
See Also
- Configuration - Detailed config options
- Troubleshooting - Common issues