Tutorials/MCP servers
MCP

Plug in an MCP server.

MCP servers expose tools — GitHub, browsers, databases, anything — that Centaurus can call from the chat. This tour walks through listing what you already have and adding a new server from a JSON config.

~4 min·Intermediate·11 steps
~/projects/centaurus
centaurus — type /help for commands
CWD: ~/projects/centaurus·Model: GPT-OSS 120BMode: Auto [Agent]
Ask anything ...
Step 01/11Start at the main chat screen

Where configs live

User-scope servers are saved in ~/.centaurus/mcp.json and project-scope servers in .centaurus/mcp.json. You can also drop a file at either path directly — Centaurus picks up changes on the next session.

Enabled vs disabled

Disabled servers stay in your config but don't spawn — handy for keeping rarely-used integrations around without paying their startup cost. Toggle with /mcp enable and /mcp disable.

Servers that need OAuth?

Use the mcp_auth tool after adding the server — it runs a PKCE flow and stores the token encrypted.

Browse all tutorials