Install Kong Konnect MCP Server

Related Documentation
Incompatible with
on-prem
Tags

Configure the MCP client of your choice by adding the Kong Konnect MCP Server with your regional URL and PAT.

Claude Code CLI

For regional server URLs, see Regional server endpoints.

Using the claude mcp add command:

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

Replace https://us.mcp.konghq.com/ with your regional server URL and YOUR_KONNECT_PAT with your actual Personal Access Token.

You can also configure by editing the configuration file directly:

Claude CLI stores its configuration in ~/.claude.json (or .mcp.json for project scope):

{
  "mcpServers": {
    "kong-konnect": {
      "type": "http",
      "url": "https://us.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://us.mcp.konghq.com/ (HTTP) - ✓ Connected

Visual Studio Code

For regional server URLs, see Regional server endpoints.

  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://us.mcp.konghq.com/",
           "headers": {
             "Authorization": "Bearer ${input:konnect_mcp_pat}"
           }
         }
       }
     }
    
  5. Replace https://us.mcp.konghq.com/ with your regional server URL if needed
  6. Save the configuration file
  7. Reload VS Code window (Command Palette > Developer: Reload Window)
  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.

Cursor

For regional server URLs, see Regional server endpoints.

  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://us.mcp.konghq.com/",
           "headers": {
             "Authorization": "Bearer YOUR_KONNECT_PAT"
           }
         }
       }
     }
    
  6. Replace https://us.mcp.konghq.com/ with your regional server URL
  7. Replace YOUR_KONNECT_PAT with your actual Personal Access Token
  8. Save the configuration file
  9. Return to Cursor Settings > MCP. You should now see the kong-konnect MCP server with available tools listed
  10. To open a new Cursor chat, press Cmd+L (Mac) or Ctrl+L (Windows/Linux)
  11. In the Cursor chat, click @ to add context and select tools from the Kong Kong Konnect server

GitHub Copilot for VS Code

For regional server URLs, see Regional server endpoints.

  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://us.mcp.konghq.com/",
           "headers": {
             "Authorization": "Bearer ${input:konnect_mcp_pat}"
           }
         }
       }
     }
    
  6. Replace https://us.mcp.konghq.com/ with your regional server URL if needed
  7. Save the configuration file
  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.

GitHub Copilot for JetBrains

For regional server URLs, see Regional server endpoints.

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://us.mcp.konghq.com/",
           "headers": {
             "Authorization": "Bearer YOUR_KONNECT_PAT"
           }
         }
       }
     }
    
  9. Replace https://us.mcp.konghq.com/ with your regional server URL
  10. Replace YOUR_KONNECT_PAT with your actual Personal Access Token
  11. Save the configuration file
  12. Restart your IDE
  13. Open GitHub Copilot chat and verify Kong Kong Konnect tools are available

Windsurf

For regional server URLs, see Regional server endpoints.

  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://us.mcp.konghq.com/",
           "headers": {
             "Authorization": "Bearer YOUR_KONNECT_PAT"
           }
         }
       }
     }
    
  4. Replace https://us.mcp.konghq.com/ with your regional server URL
  5. Replace YOUR_KONNECT_PAT with your actual Personal Access Token
  6. Save the file
  7. Restart Windsurf
  8. Open Cascade chat and verify Kong Kong Konnect tools are available

Other IDEs

For regional server URLs, see Regional server endpoints.

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://us.mcp.konghq.com/",
           "headers": {
             "Authorization": "Bearer YOUR_KONNECT_PAT"
           }
         }
       }
     }
    
  5. Replace https://us.mcp.konghq.com/ with your regional server URL
  6. Replace YOUR_KONNECT_PAT with your actual Personal Access Token
  7. Save the configuration
  8. Restart your IDE
  9. 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.

Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!