Install Kong Konnect MCP Server

Configure the MCP client of your choice by adding the Kong Konnect MCP Server with your URL, then authenticate with a PAT, a System Account Access Token, or, if your client supports it, a browser-based OAuth sign-in.

claude mcp add --transport http kong-konnect https://global.mcp.konghq.com

claude mcp add --transport http kong-konnect https://global.mcp.konghq.com/ \
  --header "Authorization: Bearer YOUR_KONNECT_PAT"

{
  "mcpServers": {
    "kong-konnect": {
      "type": "http",
      "url": "https://global.mcp.konghq.com/",
      "headers": {
        "Authorization": "Bearer YOUR_KONNECT_PAT"
      }
    }
  }
}

Verify the configuration

List all configured servers:

claude mcp list

You should see the following output:

kong-konnect: https://global.mcp.konghq.com/ (HTTP) - ✓ Connected

It’s also possible to install the MCP server into Claude Code via a Plugin. Instructions can be found in the Kong Skills Hub.

1. Open Visual Studio Code
2. Open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows/Linux)
3. Type “MCP” and select MCP: Open User Configuration

4. Add the Kong Konnect server configuration:

    {
      "inputs": [
        {
          "type": "promptString",
          "id": "konnect_mcp_pat",
          "description": "Konnect Personal Access Token",
          "password": true
        }
      ],
      "servers": {
        "kong-konnect": {
          "type": "http",
          "url": "https://global.mcp.konghq.com/",
          "headers": {
            "Authorization": "Bearer ${input:konnect_mcp_pat}"
          }
        }
      }
    }

   Copied!
5. Save the configuration file
6. Reload VS Code window (Command Palette > Developer: Reload Window)
7. Start the server: Open the Command Palette, enter MCP: List Servers > kong-konnect > Start Server.
8. When prompted, enter your Kong Konnect Personal Access Token or System Access Token
9. Press Enter to confirm
10. In the mcp.json settings file you should see that the server is running and that the tools are available

VS Code securely stores your PAT after the first prompt. The value is not visible in the configuration file.

1. Open the Cursor desktop app
2. Navigate to Cursor Settings (gear icon in top right corner)
3. Select MCP from the left sidebar
4. Click + Add new global MCP server

5. Paste the following JSON configuration into the mcp.json file:

    {
      "mcpServers": {
        "kong-konnect": {
          "url": "https://global.mcp.konghq.com/",
          "headers": {
            "Authorization": "Bearer YOUR_KONNECT_PAT"
          }
        }
      }
    }

   Copied!
6. Replace YOUR_KONNECT_PAT with your actual Personal Access Token
7. Save the configuration file
8. Return to Cursor Settings > MCP. You should now see the kong-konnect MCP server with available tools listed
9. To open a new Cursor chat, press Cmd+L (Mac) or Ctrl+L (Windows/Linux)
10. In the Cursor chat, click @ to add context and select tools from the Kong Kong Konnect server

It’s also possible to install the MCP server into Cursor via a Plugin. Instructions can be found in the Kong Skills Hub.

1. Open Visual Studio Code
2. Ensure GitHub Copilot extension is installed and configured
3. Open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows/Linux)
4. Type “MCP” and select MCP: Open User Configuration

5. Add the Kong Konnect server configuration:

    {
      "inputs": [
        {
          "type": "promptString",
          "id": "konnect_mcp_pat",
          "description": "Konnect Personal Access Token",
          "password": true
        }
      ],
      "servers": {
        "kong-konnect": {
          "type": "http",
          "url": "https://global.mcp.konghq.com/",
          "headers": {
            "Authorization": "Bearer ${input:konnect_mcp_pat}"
          }
        }
      }
    }

   Copied!
6. Save the configuration file
7. Start the server: Open the Command Palette, enter MCP: List Servers > kong-konnect > Start Server.
8. Reload VS Code window (Command Palette > Developer: Reload Window)
9. When prompted, enter your Kong Konnect Personal Access Token
10. Open GitHub Copilot chat and verify Kong Kong Konnect tools are available

VS Code securely stores your PAT after the first prompt. The value is not visible in the configuration file.

For IntelliJ IDEA, PyCharm, WebStorm, and other JetBrains IDEs:

1. Open your JetBrains IDE
2. Ensure GitHub Copilot plugin is installed and configured (version 1.5.50 or later)
3. Click the GitHub Copilot icon in the toolbar
4. Select Open Chat
5. Switch to Agent mode in the chat panel
6. Click the tools icon (wrench/settings)
7. Select Edit settings to open the MCP configuration

8. Add the Kong Konnect server configuration:

    {
      "servers": {
        "kong-konnect": {
          "type": "http",
          "url": "https://global.mcp.konghq.com/",
          "headers": {
            "Authorization": "Bearer YOUR_KONNECT_PAT"
          }
        }
      }
    }

   Copied!
9. Replace YOUR_KONNECT_PAT with your actual Personal Access Token
10. Save the configuration file
11. Restart your IDE
12. Open GitHub Copilot chat and verify Kong Kong Konnect tools are available

1. Open Windsurf
2. Navigate to the configuration directory: ~/.codeium/windsurf/

3. Create or edit the file mcp_config.json:

    {
      "mcpServers": {
        "kong-konnect": {
          "url": "https://global.mcp.konghq.com/",
          "headers": {
            "Authorization": "Bearer YOUR_KONNECT_PAT"
          }
        }
      }
    }

   Copied!
4. Replace YOUR_KONNECT_PAT with your actual Personal Access Token
5. Save the file
6. Restart Windsurf
7. Open Cascade chat and verify Kong Kong Konnect tools are available

For Eclipse, Xcode, and other IDEs with GitHub Copilot support:

1. Install the GitHub Copilot extension/plugin for your IDE
2. Open the GitHub Copilot preferences or settings
3. Navigate to the MCP configuration section

4. Add the Kong Konnect MCP server configuration:

    {
      "mcpServers": {
        "kong-konnect": {
          "url": "https://global.mcp.konghq.com/",
          "headers": {
            "Authorization": "Bearer YOUR_KONNECT_PAT"
          }
        }
      }
    }

   Copied!
5. Replace YOUR_KONNECT_PAT with your actual Personal Access Token
6. Save the configuration
7. Restart your IDE
8. Open the AI assistant and verify Kong Kong Konnect tools are available

Configuration methods vary by IDE. Consult your IDE’s GitHub Copilot or MCP documentation for specific setup instructions.