Configure the MCP client of your choice by adding the Kong Konnect MCP Server with your regional URL and PAT.
Install Kong Konnect MCP Server
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 andYOUR_KONNECT_PATwith 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.
- Open Visual Studio Code
- Open the Command Palette (
Cmd+Shift+Pon Mac,Ctrl+Shift+Pon Windows/Linux) - Type “MCP” and select MCP: Open User Configuration
-
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}" } } } }Copied! - Replace
https://us.mcp.konghq.com/with your regional server URL if needed - Save the configuration file
- Reload VS Code window (Command Palette > Developer: Reload Window)
- When prompted, enter your Kong Konnect Personal Access Token or System Access Token
- Press Enter to confirm
- In the
mcp.jsonsettings 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.
- Open the Cursor desktop app
- Navigate to Cursor Settings (gear icon in top right corner)
- Select MCP from the left sidebar
- Click + Add new global MCP server
-
Paste the following JSON configuration into the
mcp.jsonfile:{ "mcpServers": { "kong-konnect": { "url": "https://us.mcp.konghq.com/", "headers": { "Authorization": "Bearer YOUR_KONNECT_PAT" } } } }Copied! - Replace
https://us.mcp.konghq.com/with your regional server URL - Replace
YOUR_KONNECT_PATwith your actual Personal Access Token - Save the configuration file
- Return to Cursor Settings > MCP. You should now see the
kong-konnectMCP server with available tools listed - To open a new Cursor chat, press
Cmd+L(Mac) orCtrl+L(Windows/Linux) - 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.
- Open Visual Studio Code
- Ensure GitHub Copilot extension is installed and configured
- Open the Command Palette (
Cmd+Shift+Pon Mac,Ctrl+Shift+Pon Windows/Linux) - Type “MCP” and select MCP: Open User Configuration
-
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}" } } } }Copied! - Replace
https://us.mcp.konghq.com/with your regional server URL if needed - Save the configuration file
- Reload VS Code window (Command Palette > Developer: Reload Window)
- When prompted, enter your Kong Konnect Personal Access Token
- 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:
- Open your JetBrains IDE
- Ensure GitHub Copilot plugin is installed and configured (version 1.5.50 or later)
- Click the GitHub Copilot icon in the toolbar
- Select Open Chat
- Switch to Agent mode in the chat panel
- Click the tools icon (wrench/settings)
- Select Edit settings to open the MCP configuration
-
Add the Kong Konnect server configuration:
{ "servers": { "kong-konnect": { "type": "http", "url": "https://us.mcp.konghq.com/", "headers": { "Authorization": "Bearer YOUR_KONNECT_PAT" } } } }Copied! - Replace
https://us.mcp.konghq.com/with your regional server URL - Replace
YOUR_KONNECT_PATwith your actual Personal Access Token - Save the configuration file
- Restart your IDE
- Open GitHub Copilot chat and verify Kong Kong Konnect tools are available
Windsurf
For regional server URLs, see Regional server endpoints.
- Open Windsurf
- Navigate to the configuration directory:
~/.codeium/windsurf/ -
Create or edit the file
mcp_config.json:{ "mcpServers": { "kong-konnect": { "url": "https://us.mcp.konghq.com/", "headers": { "Authorization": "Bearer YOUR_KONNECT_PAT" } } } }Copied! - Replace
https://us.mcp.konghq.com/with your regional server URL - Replace
YOUR_KONNECT_PATwith your actual Personal Access Token - Save the file
- Restart Windsurf
- 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:
- Install the GitHub Copilot extension/plugin for your IDE
- Open the GitHub Copilot preferences or settings
- Navigate to the MCP configuration section
-
Add the Kong Konnect MCP server configuration:
{ "mcpServers": { "kong-konnect": { "url": "https://us.mcp.konghq.com/", "headers": { "Authorization": "Bearer YOUR_KONNECT_PAT" } } } }Copied! - Replace
https://us.mcp.konghq.com/with your regional server URL - Replace
YOUR_KONNECT_PATwith your actual Personal Access Token - Save the configuration
- Restart your IDE
- 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.