{"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-18T12:58:33.503Z"},"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":"## Prerequisites\n\nBefore you start, make sure you have:\n\n1. **A Koji account** — [Sign up free](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/sse\"\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/sse`\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/sse`\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/sse`\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/sse`\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","category":"Claude & MCP Integration","lastModified":"2026-05-10T03:29:22.76554+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}}