{"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-11-08T20:14:44.929Z"},"content":[{"type":"documentation","id":"e7d042a6-1597-40d7-8b75-63a4e8f1cb58","slug":"mcp-setup-cursor","title":"Connect Koji to Cursor: MCP Setup Guide for Product Engineers","url":"https://www.koji.so/docs/mcp-setup-cursor","summary":"Connect the Koji MCP server to Cursor (0.45+) by adding a single block to ~/.cursor/mcp.json with a bearer token. Once connected, Cursor can call all 15 Koji MCP tools — listing studies, pulling transcripts, fetching structured answers, generating reports, and even creating new studies — directly from any chat or Composer session. This brings live customer evidence into the editor for spec writing, ticket grooming, pre-deploy sentiment checks, and stakeholder report generation, with no copy-pasting and full quality-gate filtering.","content":"Cursor's Model Context Protocol (MCP) support turns the editor into a research-aware coding environment. Connect Koji's MCP server to Cursor and your AI assistant can read live customer interview transcripts, structured answers, themes, quality scores and full study reports, without copy-pasting a single quote. The quickest way in is the **Add to Cursor** button inside Koji: click it, click Install in Cursor, then approve access in your browser. There is no API key to paste. The MCP connector is included on the Interviews and Enterprise plans.\n\nThis guide walks through both setup paths, the most useful Koji and Cursor workflows, and what to check when something doesn't connect.\n\n## Why Connect Koji to Cursor\n\nMost teams already use Cursor to write code. Most teams also have customer feedback scattered across Slack threads, Notion docs, and a forgotten interview tool. The MCP integration closes that gap: Cursor can query your Koji workspace the same way it queries the filesystem.\n\nConcretely, this gives product engineers four high-value workflows:\n\n- **Context-aware feature work.** Before adding a new onboarding step, ask Cursor \"what did the last 20 interview participants say about onboarding friction?\" and it pulls the actual quotes.\n- **PRDs grounded in evidence.** Generate a one-page spec that cites real interview transcripts instead of speculative bullet points.\n- **Triage with proof.** When grooming the backlog, Cursor can rank tickets against the themes appearing most frequently in published Koji reports.\n- **Post-launch sense-check.** After shipping, ask Cursor to summarise interviews collected since the deploy and flag shifts in sentiment or quality scores.\n\nSurvey tools like SurveyMonkey, Typeform, and Qualtrics expect you to log into a separate dashboard to read results. Koji's MCP server brings the data to where engineers already work.\n\n## Prerequisites\n\nBefore you start, make sure you have:\n\n- **A Koji account on the Interviews or Enterprise plan.** The MCP connector counts as API access, which is part of those two plans. On Free and Insights, Koji refuses the sign-in. See the [Plan Comparison Guide](/docs/plan-comparison-guide).\n- **A recent version of Cursor** with support for remote MCP servers and OAuth sign-in. If Cursor doesn't offer to sign in when you add the server, update it first.\n- **A Koji workspace with at least one study** and a few completed interviews, so there is something to query.\n- **A browser** for the one-time sign-in.\n\nYou don't need an API key. Koji's MCP server accepts only OAuth 2.1 sign-in: Cursor opens your browser, you sign in to Koji and approve the connection, and Cursor stores and refreshes the token for you. API keys from **Settings → API Keys** are for the REST Headless API, and the MCP server does not accept them.\n\n## Option 1: Add Koji from inside Koji (recommended)\n\n1. In Koji, open the **Connect your AI** row at the foot of the sidebar (or the **Use Koji inside ChatGPT or Claude** card on your dashboard, if it is still showing).\n2. In the **Use Koji in your AI app** dialog, pick the **Cursor** tab and click **Add to Cursor**.\n3. Your browser hands off to Cursor, which shows its install prompt with the Koji server filled in. Click **Install**.\n4. Cursor opens a Koji consent page in your browser. Sign in if asked, review the permissions, and approve.\n\nThe button opens Cursor's own install link, so it works the same on macOS, Windows and Linux. If Cursor isn't installed on the machine you clicked from, you'll see a web page instead of the install prompt.\n\n## Option 2: Add the server to mcp.json by hand\n\nUse this path when you want the config in version control, or when the install link can't reach Cursor (a remote or locked-down machine).\n\nCursor stores MCP server definitions in a JSON file:\n\n- Global, for every project: `~/.cursor/mcp.json` on macOS and Linux, `%USERPROFILE%\\.cursor\\mcp.json` on Windows\n- Per project: `.cursor/mcp.json` in the repository root\n\nYou can also open the global config from **Cursor Settings → MCP**. Add Koji to the `mcpServers` object:\n\n```json\n{\n  \"mcpServers\": {\n    \"koji\": {\n      \"url\": \"https://www.koji.so/api/mcp/mcp\"\n    }\n  }\n}\n```\n\nThat is the whole entry. There is no `headers` block and no secret in the file, so a project-level `.cursor/mcp.json` is safe to commit. If you already have other MCP servers configured (GitHub, Linear, filesystem), add the `koji` entry alongside them rather than replacing the file.\n\nSave the file. In **Cursor Settings → MCP**, the `koji` server appears with a prompt to sign in or connect. Click it, approve access on the Koji consent page in your browser, and the server's status turns active with its tools listed.\n\n### What the consent page asks for\n\nThe Koji consent page lists each permission in plain words: reading your studies, interviews and account, and, if the client asks for them, creating and publishing studies, generating and publishing reports, and adding respondents. Write tools only appear in Cursor when you approved the matching permission. Tokens refresh automatically, so you won't be asked to sign in again every session.\n\n## Step 3: Verify the Connection\n\nOpen a new chat in Cursor (Cmd/Ctrl + L) in Agent mode and type:\n\n```\nList my Koji studies and tell me which one has the most completed interviews.\n```\n\nCursor should call `koji_list_studies` and return your study titles, statuses and interview counts. Cursor asks before running each tool unless you've turned on auto-run.\n\nFor a deeper smoke test, try:\n\n```\nSummarise the most common themes from my most recent Koji study.\n```\n\nThis chains `koji_list_studies`, `koji_get_study` and `koji_get_interviews`. The model picks the right tool for each step, so you don't need to name them. See [MCP Tool Reference](/docs/mcp-tool-reference) for the full list.\n\n## The Koji Tools You Now Have in Cursor\n\nOnce connected, Cursor can call any tool the Koji MCP server exposes:\n\n**Read tools:** `koji_list_studies`, `koji_get_study`, `koji_get_interviews`, `koji_get_transcript`, `koji_get_account`, `koji_get_study_data`, `koji_get_report`, `koji_export_data`\n\n**Write tools:** `koji_create_study`, `koji_update_brief`, `koji_publish_study`, `koji_configure_study`, `koji_generate_report`, `koji_publish_report`, `koji_import_respondents`\n\nThe read tools are safe to call freely. The write tools change your workspace, so keep Cursor's tool approval on for them. See [MCP Authentication and Security](/docs/mcp-authentication-security).\n\n## Recommended Cursor + Koji Workflows\n\nThe integration works best when you anchor it to a concrete coding task. Here are five patterns teams use from day one.\n\n### 1. Writing a feature spec from interview evidence\n\nOpen the spec doc and prompt Cursor:\n\n```\nDraft a one-page PRD for a new onboarding checklist. Cite at least\nfive direct quotes from the most recent onboarding study in Koji,\nand group user pain points by theme.\n```\n\nCursor fetches transcripts and structured answers, then writes the spec with the quotes inline. Structured answers come from Koji's question types (open ended, scale, single choice, multiple choice, ranking and yes/no). See [Structured Questions in AI Interviews](/docs/structured-questions-guide) for how those become chartable data the model can reason over.\n\n### 2. Ticket grooming with interview evidence\n\nOpen your `tickets/` folder in Agent mode and prompt:\n\n```\nFor each open ticket in this folder, score 1 to 5 how strongly the\nlast 30 days of Koji interviews support shipping it. Cite the\nthemes that match.\n```\n\nThe model walks each ticket, calls `koji_get_study_data` for per-question aggregations, and writes the score plus a short rationale into the ticket file.\n\n### 3. Pre-deploy check\n\nBefore merging, ask Cursor to scan recent interviews for complaints about the area you changed. Useful when you ship onboarding, pricing or auth changes, the surfaces participants comment on most.\n\n### 4. Generating a stakeholder summary\n\nAfter a study concludes, prompt:\n\n```\nGenerate a report for my latest Koji study, then publish it.\n```\n\nThis chains `koji_generate_report` and `koji_publish_report`. The published report link comes back in the chat, ready to paste into Slack. This is the same flow described in [Real-Time Research Insights](/docs/real-time-research-insights), driven from your editor.\n\n### 5. Creating a quick discovery study from a code TODO\n\nHighlight a `// TODO: validate this with users` comment, open chat, and prompt:\n\n```\nCreate a 5-minute Koji study to validate this assumption with\nmobile users. Use one open ended question and one scale question\nfor confidence.\n```\n\nCursor calls `koji_create_study` and can publish it with `koji_publish_study` once you approve, then hands back the interview link.\n\n## Troubleshooting\n\n**The Add to Cursor button opens a web page.** Cursor isn't installed on this machine, or the browser couldn't hand off to it. Use Option 2 instead.\n\n**Cursor never opens the sign-in page.** Update Cursor, then remove and re-add the server. Make sure your browser isn't blocking pop-ups from koji.so.\n\n**Sign-in completes but the server stays disconnected.** Your account isn't on a plan with API access. The MCP connector needs the Interviews or Enterprise plan.\n\n**Authentication errors after setup worked before.** Check your `mcp.json` for an old `headers` block with `Authorization: Bearer ...`. Older guides suggested an API key there; the MCP server doesn't accept API keys. Delete the `headers` block and sign in again.\n\n**Write tools are missing.** You approved read access only. Disconnect the server in Cursor Settings → MCP and connect again, approving the write permissions.\n\n**\"Tool not found\" errors.** Toggle the server off and on in Cursor Settings → MCP, and confirm the JSON is valid.\n\nFor more, see the [MCP Troubleshooting Guide](/docs/mcp-troubleshooting).\n\n## How This Compares to Pasting Transcripts\n\nSome teams still copy interview snippets into Cursor by hand. That works for a single decision but breaks down at scale: stale data, missing quality scores, and no way to filter by theme or sentiment.\n\nThe MCP integration fixes all three. Cursor sees the same data your researchers see in Koji, limited to the studies your account can access, with each interview's quality score attached so the model can weigh strong interviews over thin ones. See [Understanding Quality Scores](/docs/understanding-quality-scores).\n\n## Related Resources\n\n- [Koji MCP Integration Overview](/docs/mcp-overview)\n- [Connect Koji to Claude (Setup Guide)](/docs/mcp-setup-claude)\n- [Connect Koji to VS Code (Copilot Chat)](/docs/mcp-setup-vscode)\n- [MCP Tool Reference](/docs/mcp-tool-reference)\n- [MCP Authentication and Security](/docs/mcp-authentication-security)\n- [MCP Best Practices](/docs/mcp-best-practices)\n- [Structured Questions in AI Interviews](/docs/structured-questions-guide)\n\n## Further reading on the blog\n\n- [B2B Customer Research: The Complete Guide for Product Teams (2026)](/blog/b2b-customer-research-guide-2026) — B2B customer research is harder than B2C — you are navigating buying groups of 10+ stakeholders, gatekeepers, and enterprise procurement cyc\n- [Best Product Discovery Tools in 2026: The Complete Buyer's Guide](/blog/best-product-discovery-tools-2026) — Product discovery is no longer a one-off pre-launch phase — it is a continuous loop. The best teams in 2026 are running weekly customer inte\n- [Concept Testing: The Complete Guide for Product Teams (2026)](/blog/concept-testing-guide-2026) — Concept testing validates whether your idea is worth building before you build it. This guide covers methods, question templates, analysis a\n\n<!-- further-reading:blog -->\n\n\n---\n\n<!-- crosslink:dev-hub -->\n## Related: other ways to connect\n\nThe [Developer Hub](/docs/building-with-ai) is the single starting point for every way to connect to Koji: the MCP server (this section), the REST Headless API, and the embed widget. For a code integration, see [API Authentication](/docs/api-authentication) and [Starting Interviews via API](/docs/starting-interviews-via-api).","category":"Claude & MCP Integration","lastModified":"2026-11-03T05:10:40.827442+00:00","metaTitle":"Connect Koji to Cursor: MCP Setup Guide (5 Minutes)","metaDescription":"Step-by-step guide to connect Koji to Cursor via MCP so engineers can pull live customer interview insights, transcripts, and themes directly into the editor.","keywords":["cursor mcp","koji mcp cursor","cursor user research","mcp ide research","cursor ai customer feedback","mcp setup cursor"],"aiSummary":"Connect the Koji MCP server to Cursor (0.45+) by adding a single block to ~/.cursor/mcp.json with a bearer token. Once connected, Cursor can call all 15 Koji MCP tools — listing studies, pulling transcripts, fetching structured answers, generating reports, and even creating new studies — directly from any chat or Composer session. This brings live customer evidence into the editor for spec writing, ticket grooming, pre-deploy sentiment checks, and stakeholder report generation, with no copy-pasting and full quality-gate filtering.","aiPrerequisites":["Koji workspace with at least one published study","Cursor 0.45 or later installed","A Koji API key generated from Settings"],"aiLearningOutcomes":["Add the Koji MCP server to Cursor in under 5 minutes","Verify the connection with a smoke-test query","Use all 15 Koji tools (read and write) inside Cursor chat and Composer","Run 5 production workflows: PRD writing, ticket grooming, regression checks, report generation, study creation","Troubleshoot auth, tool selection, and rate-limit issues"],"aiDifficulty":"beginner","aiEstimatedTime":"5 min read"}],"pagination":{"total":1,"returned":1,"offset":0}}