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

Configuration Examples

This guide provides configuration examples for integrating Testkube MCP 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.

Configuration

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 Desktop

For direct interaction with Claude through the desktop application.

Configuration

  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

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.

Troubleshooting

Common Issues

MCP server not starting:

  • Verify authentication setup
  • Check that testkube binary is accessible
  • Try running testkube mcp serve --verbose manually

No response from AI tools:

  • Restart your AI application after configuration changes
  • Verify JSON configuration syntax
  • Check application logs for MCP connection errors

Authentication errors:

  • Ensure you're logged in: testkube get context
  • Refresh your login: testkube login
  • Verify correct context is set

Debug Commands

# Test MCP server manually
testkube mcp serve --debug

# Verify CLI authentication
testkube get workflows

# Check current context
testkube get context