Connect Kenso to VS Code and GitHub Copilot with MCP
VS Code with GitHub Copilot connects to Kenso's remote MCP server over HTTP. Open Install in VS Code on this page, or run MCP: Add Server and paste Kenso's server URL, then sign in to Kenso. Copilot Business and Enterprise need the MCP servers in Copilot policy turned on.
Can You Add Kenso to VS Code in One Click?
In short: Yes. Open the link, confirm Kenso in VS Code, then sign in to Kenso in your browser.
- Install in VS Code: VS Code opens the server details with Kenso filled in. Select Install, then sign in to Kenso.
How Do You Connect Kenso to VS Code?
In short: Add https://mcp.ken.so/mcp as a remote MCP server in VS Code, then sign in to Kenso in your browser.
Run MCP: Add Server
Open the Command Palette and run MCP: Add Server, or open Chat: Open Customizations, go to MCP Servers and select Add Server. Choose HTTP.
Enter Kenso's URL and a Server ID
Paste the URL below, enter kenso as the server ID, and pick where to save it. VS Code recommends a portable destination for new servers: Copilot Global (~/.copilot/mcp-config.json) for every workspace, or .mcp.json at the workspace root to share Kenso with your team. The .mcp.json option appears when the experimental chat.mcp.workspaceRootConfig.enabled setting is on. An entry you already added as ken keeps working: the name is only a label on your machine.
https://mcp.ken.so/mcpCheck the Saved Entry
In VS Code's own mcp.json format (.vscode/mcp.json or your user profile), which VS Code still offers but marks deprecated, the entry looks like this. The portable files use a top-level mcpServers key instead of servers.
{
"servers": {
"kenso": {
"type": "http",
"url": "https://mcp.ken.so/mcp"
}
}
}Start Kenso and Sign In
Start the server from MCP: List Servers if it does not start on its own, and trust it when VS Code asks. VS Code registers itself with Kenso and opens the sign-in. Your browser opens the Kenso sign-in. Sign in with the account you use in the Kenso app, then select Allow access on the Kenso approval screen. You never paste a client ID or secret.
Turn On Kenso's Tools in Chat
In the Chat view, select Configure Tools in the chat input and make sure Kenso's tools are on.
Can You Use a Kenso API Key Instead of OAuth?
In short: Yes. VS Code can send your Kenso API key as a Bearer token when a browser sign-in is not an option.
Use a Kenso API Key Header Instead
Create a key in the Kenso app under Settings > Integrations > API Keys. VS Code asks for the input the first time the server starts and stores it securely, so the key never sits in the file. Input variables only work in VS Code's own mcp.json format (.vscode/mcp.json or your user profile), not in the portable files.
{
"inputs": [
{
"type": "promptString",
"id": "ken-api-key",
"description": "Kenso API key",
"password": true
}
],
"servers": {
"kenso": {
"type": "http",
"url": "https://mcp.ken.so/mcp",
"headers": {
"Authorization": "Bearer ${input:ken-api-key}"
}
}
}
}What Can You Ask Kenso From VS Code?
In short: Ask in plain language. The client picks the Kenso tool, and Kenso runs it with your workspace role.
| Ask | Kenso tool used | What the tool does |
|---|---|---|
| Find VPs of Sales at US software companies with 50 to 200 employees. | search_read | Searches Kenso's people and company database and returns filter facets. |
| Load Kenso's create-campaign skill and plan a 3-step cold email campaign for that list. | load_skill | Loads one Kenso workflow skill, such as create-campaign, into the chat. |
| Before I launch, preview who lands in the Series B segment. | segments_read | Previews which contacts land in a campaign segment. |
| How many emails a day can this campaign send with the inboxes it has? | campaign_flow_read | Estimates how many emails a campaign can send with its inboxes. |
| Which of my campaigns are running right now? | campaigns_read | Lists campaigns and reads one campaign's settings and status. |
| How did my campaigns do this week? Show sends, replies and bounces for each one. | analytics_read | Reads campaign performance, engagement, deliverability and reply classifications. |
Admins and members get read and write tools. A view-only seat gets read tools plus 20 write tools, inbox replies among them. Only the read-only URL, https://mcp.ken.so/mcp/readonly, removes every tool that writes.
- Kenso MCP security: Prompt injection, the read-only URL and what each role can change
What If Kenso Does Not Connect in VS Code?
In short: Most failures come from a skipped sign-in step or a client setting.
| Problem | Fix |
|---|---|
| Kenso shows an error in the Chat view | Run MCP: List Servers, select kenso and choose Show Output to read the log. |
| Kenso does not start in a workspace | Workspace MCP servers follow Workspace Trust and are blocked in Restricted Mode. Trust the workspace, or run MCP: Reset Trust and start Kenso again. |
| The Kenso sign-in keeps failing after a reinstall | Run Authentication: Remove Dynamic Authentication Providers, remove Kenso's entry, then start the server again so VS Code registers a fresh client. |
| A Kenso tool answers "Missing scope" | Part of the Kenso approval screen was declined. Remove Kenso from the client, add it again and select Allow access. |
Frequently Asked Questions
Copilot Free, Pro, Pro+ and Max are not governed by the MCP policy. On Copilot Business and Enterprise, an admin must turn on the MCP servers in Copilot policy, which is off by default.
Save it to Copilot Global to have Kenso in every workspace, or to .mcp.json at the workspace root to commit Kenso for your team. VS Code still offers .vscode/mcp.json and the user-profile mcp.json, but marks both deprecated. Each person still signs in with their own Kenso account.
VS Code can ask you to confirm each tool call in chat, and Configure Tools lets you switch individual Kenso tools off.
Only what your Kenso role allows. Admins and members get read and write tools, including campaign launches. A view-only seat gets read tools plus 20 write tools: account_write, api_keys_write, calendar_write, claim_links_write, email_copy_write, integrations_write, ken_chats_write, meeting_notes_write, meeting_shares_write, notetaker_write, onboarding_write, permissions_write, provider_search_write, replies_write, saved_searches_write, scheduler_write, search_write, tags_write, threads_write and workspace_write. Of those, threads_write can send a reply email, delete threads and bulk-update them, scheduler_write can bulk-cancel bookings, meeting_shares_write can put the notes of a meeting the seat owns on a public link, provider_search_write spends the workspace's Blitz records, api_keys_write can revoke the seat's own API keys and connected agents, and workspace_write can create a new workspace. For a connection that cannot change anything, use https://mcp.ken.so/mcp/readonly. Kenso checks your role on every call, so a role change applies right away.
Related
Kenso MCP server
What Kenso's MCP server does and every client it works with
Claude MCP: Connect Kenso as a Custom Connector
ChatGPT MCP: Connect Kenso as a Custom MCP Server
Claude Code MCP: Connect Kenso
Cursor MCP: Connect Kenso
Codex MCP: Connect Kenso to OpenAI Codex
Gemini CLI MCP: Connect Kenso
Connect Kenso to Perplexity with MCP
Connect Kenso to Claude Desktop with MCP
Kenso pricing
Plans and credit prices
Sources
Changelog
- : Added the Install in VS Code link.
- : Page published.