Skip to main content
Once your client is connected to Kombai, it can start a Kombai chat in a named workspace folder, follow a running chat and read its result, and read the designs on a canvas.

Open the server settings

Click the icon in the top bar to open the Settings page, then select the Kombai MCP Server tab. If the server is running, you will see a Active badge with the port it’s listening on, above the Clients section. If it reads The MCP bridge is not running, restart Kombai to bring it back.
The server runs when you are using the Kombai app. There’s no separate on/off switch for it. Turning a client on or off only changes that client’s configuration.

Supported clients

Kombai detects these clients and writes its entry into each one’s own user-level configuration file: Kombai shows a Detected badge for each client it finds on your machine, and a Not Installed badge for those it doesn’t. If your client isn’t detected, install it first, then restart Kombai to detect it. You can also connect a client manually if it’s not listed above. To do so, copy the Manual configuration snippet from below the Clients section into your client’s own MCP configuration. To use the skills there as well, place each skill’s SKILL.md at <skill-name>/SKILL.md in that client’s skills folder.

Connect a client

1

Turn the client on

Toggle a detected client on. Kombai adds itself to that client’s MCP configuration and installs the Kombai skills into the client’s skills folder.
2

Use a skill from the client

In the client, type the skill you want to use. For example, /design-with-kombai to hand that task to Kombai.
Toggling the client off removes both the configuration entry and the skills.

Installed skills

Kombai installs a set of skills into each client it connects to. These skills let the client hand tasks to Kombai and read the results back. Each skill is a folder with a SKILL.md file that describes what it does and how to use it.