> ## Documentation Index
> Fetch the complete documentation index at: https://portkey-docs-mintlify-add-terraform-provider-docs-72855.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Clients

Portkey makes it simple to integrate with MCP clients by connecting directly to your MCP servers and handling authentication automatically.

With Portkey, you can connect any server registered on Portkey’s MCP Hub using just a URL—no infrastructure setup, no secret management.

***

## Connecting your MCP Server

Once you’ve connected your MCP server to Portkey, Portkey provides you with a ready-to-use URL. For example:

```
https://mcp.portkey.ai/:workspace-id/:mcp-server-id/mcp
```

That’s all you need to connect Portkey to any MCP client.

***

You can simply add your MCO server configuration using JSON in your desired application:

Add this configuration to your Claude or other MCP client settings.

<CodeGroup>
  ```json Mac/Linux theme={null}
  {
    "mcpServers": {
      "portkey-mcp": {
        "enabled": true,
        "command": "npx",
        "source": "custom",
        "args": [
          "https://mcp.portkeydev.com/ws-shared-r43vt4/linear-be8562/mcp"
        ]
      }
    }
  }




  ```

  ```json Windows theme={null}
  {
    "mcpServers": {
      "portkey-mcp": {
        "enabled": true,
        "command": "npx",
        "source": "custom",
        "args": [
          "https://mcp.portkeydev.com/ws-shared-r43vt4/linear-be8562/mcp"
        ]
      }
    }
  }
  ```

  ```json WSL theme={null}
  {
    "mcpServers": {
      "portkey-mcp": {
        "enabled": true,
        "command": "npx",
        "source": "custom",
        "args": [
          "https://mcp.portkeydev.com/ws-shared-r43vt4/linear-be8562/mcp"
        ]
      }
    }
  }
  ```
</CodeGroup>

## Example: Connecting to Cursor

1. Open Cursor:
   **Cmd/Ctrl + Shift + P → View: Open MCP settings**

2. Click **Add a new MCP server**. This opens your MCP JSON.

3. Modify the JSON like this:

```json theme={null}
{
  "mcpServers": {
    "server1": {
      "url": "https://mcp.portkey.ai/:workspace-id/:mcp-server-id/mcp"
    },
    "server2": {
      "url": "https://mcp.portkey.ai/:workspace-id/:mcp-server-id/mcp"
    }
  }
}
```

4. Note that Portkey manages authentication end to end. If the upstream MCP server requires auth, Portkey will prompt the user to allow access and then complete the auth flow with that server.

That’s it—you’ve added a Portkey MCP server to Cursor in just a few steps.

This keeps the developer experience extremely clean while maintaining granular access control and authentication.

## Supported MCP Clients

Here are some popular MCP clients that you can easily connect with Portkey:

<CardGroup cols={3}>
  <Card title="Claude Desktop" href="/integrations/mcp-clients/claude" />

  <Card title="Claude Code" href="/integrations/mcp-clients/claude-code" />

  <Card title="Cursor" href="/integrations/mcp-clients/cursor" />

  <Card title="LibreChat" href="/integrations/mcp-clients/librechat" />

  <Card title="VS Code" href="/integrations/mcp-clients/vs-code" />
</CardGroup>

***

# Connect MCP Servers to your LLM

Coming Soon!

***

## Next Steps

<CardGroup cols={2}>
  <Card title="VS Code Insiders">
    Supported capabilities
  </Card>

  <Card title="VS Code Insiders">
    View logs & traces for MCP interactions
  </Card>

  <Card title="VS Code Insiders">
    Authentication deep dive
  </Card>

  <Card title="VS Code Insiders">
    Add guardrails
  </Card>
</CardGroup>