> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0mcp.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Client setup

> Connect your MCP server to your preferred AI client.

After publishing your MCP server, you can connect it to any supported MCP client using the configuration generated by 0mcp.

The **Setup** page provides everything you need, including your MCP endpoint, client-specific configuration, and any required authentication details.

## Supported clients

0mcp provides setup guides for:

* Claude Code
* Claude Desktop
* Cursor
* Codex
* VS Code
* Windsurf

Each guide includes the configuration required for that client. Choose your client from the **Setup** group in the left sidebar.

<Note>
  Windsurf supports 0mcp when your installed version includes support for remote **Streamable HTTP** MCP servers.
</Note>

## Before you connect

Before configuring a client, make sure you have:

* [Published](/guides/versioning) your MCP server
* Reviewed any required [authentication credentials](/concepts/authentication-model)
* Stored secrets in environment variables or your client's secure credential store

<Warning>
  Avoid placing API keys or access tokens directly in shared configuration files.
</Warning>

## Connect your client

1. Open your server in the 0mcp dashboard.
2. Navigate to **Setup**.
3. Select your MCP client.
4. Copy the generated configuration.
5. Add any required environment variables or credentials.
6. Restart or reconnect your client.

Once connected, your client will discover the published [tools](/capabilities/tools), [resources](/capabilities/resources), and [prompts](/capabilities/prompts) available on your MCP server.

## Troubleshooting

If your client can't connect to the server, see [**MCP Connection Issues**](/troubleshooting/mcp-connection-issues).

If the connection succeeds but no capabilities appear, see [**Tool Discovery Problems**](/troubleshooting/tool-discovery-problems).