Using the MCP server

Qt Creator supports the model context protocol (MCP) to let AI assistants control it for debugging, building, and managing projects.

To use an MCP client, install one and activate the Qt Creator MCP server extension to start the MCP server.

View MCP server status

Qt Creator starts the MCP server when you activate the Qt Creator MCP server extension. The server runs at 127.0.0.1 and accepts connections on port 8249. You can choose a different IP address and port via the Settings.

To view the MCP server status, go to Settings > AI > MCP Server.

If the server does not start, see whether General Messages shows a warning about the port being in use.

Make sure that no other process is bound to the port. For example, on Linux, enter lsof -i :8249 in Terminal or try a different port.

Set up a simple MCP client

You can use any MCP client that support MCP Protocol Version 2025-11-18. This section describes how to use https://github.com/modelcontextprotocol/inspector to install a simple MCP client and how to configure it.

To install and configure a simple MCP client:

1. Go to Terminal, and enter:

    npx @modelcontextprotocol/inspector
   

2. Open the URL indicated in the terminal output
3. Change the settings to:
4. Transport Type: Streamable HTTP
5. URL: http://127.0.0.1:8249
6. Connection Type: Via Proxy
7. Click Connect