{"site":{"name":"Koji","description":"AI-native customer research platform that helps teams conduct, analyze, and synthesize customer interviews at scale.","url":"https://www.koji.so","contentTypes":["blog","documentation"],"lastUpdated":"2026-05-21T02:06:30.004Z"},"content":[{"type":"documentation","id":"00262020-a839-45cc-8b20-8bda6efd8444","slug":"mcp-setup-vscode","title":"Connect Koji to VS Code (MCP): Setup Guide for Copilot Chat Engineers","url":"https://www.koji.so/docs/mcp-setup-vscode","summary":"Connect the Koji MCP server to VS Code (1.97+) by adding a .vscode/mcp.json file with the Koji HTTP endpoint and a prompted API-key input. Once connected, GitHub Copilot Chat in Agent mode can call all 15 Koji tools — list studies, fetch interviews, pull transcripts, generate reports, and create new studies — directly inside the editor. This enables PR descriptions backed by verbatim customer quotes, spec writing against real pain points, closed-loop bug-fix follow-up studies, and pre-deploy sentiment checks. Configuration uses VS Code's secure input prompt so the API key never sits in the JSON file, making the config safe to commit to git.","content":"**TL;DR:** VS Code 1.97+ has native Model Context Protocol (MCP) support inside GitHub Copilot Chat's Agent mode. Adding Koji's MCP server takes about three minutes: create a `.vscode/mcp.json` file in your workspace (or add to your user settings), paste the Koji server block, and authenticate with your Koji API key. Once connected, every Copilot Chat session can list studies, fetch interview transcripts, pull structured answers, and even create new studies — turning your editor into a research-aware coding environment without ever leaving the file you're working on.\n\n## Why connect Koji to VS Code\n\nMost engineering teams already live in VS Code. When a PRD lands, you read it there. When a ticket gets groomed, the spec gets pasted into a comment there. When a senior engineer reviews a PR, they leave inline feedback there. But the customer evidence that should be driving every one of those decisions usually lives somewhere else — a Notion doc, a research repo, a Loom recording, a Slack thread — and that distance is where bad product decisions get made.\n\nThe Koji MCP integration closes that gap. With MCP wired into VS Code, GitHub Copilot Chat can pull live customer interviews, structured answers, theme analyses, and full study reports directly into the conversation you're already having about code. That means you can:\n\n- Ask Copilot to write the empty-state copy for a checkout component using verbatim quotes from your last 30 onboarding interviews\n- Generate a one-paragraph PR description that cites the exact pain point a feature solves\n- Have the AI cross-reference a proposed API design against what users said in pricing-research interviews\n- Build a tasklist from a research report without copying a single line by hand\n\nThis is the modern alternative to manual research-to-code workflows. Tools like Koji automate the heavy lifting — transcription, quality scoring, structured answer extraction, theme generation — and the MCP server makes that automated output addressable from any AI surface, including the editor.\n\n## Prerequisites\n\nBefore you start, confirm you have:\n\n1. **VS Code 1.97 or later.** MCP became generally available with the February 2026 release. To check, open VS Code and run \"About Visual Studio Code\" from the command palette.\n2. **GitHub Copilot subscription.** MCP runs inside Copilot Chat's Agent mode. Free Copilot users now have limited agent access; paid users get the full experience.\n3. **A Koji account.** The MCP server is available on every plan including Free, so you do not need to upgrade to try it.\n4. **A Koji API key.** Generate one in Koji under Settings → API Keys. Treat this key like a password — anyone with it can read your studies and create new interviews.\n\n## Step 1: Create the MCP configuration file\n\nVS Code looks for MCP server definitions in two places:\n\n- **Workspace-level**: `.vscode/mcp.json` inside your project (best for team-shared configs that get checked into git)\n- **User-level**: through `Preferences: Open User Settings (JSON)` under the `mcp` key (best for personal configs you want available in every workspace)\n\nFor most engineering teams, workspace-level is the right default — your whole team gets the same toolset without anyone having to wire it up individually.\n\nCreate `.vscode/mcp.json` with the following content:\n\n```json\n{\n  \"servers\": {\n    \"koji\": {\n      \"type\": \"http\",\n      \"url\": \"https://www.koji.so/api/mcp/http\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${input:koji-api-key}\"\n      }\n    }\n  },\n  \"inputs\": [\n    {\n      \"id\": \"koji-api-key\",\n      \"type\": \"promptString\",\n      \"description\": \"Koji API key from app.koji.so → Settings → API Keys\",\n      \"password\": true\n    }\n  ]\n}\n```\n\nThe `inputs` block is important: it tells VS Code to prompt you for the key the first time you use the server and store it securely in the OS keychain. The literal API key never lives in the JSON file, which means it stays out of git history even if the config file is committed.\n\n## Step 2: Start the server and authenticate\n\nOpen Copilot Chat (Ctrl/Cmd + Alt + I) and switch to **Agent mode** from the dropdown. Click the tools icon (🔧) above the input box. You should see \"koji\" listed as an available server. Click \"Start\" — VS Code will prompt you for the API key, and you'll see a green dot next to \"koji\" once the handshake succeeds.\n\nIf the dot is red or yellow, jump to the troubleshooting section at the end of this guide.\n\n## Step 3: Try your first query\n\nIn Agent mode, ask Copilot:\n\n> \"List my Koji studies and tell me which one has the most completed interviews this week.\"\n\nCopilot will call `koji_list_studies`, then for each study call `koji_get_interviews` filtered by recent completions, and present a ranked summary. You will see each tool call appear as an expandable block in the chat so you can audit exactly what data was pulled.\n\n## High-impact VS Code workflows\n\nThe MCP integration becomes really powerful when you wire it into your normal engineering rituals. A few patterns Koji teams already run:\n\n### Writing PR descriptions backed by research\n\nOpen the diff for a PR, switch to Copilot Chat Agent mode, and prompt:\n\n> \"Read my changes and write a PR description. Pull customer quotes from the study `pricing-page-v2` to justify the change. Filter to interviews with quality score 4 or above.\"\n\nCopilot reads the diff, calls `koji_get_study_data` to fetch structured answers, calls `koji_get_transcript` for the highest-quality interviews, and writes a description that includes verbatim evidence. Reviewers love this because the \"why\" is no longer trust-me — it's quoted.\n\n### Spec'ing new features against real pain points\n\nWhen you start a new feature branch, ask Copilot to brief you:\n\n> \"Before I start on the new search feature, summarize the top 5 themes from my `search-pain-points` study and identify the structured answers where users rated discoverability below 3 on the scale question.\"\n\nThis works because Koji's MCP server returns per-question aggregations — averages, distributions, and option counts — so the AI can do real quantitative reasoning, not just text retrieval.\n\n### Closing the loop on bug reports\n\nWhen you fix a bug that came out of a customer interview, ask:\n\n> \"Create a Koji study called 'Search relevance fix follow-up' with the participants from my previous search study who reported issues. Use a hybrid interview mode with 4 questions about whether the new behavior fixed their problem.\"\n\nThis calls `koji_create_study` with a full StudyQuestion array — including the 6 structured question types Koji supports (open_ended, scale, single_choice, multiple_choice, ranking, yes_no) — and `koji_import_respondents` to seed the panel. Closed-loop research without leaving the editor.\n\n### Pre-deploy sentiment check\n\nBefore merging to main on a Friday, run:\n\n> \"Check my last 50 interviews across all studies for any new mentions of 'crash', 'freeze', or 'login'. List the top 5 most urgent.\"\n\nCopilot uses Koji's theme analysis output to scan recent interviews, surfacing anything that should block the release. This is the kind of safety net you cannot easily build without an MCP-style integration.\n\n## Sharing the config with your team\n\nOnce you have `.vscode/mcp.json` working, commit it to your repository. Every teammate who clones the repo will see the Koji server listed automatically in their Copilot Chat tools panel. They will each be prompted for their own API key on first use — the config file itself never contains a secret.\n\nSome teams add a one-line note to their `README.md`:\n\n> \"Open VS Code, run `Workspace: Add MCP Server` if Copilot Chat does not auto-detect, then paste your Koji API key when prompted. Get a key at app.koji.so/settings/api-keys.\"\n\nThis gets new hires productive in their first hour.\n\n## Configuring confirmation prompts for write tools\n\nKoji's MCP server includes 8 write tools — `koji_create_study`, `koji_update_brief`, `koji_publish_study`, `koji_generate_report`, `koji_publish_report`, `koji_configure_study`, `koji_export_data`, `koji_import_respondents`. You probably do not want Copilot calling these without your explicit approval.\n\nVS Code's MCP implementation shows a confirmation dialog for every tool call by default. You can adjust this in Settings under `chat.tools.autoApprove`. We recommend leaving auto-approve OFF for any tool whose name starts with `koji_create`, `koji_publish`, `koji_export`, or `koji_import`. Read tools (`koji_list_*`, `koji_get_*`) can usually be auto-approved safely.\n\n## Quick troubleshooting\n\n| Symptom | Likely cause | Fix |\n|---|---|---|\n| Red dot next to \"koji\" in Tools panel | Auth failed | Re-enter the API key — most often expired or wrong workspace |\n| Server starts but no tools listed | Old VS Code version | Update to 1.97 or later |\n| \"Connection refused\" or timeout | Corporate network blocks koji.so | Allow `koji.so` and `*.koji.so` in your proxy |\n| Tools listed but every call returns 401 | API key revoked | Generate a fresh key in Koji settings |\n| Tool call returns \"credit limit reached\" | Free plan credit cap hit on a write tool | Read tools never consume credits; upgrade plan only for high-volume study creation |\n\nFor a deeper troubleshooting walkthrough, see the dedicated MCP troubleshooting guide linked below.\n\n## Why this matters\n\nStatic surveys, screenshotted quotes, and stale PDF reports have always been the weakest part of customer research. They get out of sync the moment they're produced. The MCP integration is fundamentally different: the AI inside your editor reads live data every time you ask, filtered by Koji's quality gate (interviews scoring 3 or above) and structured by the same schema your research team designed. That makes the research durable — it can be referenced indefinitely without anyone updating a doc.\n\nFor engineering teams that want their code to actually match what customers said, the VS Code + Koji MCP setup is one of the highest-leverage 5-minute integrations available.\n\n## Related resources\n\n- [Connect Koji to Cursor (MCP)](/docs/mcp-setup-cursor) — equivalent setup for Cursor users\n- [Connect Koji to Claude (MCP)](/docs/mcp-setup-claude) — Claude Desktop config\n- [Koji MCP Tool Reference](/docs/mcp-tool-reference) — full list of 15 tools and their parameters\n- [MCP Troubleshooting Guide](/docs/mcp-troubleshooting) — fix common MCP connection and tool errors\n- [Koji Structured Questions Guide](/docs/structured-questions-guide) — the 6 question types your MCP queries can target\n- [MCP Authentication and Security](/docs/mcp-authentication-security) — best practices for protecting your API key\n- [MCP Best Practices](/docs/mcp-best-practices) — patterns that scale across teams\n","category":"Claude & MCP Integration","lastModified":"2026-05-20T03:22:55.301783+00:00","metaTitle":"Connect Koji to VS Code via MCP | Copilot Chat Setup Guide","metaDescription":"Step-by-step guide to connect Koji's MCP server to VS Code Copilot Chat Agent mode. Pull live customer interviews, transcripts, and structured answers into your editor without copy-pasting.","keywords":["koji mcp vscode","vscode mcp setup","copilot chat mcp","mcp configuration vscode","user research vscode","customer interviews in vscode","mcp.json","model context protocol vscode"],"aiSummary":"Connect the Koji MCP server to VS Code (1.97+) by adding a .vscode/mcp.json file with the Koji HTTP endpoint and a prompted API-key input. Once connected, GitHub Copilot Chat in Agent mode can call all 15 Koji tools — list studies, fetch interviews, pull transcripts, generate reports, and create new studies — directly inside the editor. This enables PR descriptions backed by verbatim customer quotes, spec writing against real pain points, closed-loop bug-fix follow-up studies, and pre-deploy sentiment checks. Configuration uses VS Code's secure input prompt so the API key never sits in the JSON file, making the config safe to commit to git.","aiPrerequisites":["VS Code 1.97 or later","GitHub Copilot subscription","A Koji account (Free tier works)","A Koji API key from Settings → API Keys"],"aiLearningOutcomes":["Create a .vscode/mcp.json file with the Koji MCP server block","Use VS Code's secure input prompt to keep your API key out of source control","Verify the connection by listing all 15 Koji MCP tools in Copilot Chat","Run high-impact workflows: research-backed PR descriptions, spec-against-pain, closed-loop follow-ups","Configure confirmation prompts so write tools require explicit approval","Share the MCP config with your team via git without exposing secrets"],"aiDifficulty":"intermediate","aiEstimatedTime":"8 min read"}],"pagination":{"total":1,"returned":1,"offset":0}}