Agentset + GitHub Copilot (VS Code): Complete MCP Integration
Agentset is a MCP server that RAG for your knowledge base connected to Agentset..
When integrated with GitHub Copilot (VS Code), you can:
- Search through indexed documents using RAG
- Retrieve specific document by ID
- Perform semantic search across knowledge base
This guide provides step-by-step instructions to set up Agentset in GitHub Copilot (VS Code), including configuration, examples, and troubleshooting.
What You'll Achieve
After completing this setup:
- Agentset will be fully integrated and operational
- You can use Agentset tools directly in GitHub Copilot (VS Code)
- All Agentset capabilities will be available for your workflows
- Access to 4 different tools
Prerequisites
Before starting, ensure you have:
- API key from Agentset dashboard
- Namespace identifier for knowledge base
- GitHub Copilot (VS Code) installed and configured
- Compatible operating system (Windows, macOS, Linux)
Installation
Step 1: Install Agentset
Configuration
Step 2: Configure GitHub Copilot (VS Code)
-
Locate your configuration file:
- Windows:
.vscode\\mcp.json in your project directory - macOS:
.vscode/mcp.json in your project directory - Linux:
.vscode/mcp.json in your project directory
- Windows:
-
Add server configuration:
{
"mcpServers": {
"agentset": {
"command": "agentset",
"args": [],
"env": {
"AGENTSET_API_KEY": "as_1234567890abcdef",
"AGENTSET_NAMESPACE_ID": "ns_workspace123",
"AGENTSET_TENANT_ID": "tenant_abc123"
}
}
}
}
- Restart GitHub Copilot (VS Code)
Completely quit and restart GitHub Copilot (VS Code) to load the new configuration.
Examples
Once configured, you can use Agentset in GitHub Copilot (VS Code):
Technical Documentation Search
undefined
Ask GitHub Copilot (VS Code): "How do I configure SSL certificates in our system?"
Expected Result: undefined
Code Example Retrieval
undefined
Ask GitHub Copilot (VS Code): "Show me examples of error handling in our codebase"
Expected Result: undefined
Policy and Procedure Lookup
undefined
Ask GitHub Copilot (VS Code): "What's our deployment approval process?"
Expected Result: undefined
Testing Your Setup
- Start a new conversation in GitHub Copilot (VS Code)
- Ask GitHub Copilot (VS Code) to list available tools
- Try using Agentset functionality
Test prompts:
- "What MCP tools are available?"
- "Use Agentset to help with my code"
- "Show me what Agentset can do"
Troubleshooting
Common Issues
MCP Configuration Not Loaded
Symptoms: MCP tools not appearing, Copilot does not recognize MCP server
Cause: Configuration file not in correct location or invalid JSON
Solution:
- Verify .vscode/mcp.json exists in project root directory
- Check JSON syntax is valid (no trailing commas, proper quotes)
- Reload VS Code window after making configuration changes
- Check VS Code Developer Tools (Help > Toggle Developer Tools) for errors
MCP Server Not Starting
Symptoms: Tools listed but not responding, Server connection errors
Cause: Server command path incorrect or dependencies missing
Solution:
- Test the MCP server command independently in terminal
- Verify all server prerequisites are installed
- Check that command path is correct (use absolute paths if needed)
- Ensure required environment variables are set in mcp.json
- Review VS Code Output panel for MCP server error messages
GitHub Copilot Subscription Required
Symptoms: Copilot features grayed out, Unable to access Copilot Chat
Cause: No active GitHub Copilot subscription
Solution:
- Sign up for GitHub Copilot subscription (Individual, Business, or Enterprise)
- Verify subscription is active in GitHub account settings
- Re-authenticate GitHub Copilot in VS Code
- Check that VS Code is using correct GitHub account
VS Code Version Too Old
Symptoms: MCP configuration ignored, No mcp.json recognition
Cause: VS Code version below 1.99 does not have native MCP support
Solution:
- Update VS Code to version 1.99 or later
- Check current version: Help > About
- Download latest version from code.visualstudio.com
- After updating, reload window and verify MCP support
{server_name} Tools Not Working
Symptoms: Server connected but tools fail, Error messages when invoking tools
Cause: Server-specific configuration or authentication issues
Solution:
- Verify all required environment variables for {server_name} are set
- Check {server_name} documentation for specific prerequisites
- Test {server_name} with another MCP client to isolate issue
- Review error messages in VS Code Output panel for specific failures
Agentset not appearing in GitHub Copilot (VS Code)
Symptoms: Server not listed, Tools not available
Cause: Configuration or installation issue
Solution:
- Verify configuration syntax
- Check Agentset installation
- Restart GitHub Copilot (VS Code)
- Check logs for error messages
Next Steps
Now that Agentset is integrated with GitHub Copilot (VS Code):
- Explore all Agentset capabilities through GitHub Copilot (VS Code)
- Check out other MCP servers that work with GitHub Copilot (VS Code)
- Join the MCP community for tips and support
- Consider contributing to Agentset development
Need Help?
- Search for Agentset documentation
- Check the GitHub Copilot (VS Code) MCP guide
- Join the MCP community discussions