The Vistaly MCP server is currently in early development. Features may change or break as we continue to improve the integration.

โ€‹
Features

  • ๐Ÿ” Search - Find relevant cards using natural language
  • ๐Ÿ“Š Metrics tracking - Update, track, and analyze import KPIs and outcomes
  • ๐Ÿ’ฌ Feedback & interviews - Send interviews and feedback to your Vistaly workspace
  • ๐Ÿ“š Documentation access - Browse comprehensive Vistaly documentation, API references, and best practices
  • ๐Ÿ” Secure authentication - Uses your Vistaly API key
  • ๐Ÿข Organization info - Access workspace and user details

โ€‹
Quick Start

โ€‹
1. Get Your API Key

First, youโ€™ll need to create an API key in your Vistaly workspace:
  1. Log into your Vistaly workspace at https://app.vistaly.com
  2. Go to Settings โ€“> API Keys
  3. Generate a new API key
API Keys
 NOTE: After you create an API Key, be sure to store it somewhere secure. You will not be able to access your secret key again, but you can always recreate an API Key at any time.

โ€‹
2. Configure Your AI Assistant

You can connect to Vistaly through various AI assistants:
  1. Open Claude Desktop
  2. Go to Settings
  3. Click on Connectors in the sidebar
  4. Click Add custom connector
  5. Enter a name: Vistaly
  6. Set the Remote MCP server URL to: https://vst_YOUR_API_KEY@api.vistaly.com/mcp
    • โš ๏ธ Replace vst_YOUR_API_KEY with your actual Vistaly API key
  7. Click Add

โ€‹
Option 2: Local NPM Package

Add the Vistaly MCP server to your Claude Desktop configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "vistaly": {
      "command": "npx",
      "args": ["-y", "@vistaly/mcp"],
      "env": {
        "VISTALY_API_KEY": "your-vistaly-api-key"
      }
    }
  }
}

โ€‹
3. Restart Your AI Assistant

After saving the configuration, restart your AI assistant (Claude Desktop or Claude Code) to load the new MCP server.
Your Vistaly MCP server will automatically update to the latest version when you open your LLM client. Close and reopen your client if you suspect youโ€™re missing new Vistaly MCP capabilities.

โ€‹
Example Prompts for Product Managers

Once connected, you can use these practical prompts to streamline your product management workflow:

โ€‹
๐Ÿ” Card Discovery & Research

What open opportunities are we tracking in Vistaly related to user onboarding?
Find all opportunities that have โ€˜Nowโ€™ or โ€˜Nextโ€™ statuses and list out all of the solutions we are exploring or building for those opportunities.

โ€‹
๐Ÿ“Š Metrics & Performance Tracking

Update the conversion rate KPI card to 5.8%

โ€‹
๐Ÿ’ฌ User Research & Feedback

Add the notes from this discovery call as an interview in Vistaly
Take the feedback shared in this sales call and add it to Vistaly

โ€‹
๐Ÿ“š Learning & Documentation

How should I think about structuring my Vistaly workspace?
  • Quick access to technical resources
  • Get clear definitions of key concepts
  • Perfect for when you need to understand integration options
  • Great for onboarding new team members or refreshing your knowledge

โ€‹
Available MCP Tools

The Vistaly MCP server provides access to these core capabilities:
  • Card Search: Semantic search across your product tree
  • Card Details: Get comprehensive card information
  • Comments: Access team discussions and decisions
  • Metrics: Submit and track KPI data points
  • Feedback: Capture user insights and research data
  • Interviews: Log customer research findings
  • Documentation: Access Vistaly guides and best practices
  • Health Check: Verify API connectivity

โ€‹
Troubleshooting

โ€‹
โ€API key requiredโ€ errors

  • Double-check your API key is correctly set in the Claude Desktop configuration
  • Make sure youโ€™ve restarted Claude Desktop after updating the config
  • Verify your API key is active in your Vistaly settings

โ€‹
Server connection issues

  • Ensure your Claude Desktop configuration file syntax is valid JSON
  • Check that the file path is correct for your operating system
  • Try restarting Claude Desktop completely
  • Verify Node.js 18 or higher is installed on your system

โ€‹
Authentication errors

  • Verify your API key is valid and hasnโ€™t expired
  • Check that the API key has necessary permissions in Vistaly
  • Ensure there are no extra spaces or characters in your API key

โ€‹
Whatโ€™s Next?

The Vistaly MCP server is actively being developed. Upcoming features include:
  • Card Creation: Create new cards directly from your AI assistant
  • Status Updates: Change card statuses and assignments
  • Advanced Analytics: Query complex metrics and trends
Stay tuned for updates and new capabilities!

โ€‹
Support

Need help? Check out: Looking for other ways to integrate with Vistaly?
  • Vistaly API - Direct API integration for custom workflows
  • Zapier - No-code automation with hundreds of tools
  • Slack - Team notifications and updates