LoginSign up

Use the Perspective AI MCP

Updated: May 8, 2026

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 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 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 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

MCP Token page showing Generate Token button

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

MCP Token page showing active token and configuration options

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:

FamilyExample toolsWhat they do
Workspaceworkspace_list, workspace_get, workspace_get_defaultFind the right workspace and inspect workspace details.
Perspective designperspective_create, perspective_respond, perspective_update, perspective_await_jobCreate a draft, answer design follow-ups, and revise an existing outline.
Deploymentperspective_get_preview_link, perspective_get_embed_optionsGenerate preview links, share/direct URLs, and embed snippets.
Resultsperspective_get_stats, perspective_list_conversations, perspective_get_conversation, perspective_get_conversationsInspect stats, browse responses, and pull summaries or transcripts for analysis.
Participantsparticipant_inviteCreate 48-hour magic links, reissue invite links, optionally send invite emails, and attach participant context.
Automationsautomation_list, automation_create, automation_update, automation_delete, automation_testManage per-interview and scheduled automations, then test delivery.
Integrationsintegration_manageList 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. For webhook payloads and retry behavior, see 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.