{"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-17T01:20:29.076Z"},"content":[{"type":"documentation","id":"c0315d62-26a5-4bde-aad0-290a8f08a2ea","slug":"mcp-setup-claude","title":"Connect Koji to Claude (Setup Guide)","url":"https://www.koji.so/docs/mcp-setup-claude","summary":"Step-by-step tutorial for connecting Koji to Claude Desktop and other MCP clients. Covers configuration, OAuth 2.1 authorization, verification, and troubleshooting. Setup takes under 2 minutes with no API keys required. Includes examples for Claude Desktop, Claude.ai, Cursor, and generic MCP clients.","content":"## The fastest way: Add to Claude from inside Koji\n\nConnecting Koji to Claude takes about a minute from inside the app, with nothing to copy or paste. It works for Claude on the web, Claude Desktop and the Claude mobile apps, which share the same connectors.\n\n1. In Koji, open the setup dialog in one of two places: the **Use Koji inside ChatGPT or Claude** card on your dashboard, or **Connect your AI** at the foot of the sidebar.\n2. In the **Use Koji in your AI app** dialog, choose the **Claude** tab and click **Add to Claude**.\n3. Claude opens its **Add custom connector** form with the name (Koji) and the server URL already filled in. Check them, click **Add**, then **Connect**.\n4. A Koji page opens asking you to approve access. Approve it, and you are back in Claude with Koji connected.\n\nThe link only fills in the form. Nothing is added until you click Add yourself, and Claude asks you to sign in first if you are signed out.\n\nUsing Claude Code in the terminal? The same Claude tab has a **Using Claude Code?** section with a command to copy. Run it, then type `/mcp` in Claude Code to sign in. See [Connect Koji to Claude Code](/docs/mcp-setup-claude-code) for details.\n\nThe manual steps below still work, and are the fallback if you prefer to add the server yourself or use another MCP client.\n\nThe Koji connection for AI apps is included on the **Interviews** and **Enterprise** plans.\n\n---\n\n## Prerequisites\n\nBefore you start, make sure you have:\n\n1. **A Koji account on the Interviews or Enterprise plan**: [sign up](https://www.koji.so) if you do not have one\n2. **Claude Desktop** (recommended) or another MCP-compatible client\n3. **An active internet connection** — OAuth requires connecting to koji.so\n\n---\n\n## Option 1: Connect via Claude Desktop (Recommended)\n\nClaude Desktop has built-in MCP support. Here is how to connect:\n\n### Step 1: Open Claude Desktop Settings\n\n1. Open Claude Desktop\n2. Click your profile icon in the bottom left\n3. Select **Settings** then **Integrations** (or **Developer** then **MCP Servers** on older versions)\n\n### Step 2: Add Koji as an MCP Server\n\nClick **\"Add MCP Server\"** or **\"Edit Config\"** and add the following configuration:\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 entire configuration. No API keys, no environment variables.\n\n### Step 3: Authorize Your Account\n\n1. Save the configuration and restart Claude Desktop\n2. Claude will show a Koji connection prompt\n3. Click **Connect** — this opens your browser\n4. Sign into your Koji account (if not already signed in)\n5. Click **Authorize** to grant Claude access\n6. You will be redirected back — the connection is now active\n\n### Step 4: Verify the Connection\n\nIn a new Claude conversation, type:\n\n> \"List my Koji studies\"\n\nIf you see your studies (or a message that you have no studies yet), the connection is working.\n\n---\n\n## Option 2: Connect via Claude.ai (Browser)\n\nClaude.ai supports MCP integrations through its web interface:\n\n1. Go to [claude.ai](https://claude.ai)\n2. Navigate to **Settings** then **Integrations**\n3. Search for **Koji** or add a custom MCP server\n4. Enter the server URL: `https://www.koji.so/api/mcp/mcp`\n5. Complete the OAuth authorization flow\n6. Start using Koji tools in any conversation\n\n---\n\n## Option 3: Connect via Cursor\n\nCursor supports MCP servers for AI-assisted development:\n\n1. Open Cursor Settings\n2. Go to **MCP Servers**\n3. Click **Add Server**\n4. Enter:\n   - **Name**: Koji\n   - **URL**: `https://www.koji.so/api/mcp/mcp`\n5. Save and authorize when prompted\n\n---\n\n## Option 4: Connect via Any MCP Client\n\nFor any client that supports the Model Context Protocol:\n\n- **Server URL**: `https://www.koji.so/api/mcp/mcp`\n- **Transport**: Streamable HTTP (SSE)\n- **Authentication**: OAuth 2.1 with PKCE (auto-discovered via `/.well-known/oauth-authorization-server`)\n- **Scopes**: `read:studies`, `read:interviews`, `read:account`\n\nThe server supports [OAuth 2.0 Authorization Server Discovery (RFC 8414)](https://www.rfc-editor.org/rfc/rfc8414) and [Dynamic Client Registration (RFC 7591)](https://www.rfc-editor.org/rfc/rfc7591), so compatible clients will auto-configure.\n\n---\n\n## Troubleshooting\n\n### \"Authentication required\" errors\n\nYour OAuth token may have expired. Most MCP clients auto-refresh, but if not:\n1. Remove the Koji server from your client\n2. Re-add it and re-authorize\n\n### Connection timeout\n\nMake sure you can reach `https://www.koji.so` in your browser. If you are behind a corporate firewall, you may need to allowlist the domain.\n\n### \"Study not found\" errors\n\nMCP only shows studies owned by the authenticated account. Make sure you are signed into the correct Koji account.\n\n### Claude does not show Koji tools\n\n1. Verify the server URL is exactly `https://www.koji.so/api/mcp/mcp`\n2. Restart Claude Desktop after adding the configuration\n3. Check that the OAuth authorization completed successfully\n\n---\n\n## What to Try First\n\nOnce connected, try these commands to explore your account:\n\n```\n\"What studies do I have in Koji?\"\n\n\"Show me my account details and plan\"\n\n\"Create a new customer discovery study about why enterprise users need single sign-on\"\n\n\"Create a study with an NPS question (0-10 scale) and 3 open-ended questions about onboarding experience\"\n```\n\n---\n\n## Disconnecting\n\nTo revoke Koji's access:\n\n1. Go to your [Koji account settings](https://www.koji.so/dashboard/profile)\n2. Find the **Connected Apps** section\n3. Click **Revoke** next to the Claude connection\n\nThis immediately invalidates all tokens. You can reconnect at any time by repeating the setup process.\n\n---\n\n## Next Steps\n\n- **[Tool Reference](/docs/mcp-tool-reference)** — Learn what each of the 15 tools does\n- **[MCP Overview](/docs/mcp-overview)** — Understand the full integration\n- **[Product Manager Workflow](/docs/mcp-workflow-product-managers)** — End-to-end guide for PMs\n- **[Best Practices](/docs/mcp-best-practices)** — Tips for getting the most out of MCP\n- **[Authentication and Security](/docs/mcp-authentication-security)** — How OAuth 2.1 keeps your data safe\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).\n","category":"Claude & MCP Integration","lastModified":"2026-11-08T05:12:13.54368+00:00","metaTitle":"Connect Koji to Claude — MCP Setup Guide | Koji Documentation","metaDescription":"Step-by-step guide to connect Koji to Claude Desktop, Cursor, and other MCP clients. OAuth 2.1 setup in under 2 minutes — no API keys required. Includes troubleshooting tips.","keywords":["Koji Claude setup","MCP setup guide","connect Koji to Claude","Claude MCP server","AI research Claude integration","MCP OAuth setup","Claude Desktop MCP","Cursor MCP server","Koji AI assistant setup"],"aiSummary":"Step-by-step tutorial for connecting Koji to Claude Desktop and other MCP clients. Covers configuration, OAuth 2.1 authorization, verification, and troubleshooting. Setup takes under 2 minutes with no API keys required. Includes examples for Claude Desktop, Claude.ai, Cursor, and generic MCP clients.","aiPrerequisites":["A Koji account","Claude Desktop or another MCP-compatible client"],"aiLearningOutcomes":["Connect Koji to Claude Desktop","Configure MCP in Cursor and other clients","Complete OAuth authorization flow","Troubleshoot common connection issues","Verify the integration is working"],"aiDifficulty":"beginner","aiEstimatedTime":"5 minutes"}],"pagination":{"total":1,"returned":1,"offset":0}}