Skip to main content
New to Testkube? Unleash the power of cloud native testing in Kubernetes with Testkube. Get Started >

MCP Server Configuration Examples

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

GitHub Copilot (VS Code)​

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

Configuration​

  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": []
    }

  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

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.

Add Testkube server configuration to your Cursor MCP settings:

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

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.

  1. Create or edit Claude Desktop config:

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

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

  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} \
   testkube/mcp-server:latest mcp serve

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.