Koji MCP Integration Overview
Connect Koji to Claude, Cursor, and other AI assistants using the Model Context Protocol (MCP). Manage your entire research workflow conversationally — create studies, run interviews, analyze data, and generate reports without leaving your AI assistant.
What is the Koji MCP Integration?
The Koji MCP integration lets you connect your AI-powered research platform directly to Claude, Cursor, Windsurf, and any AI assistant that supports the Model Context Protocol (MCP). Instead of switching between tabs, you manage your entire qualitative research workflow through natural conversation.
Think of it as giving Claude direct access to your Koji account. You can say things like:
- "Create a new customer discovery study about why users churn after onboarding"
- "Show me the interviews from my pricing research study"
- "Generate a report from my latest interviews and publish it for my team"
- "Import these 200 customer contacts and create personalized interview links"
All without leaving your AI assistant.
Why Use MCP Instead of the Dashboard?
The Koji dashboard gives you full visual control. MCP gives you speed and automation. Here is when each makes sense:
| Scenario | Dashboard | MCP via Claude |
|---|---|---|
| Browse studies visually | ✅ Best | Good |
| Create a study from a brief | Good | ✅ Best — Claude helps craft methodology |
| Read individual transcripts | ✅ Best | Good |
| Cross-analyze multiple interviews | Manual | ✅ Best — Claude synthesizes patterns |
| Generate and iterate on reports | Good | ✅ Best — conversational refinement |
| Bulk import respondents | Good | ✅ Best — natural language input |
| Customize branding in detail | ✅ Best | Good |
| Quick status check | Requires login | ✅ Best — one question |
The real power is combining Claude's reasoning with your research data. Claude does not just read your data — it can create studies using proven research methodologies, help you refine interview questions, cross-reference findings across studies, and generate shareable reports.
What Can You Do?
17 Tools Across 5 Categories
The Koji MCP server exposes 17 tools organized into logical groups:
📖 Read & Explore (5 tools)
| Tool | What It Does |
|---|---|
koji_list_studies | List all your studies with status, interview counts, and completion metrics |
koji_get_study | Get full study details including research brief, methodology, and interview data |
koji_get_interviews | List interviews with AI-generated summaries, themes, and sentiment |
koji_get_transcript | Read full interview transcripts with respondent context |
koji_get_account | Check your plan, usage limits, and available features |
✏️ Create & Publish (2 tools)
| Tool | What It Does |
|---|---|
koji_create_study | Create a new study with AI-generated research brief and methodology framework |
koji_publish_study | Make a draft study live — sets up AI interviewer, generates interview link |
📊 Analyze & Report (4 tools)
| Tool | What It Does |
|---|---|
koji_get_study_data | Get structured interview data with aggregated themes and sentiment |
koji_generate_report | Generate a comprehensive AI research report from interview data |
koji_get_report | Retrieve report sections — executive summary, themes, recommendations |
koji_publish_report | Publish report with a shareable public link for stakeholders |
🎨 Customize (4 tools)
| Tool | What It Does |
|---|---|
koji_customize_intake | Customize the interview landing page — headline, branding, badges |
koji_configure_lead_form | Set up pre-interview forms to collect respondent information |
koji_update_settings | Configure voice/text modes and link preview metadata |
koji_set_interview_slug | Set a custom URL for your interview link |
📤 Distribute (2 tools)
| Tool | What It Does |
|---|---|
koji_export_data | Export study data as structured JSON for external analysis |
koji_import_respondents | Import contacts with personalized interview URLs for outreach |
Supported AI Assistants
The Koji MCP server works with any client that supports the Model Context Protocol:
- Claude Desktop — Anthropic's desktop app (recommended)
- Claude.ai — Browser-based Claude with MCP support
- Cursor — AI-powered code editor
- Windsurf — AI development environment
- Any MCP-compatible client — The protocol is an open standard
Plan Requirements
MCP access works on all plans, but some tools require specific tiers:
| Feature | Free | Starter | Growth | Scale |
|---|---|---|---|---|
| Read studies, interviews, transcripts | ✅ | ✅ | ✅ | ✅ |
| Create studies | 1 study | 3 studies | 10 studies | Unlimited |
| Generate reports | ❌ | 3 per study | Unlimited | Unlimited |
| Voice interviews | ❌ | ❌ | ✅ | ✅ |
| Custom branding | ❌ | ❌ | ✅ | ✅ |
| Lead forms | ❌ | ❌ | ✅ | ✅ |
| Import respondents | ❌ | ❌ | ❌ | ✅ |
| Remove "Powered by Koji" | ❌ | ❌ | ❌ | ✅ |
| Custom OG previews | ❌ | ❌ | ❌ | ✅ |
Security & Privacy
- OAuth 2.1 with PKCE — Industry-standard secure authentication. No API keys stored in config files.
- Scoped access — MCP only accesses your studies, interviews, and account data.
- No training data — Your research data is never used to train AI models.
- Token rotation — Access tokens expire every hour with automatic refresh.
- Revocable — Disconnect any time from your Koji account settings.
Next Steps
- Set up the connection — Connect Koji to Claude in under 2 minutes
- Explore the tool reference — Detailed docs for all 17 tools
- Follow a workflow guide — End-to-end examples for your role
Related Articles
Connect Koji to Claude (Setup Guide)
Step-by-step guide to connect your Koji account to Claude Desktop, Claude.ai, Cursor, and other MCP clients. Takes under 2 minutes with OAuth — no API keys required.
MCP Tool Reference — All 17 Tools
Complete reference for all 17 Koji MCP tools. Includes parameters, return data, plan requirements, and example prompts for each tool across read, create, analyze, customize, and distribute categories.
MCP Workflow Guide for Product Managers
End-to-end guide for product managers using Koji MCP with Claude to automate customer discovery, validate hypotheses, and generate stakeholder-ready research reports — all from a single conversation.
MCP Workflow Guide for UX Researchers
How UX researchers use Koji MCP with Claude to scale qualitative research. Manage multiple studies, analyze transcripts across projects, generate themed reports, and maintain a living research repository.
MCP Workflow Guide for Founders & GTM Teams
How founders and go-to-market teams use Koji MCP with Claude to validate markets, qualify leads through research conversations, and build evidence-based positioning — all without hiring a dedicated researcher.
MCP Authentication & Security
How Koji MCP authenticates with OAuth 2.1 and PKCE. Covers the authorization flow, token lifecycle, security model, data privacy, and how to revoke access.