MCP Server Configuration Examples

This guide provides configuration examples for integrating the Testkube MCP Server with various AI tools and development environments.

tip

Before configuring your AI tools, make sure you've set up the Testkube MCP Server using one of these methods:

• Hosted Endpoint (Recommended - no installation required)
• CLI Setup (For local development)
• Docker Setup (For containerized deployments)

GitHub Copilot (VS Code)

GitHub Copilot with Agent mode in VS Code provides excellent agentic capabilities for multi-step testing workflows.

Using the Hosted Endpoint (Recommended)

1. Create or edit your MCP configuration file:

   Location: ~/Library/Application Support/Code/User/mcp.json (macOS) or %APPDATA%\Code\User\mcp.json (Windows)

   {
     "mcpServers": {
       "testkube": {
         "url": "https://api.testkube.io/organizations/tkcorg_YOUR_ORG_ID/environments/tkcenv_YOUR_ENV_ID/mcp",
         "transport": {
           "type": "sse"
         },
         "headers": {
           "Authorization": "Bearer YOUR_API_TOKEN_HERE"
         }
       }
     }
   }

   Replace tkcorg_YOUR_ORG_ID, tkcenv_YOUR_ENV_ID, and YOUR_API_TOKEN_HERE with your actual values.

   Learn more about the hosted endpoint →

2. Restart VS Code to load the new configuration

3. Test the integration:

   • Open GitHub Copilot Agent mode
   • Try a prompt like: list my testkube workflows

Using the CLI

1. Create or edit your MCP configuration file:

   Location: ~/Library/Application Support/Code/User/mcp.json (macOS) or %APPDATA%\Code\User\mcp.json (Windows)

   {
     "servers": {
       "testkube": {
         "command": "testkube",
         "args": ["mcp", "serve"],
         "type": "stdio"
       }
     },
     "inputs": []
   }

   Learn more about CLI setup →

2. Restart VS Code to load the new configuration

3. Test the integration:

   • Open GitHub Copilot Agent mode
   • Try a prompt like: list my testkube workflows

Recommended Usage

With GitHub Copilot Agent mode, you can perform complex multi-step operations:

Help me debug the last failed execution of my api-tests workflow.
Show me the logs, check for any artifacts, and suggest what might be wrong.

Best Experience

We recommend using Claude Sonnet 4 with GitHub Copilot for the most sophisticated reasoning capabilities.

Cursor

Cursor provides powerful AI assistance with built-in MCP support.

Using the Hosted Endpoint (Recommended)

Add the hosted endpoint configuration to your Cursor MCP settings:

{
  "mcpServers": {
    "testkube": {
      "url": "https://api.testkube.io/organizations/tkcorg_YOUR_ORG_ID/environments/tkcenv_YOUR_ENV_ID/mcp",
      "transport": {
        "type": "sse"
      },
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN_HERE"
      }
    }
  }
}

Replace tkcorg_YOUR_ORG_ID, tkcenv_YOUR_ENV_ID, and YOUR_API_TOKEN_HERE with your actual values.

Learn more about the hosted endpoint →

Using the CLI

Add Testkube server configuration to your Cursor MCP settings:

{
  "mcpServers": {
    "testkube": {
      "command": "testkube",
      "args": ["mcp", "serve"],
      "type": "stdio"
    }
  }
}

Learn more about CLI setup →

Usage Examples

Create a test workflow that checks my REST API endpoints, then run it and show me the results.

Look at my recent test failures and help me understand what's causing them. Check the logs and artifacts.

Claude

Claude Desktop

For direct interaction with Claude through the desktop application.

Using the Hosted Endpoint (Recommended)

1. Create or edit Claude Desktop config:

   Location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

   {
     "mcpServers": {
       "testkube": {
         "url": "https://api.testkube.io/organizations/tkcorg_YOUR_ORG_ID/environments/tkcenv_YOUR_ENV_ID/mcp",
         "transport": {
           "type": "sse"
         },
         "headers": {
           "Authorization": "Bearer YOUR_API_TOKEN_HERE"
         }
       }
     }
   }

   Replace tkcorg_YOUR_ORG_ID, tkcenv_YOUR_ENV_ID, and YOUR_API_TOKEN_HERE with your actual values.

   Learn more about the hosted endpoint →

2. Restart Claude Desktop

Using the CLI

1. Create or edit Claude Desktop config:

   Location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

   {
     "mcpServers": {
       "testkube": {
         "command": "testkube",
         "args": ["mcp", "serve"]
       }
     }
   }

   Learn more about CLI setup →

2. Restart Claude Desktop

Claude Code

Use the following to add the Docker MCP Server to Claude Code

claude mcp add testkube -- docker run --rm -i \ 
   -e TK_ACCESS_TOKEN=${TK_ACCESS_TOKEN} \
   -e TK_ORG_ID=${TK_ORG_ID} \
   -e TK_ENV_ID=${TK_ENV_ID} \
   kubeshop/testkube-mcp-server:latest mcp serve

Learn more about Docker setup →

Usage

Claude Desktop provides conversational access to your Testkube resources:

Can you show me all my test workflows and their recent execution status?

I need to create a new workflow for testing my Python application.
Can you help me set this up?

Example Claude Workflows

Automated Debugging Session

I need help with my failed test execution "api-tests-123".
Can you:
1. Get the execution details
2. Show me the logs
3. Check if there are any artifacts
4. Analyze what went wrong
5. Suggest next steps

Test Analysis and Reporting

Analyze my test execution trends for the last week.
Show me which workflows are failing most often and help me create a summary report for my team.