Connect to Aiven documentation using MCP

The Aiven documentation Model Context Protocol (MCP) server lets you access Aiven documentation from MCP-compatible clients. The server is hosted by Kapa and retrieves content from the latest published documentation.

Before you begin

You need the following:

• An MCP-compatible client
• A Google account for authentication (required by some clients)

MCP server URL

Use the following server URL when configuring your client:

https://aiven-docs.mcp.kapa.ai

Configure your MCP client

Cursor

1. In your project root, create or edit .cursor/mcp.json.

2. Add the following configuration:

   {
     "mcpServers": {
       "aiven": {
         "type": "http",
         "url": "https://aiven-docs.mcp.kapa.ai"
       }
     }
   }

3. Save the file.

4. Restart Cursor.

5. Open Settings > Tools & MCP.

6. Select aiven and click Connect.

7. Sign in with your Google account when prompted.

For more information, see the Cursor MCP documentation.

Claude Code

1. Open a terminal.

2. Run the following command:

   claude mcp add --transport http aiven-docs https://aiven-docs.mcp.kapa.ai

3. Sign in with your Google account when prompted.

4. Run /mcp in Claude Code to verify the server is registered.

For more information, see the Claude Code MCP documentation.

Claude Desktop

1. Open the Claude Desktop configuration file. If it does not exist, create it:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the following to the configuration file:

   {
     "mcpServers": {
       "aiven": {
         "type": "http",
         "url": "https://aiven-docs.mcp.kapa.ai"
       }
     }
   }

3. Save the file.

4. Restart Claude Desktop.

5. Sign in with your Google account when prompted.

For more information, see the Claude Desktop MCP documentation.

VS Code

note

Requires Visual Studio Code 1.102 or later with the GitHub Copilot extension installed and enabled.

1. Open your workspace in Visual Studio Code.

2. In the workspace root, create a .vscode directory if it does not exist.

3. In the .vscode directory, create a file named mcp.json.

4. Add the following configuration:

   {
     "servers": {
       "aiven": {
         "type": "http",
         "url": "https://aiven-docs.mcp.kapa.ai"
       }
     }
   }

5. Save the file.

6. Reload Visual Studio Code.

7. Open the Command Palette and run MCP: List Servers.

8. Confirm that aiven appears in the list.

9. Sign in with your Google account when prompted.

For more information, see the VS Code MCP documentation.

ChatGPT (Web)

note

ChatGPT UI labels and navigation may change. Refer to the OpenAI documentation if the steps do not match your interface.

1. Open ChatGPT in a web browser.
2. Click Settings.
3. Select Apps, then select Advanced settings.
4. Click the Developer mode toggle.
5. Select Apps > Create app.
6. Enter the following:
   • Name: Aiven
   • Description (optional): Aiven documentation MCP server
   • MCP Server URL: https://aiven-docs.mcp.kapa.ai
7. Click Create.
8. Sign in with your Google account when prompted.
9. Confirm that Aiven appears under Settings > Apps.

For more information, see the OpenAI Developer mode documentation.

Other clients

1. Open your MCP client configuration.

2. Add the Aiven MCP server using the following URL:

   https://aiven-docs.mcp.kapa.ai

Most clients accept a configuration similar to:

{
  "mcpServers": {
    "aiven": {
      "url": "https://aiven-docs.mcp.kapa.ai"
    }
  }
}

1. Save the file and restart your client.
2. Sign in with your Google account when prompted.

Some clients require specifying the transport type, for example "type": "http". Refer to your client documentation if the configuration fails.

Verify the connection

After connecting the MCP server:

1. Open your AI client, such as Copilot Chat in Visual Studio Code or Chat in Cursor.

2. Ask a question about Aiven documentation, such as:

   • How do I create a topic in Aiven for Apache Kafka®?
   • How do I migrate snapshot data to Aiven for OpenSearch®?

3. If prompted to allow tool execution, click Allow.

4. Confirm that the response includes references to Aiven documentation.

If the response includes references to Aiven documentation, the MCP server is connected.