How to Use the Kong Gateway MCP in Claude

Q: How do I configure the Kong Gateway MCP Server inside Claude Desktop?

Open your claudedesktopconfig.json file and add the server configuration under the mcpServers block with the required environment variables. Save the file and restart Claude Desktop to see the new tools under the hammer icon in your chat window.

Q: Can Claude Desktop execute write operations on my Kong Gateway?

Yes, your agent uses createroute and createservice to modify your gateway state in real time. It executes these actions directly through the Admin API using the credentials you provide in the configuration.

Q: How does the Kong Gateway MCP Server handle multi-entity relationships in Claude Desktop?

The server maps parent-child associations using tools like createsni linked to specific certificates. Your agent analyzes the current configuration, gets the required IDs, and links the entities automatically in your chat session.

Manage your API Gateway infrastructure directly from Claude Desktop with local tool access and simple stdio transport.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Kong Gateway MCP to Claude Desktop

Create your Vinkius account to connect Kong Gateway to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Kong Gateway with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Route and Service Provisioning

`create_route` lets you map paths and associate them with backend services inside Claude Desktop. Your agent connects to the Kong Admin API to instantly register new endpoints without you writing complex cURL commands or waiting for slow CI pipelines. You can inspect existing configurations with `get_service` and `list_routes` right in your chat window. This gives you immediate visibility into your gateway layout while you test local microservices.

Dynamic Plugin and Security Management

`create_plugin` injects rate-limiting, authentication, or key-auth plugins directly into your gateway using Claude Desktop. If a service is getting hammered, you tell your agent to apply protection, and it executes the configuration immediately. You can also audit active plugins across your entire gateway using `list_plugins` to find unsecured endpoints. This setup makes it easy to lock down routes before they ever reach production.

Upstream and Target Control via MCP Server

`create_upstream` sets up load-balanced backends in your local development cluster directly from Claude Desktop. When you need to scale or swap targets, your agent uses `create_target` to direct traffic to new instances. You can run health checks or fetch backend status with `get_status` and `list_targets` during active debugging sessions. If a target acts up, you tell the agent to drop it, and it runs `delete_target` instantly.

Setup guide

Set up Kong Gateway MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Kong Gateway MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Kong Gateway MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under kong-gateway-mcp.

json

{
  "mcpServers": {
    "kong-gateway-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Kong Gateway. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Kong Gateway now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Kong Gateway MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the server configuration under the `mcpServers` block with the required environment variables. Save the file and restart Claude Desktop to see the new tools under the hammer icon in your chat window.

Yes, your agent uses `create_route` and `create_service` to modify your gateway state in real time. It executes these actions directly through the Admin API using the credentials you provide in the configuration.

The server maps parent-child associations using tools like `create_sni` linked to specific certificates. Your agent analyzes the current configuration, gets the required IDs, and links the entities automatically in your chat session.

The integration runs over a standard stdio transport layer managed locally by your machine. This ensures low-latency execution for tools like `list_services` without exposing your admin credentials to external servers.

Your Kong Gateway configuration details and API keys remain strictly on your local machine. The desktop application executes tools like `get_certificate` locally via stdio, meaning no sensitive gateway credentials ever leave your network.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript