--- title: "Use the Perspective AI MCP" nav_title: "MCP Integration" description: "Connect Perspective to Claude Code, Cursor, VS Code, and other MCP clients via OAuth or a personal access token to create agents, analyze interviews, and deploy embeds directly from your AI assistant." date: "2026-05-08" tags: ["MCP server", "AI assistant integration", "Claude integration", "developer tools", "OAuth"] nav_order: 1 nav_display: true --- # Use the Perspective AI MCP Server The Perspective AI MCP (Model Context Protocol) Server connects your Perspective workspace to AI assistants like Claude Desktop, Claude Code, and Cursor. Once configured, you can create conversation agents, analyze interview data, and deploy embeds without leaving your development environment. ## What You Can Do With the MCP server connected, you can: - **Create conversation agents** directly in your AI assistant without switching to the Perspective dashboard - **Analyze interviews from a single outline** by pulling responses and insights into your current workflow - **Analyze interviews across multiple outlines** to identify patterns and themes across research projects - **Deploy embeds from your editor** by generating and inserting embed code directly into your codebase ## Prerequisites - A Perspective AI workspace - One of these AI assistants: - Claude.ai (web, with custom connector support) - Claude Desktop - Claude Code (command-line tool) - Cursor IDE - VS Code (with MCP support) ## Connect via OAuth OAuth is the recommended path: you add the Perspective MCP URL to your client, complete a one-time browser sign-in, and the client manages the connection from there. No tokens to copy, rotate, or store in config files. Every connected app shows up under **Connected Apps** in Settings, where you can revoke access anytime. Open the workspace switcher and choose **Manage workspace** to reach Settings. The MCP URL is the same for everyone: ``` https://getperspective.ai/mcp ``` ### Claude.ai (web) Open the [Add custom connector](https://claude.ai/settings/connectors?modal=add-custom-connector) dialog (or navigate manually: **Customize > Connectors > Add custom connector**) and fill in: - **Name**: `Perspective AI` - **Remote MCP server URL**: `https://getperspective.ai/mcp` Click **Add**, then complete OAuth in the browser when prompted. The connector becomes available to every chat in your workspace. See [Anthropic's custom connector guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) for details. ### Claude Code ```bash claude mcp add --transport http --scope user perspective https://getperspective.ai/mcp ``` The first time you call a Perspective tool, Claude Code opens a browser window to complete OAuth. `--scope user` makes Perspective available across all your projects — without it, Claude Code only loads the server in the directory where you ran the command. ### Claude Desktop Claude Desktop doesn't speak HTTP MCP natively. Use the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) shim, which handles the OAuth handshake in your browser. Add this to your Claude Desktop config file: ```json { "mcpServers": { "perspective": { "command": "npx", "args": ["mcp-remote", "https://getperspective.ai/mcp"] } } } ``` Restart Claude Desktop and trigger a Perspective request to start OAuth. ### Cursor Add this to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project): ```json { "mcpServers": { "perspective": { "type": "http", "url": "https://getperspective.ai/mcp" } } } ``` Trigger a Perspective request and complete the browser sign-in. ### VS Code Open **MCP: Open User Configuration** from the Command Palette to edit your user `mcp.json`, or create `.vscode/mcp.json` to share with your team: ```json { "servers": { "perspective": { "type": "http", "url": "https://getperspective.ai/mcp" } } } ``` VS Code uses `servers` at the top level, not `mcpServers`. Trigger a Perspective request and complete the browser sign-in. ### Other stdio-only clients For MCP clients that only speak stdio, use the `mcp-remote` shim. It discovers OAuth metadata automatically: ```json { "mcpServers": { "perspective": { "command": "npx", "args": ["mcp-remote", "https://getperspective.ai/mcp"] } } } ``` ## Connect with a Personal Access Token If your client doesn't support OAuth or you'd rather authenticate with a long-lived token, follow the steps below. ### 1. Generate Your MCP Token Open the profile menu at the bottom of the sidebar and choose **MCP**, or open the workspace switcher, choose **Manage workspace**, and select **MCP**. Click **Generate Token** to create a personal access token. ![MCP Token page showing Generate Token button](/images/generate-mcp-token.gif "screenshot") *Generate an access token to enable MCP integration.* Once generated, you'll see your token along with configuration details for each supported AI assistant. ![MCP Token page showing active token and configuration options](/images/ai-ide-options.png "screenshot") *Copy the configuration details for your AI assistant.* Personal MCP tokens work with the MCP endpoint and with the current REST create endpoint. OAuth access tokens are scoped to the remote MCP resource and should be used only with `/mcp`. ### 2. Configure Your AI Assistant #### Claude Code ```bash claude mcp add --transport http --scope user perspective https://getperspective.ai/mcp \ --header "Authorization: Bearer [your-token]" ``` `--scope user` makes Perspective available across all your projects. #### Claude Desktop Add this to your Claude Desktop config file: ```json { "mcpServers": { "perspective": { "command": "npx", "args": [ "mcp-remote", "https://getperspective.ai/mcp", "--header", "Authorization: Bearer [your-token]" ] } } } ``` #### Cursor Add this to `~/.cursor/mcp.json`: ```json { "mcpServers": { "perspective": { "type": "http", "url": "https://getperspective.ai/mcp", "headers": { "Authorization": "Bearer [your-token]" } } } } ``` #### VS Code Add this to your user `mcp.json` (Command Palette → **MCP: Open User Configuration**) or to `.vscode/mcp.json` in a project: ```json { "servers": { "perspective": { "type": "http", "url": "https://getperspective.ai/mcp", "headers": { "Authorization": "Bearer [your-token]" } } } } ``` ### 3. Verify the Connection Open your AI assistant and try a Perspective-related request, such as "Create a new interview outline for user feedback on our pricing page." If configured correctly, your assistant will connect to Perspective and execute the request. ## Tool Coverage The MCP server exposes tools across the same product areas you use in the dashboard: | Family | Example tools | What they do | |--------|---------------|--------------| | Workspace | `workspace_list`, `workspace_get`, `workspace_get_default` | Find the right workspace and inspect workspace details. | | Perspective design | `perspective_create`, `perspective_respond`, `perspective_update`, `perspective_await_job` | Create a draft, answer design follow-ups, and revise an existing outline. | | Deployment | `perspective_get_preview_link`, `perspective_get_embed_options` | Generate preview links, share/direct URLs, and embed snippets. | | Results | `perspective_get_stats`, `perspective_list_conversations`, `perspective_get_conversation`, `perspective_get_conversations` | Inspect stats, browse responses, and pull summaries or transcripts for analysis. | | Participants | `participant_invite` | Create 48-hour magic links, reissue invite links, optionally send invite emails, and attach participant context. | | Automations | `automation_list`, `automation_create`, `automation_update`, `automation_delete`, `automation_test` | Manage per-interview and scheduled automations, then test delivery. | | Integrations | `integration_manage` | List connected providers, open setup URLs, and discover Slack, HubSpot, or Gmail tool slugs for automation channels. | For embed-specific implementation details, see the [Embed API Reference](/docs/build/embed-api). For webhook payloads and retry behavior, see [Webhooks](/docs/build/webhooks). ## Example Workflows **Create a conversation agent from your IDE:** Ask your AI assistant: "Create a new interview outline for customer discovery on our mobile app usage patterns." **Analyze interviews during development:** Ask: "Pull all responses from the Q3 user research outline and summarize the top pain points." **Compare across research projects:** Ask: "Analyze interviews from both the onboarding outline and the pricing outline. What themes appear in both?" **Deploy an embed while coding:** Ask: "Generate the inline embed code for the product feedback outline and add it to the pricing page component." ## Best Practices - **Keep tokens secure**: Treat your MCP token like a password. Rotate it if you suspect it's been compromised. - **Use specific outline names**: When referencing outlines in requests, use exact names to ensure your assistant accesses the correct data. - **Test with simple requests first**: Verify the connection works by creating a test outline or fetching a single interview before running complex analysis. ## Common Pitfalls & Fixes ### AI assistant returns "unable to connect to Perspective" Verify the token is active on the MCP settings page. Check that you copied the full authorization header including the `Bearer` prefix. ### Assistant creates duplicate outlines Be specific in your requests. Instead of "create an outline," say "check if an outline named [name] exists, and if not, create it." ### Token shows "Never" under "Last used" This updates after the first successful request authenticated with a personal MCP token. OAuth-connected clients appear under **Connected Apps** in Settings instead.