Model Context Protocol (MCP)

​

Features

• 🔍 Smart card search - Find relevant cards using natural language
• 📊 Metrics tracking - Submit and track KPI data points
• 💬 Feedback & interviews - Capture user insights and research data
• 🏢 Organization info - Access workspace and user details
• 📚 Documentation access - Browse comprehensive Vistaly documentation, API references, and best practices
• 🔐 Secure authentication - Uses your Vistaly API key

​

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 your Settings
3. Generate a new API key

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

Add the Vistaly MCP server to your Claude Desktop configuration:

• 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 Claude Desktop

After saving the configuration, restart Claude Desktop to load the new MCP server.

​

Example Prompts for Product Managers

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

​

🔍 Card Discovery & Research

“Find all experiments related to user onboarding”

• Quickly discover related work across your product tree
• Perfect for understanding what’s been tried before

“Show me all opportunity cards that are ‘now’ status”

• Get a clear view of your current focus areas
• Helps with sprint planning and prioritization

“Search for cards about checkout flow performance”

• Find metrics, experiments, and feedback related to specific features
• Great for preparing performance reviews or retrospectives

​

📊 Metrics & Performance Tracking

“Add a conversion rate of 2.3% for the signup flow card”

• Quickly log KPI data without leaving your workflow
• Perfect for real-time metric tracking during reviews

​

💬 User Research & Feedback

“Record user feedback: ‘The new dashboard is confusing, especially the navigation menu’”

• Capture insights from user interviews instantly
• Links feedback directly to your product discovery process

“Log this interview in Vistaly”*

• Automatically push interviews in your LLM projects into your Vistaly workspace.
• Keeps research insights organized and accessible

​

📋 Project Management & Planning

“Get details for the mobile app redesign card”

• Quick access to card information without switching tools
• Perfect for status updates and planning discussions

“Show me comments on the pricing strategy card”

• Review team discussions and decisions
• Helpful for understanding context and rationale

​

📚 Learning & Documentation

“Show me the Vistaly API documentation”

• Quick access to technical resources
• Perfect for when you need to understand integration options

“What are Opportunity Solution Trees and how do I use them?”

• Access product management best practices
• Great for onboarding new team members or refreshing your knowledge

“Explain the difference between outcomes and outputs”

• Get clear definitions of key concepts
• Useful for team discussions and strategic planning

​

Advanced Use Cases

​

Weekly Standup Preparation

"Find all cards I'm assigned to that have been updated in the last week"

​

Quarterly Business Review Data

"Show me metrics for all KPI cards from the last quarter"

​

Feature Launch Analysis

"Search for feedback and metrics related to our new notification system"

​

Customer Interview Synthesis

"Record interview findings: 3 out of 5 users struggled with the onboarding flow, specifically the account verification step"

​

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:

• 📦 NPM Package: @vistaly/mcp
• 🔌 MCP Documentation: modelcontextprotocol.io
• 🛠 API Reference: Available here
• 📧 Support: support@vistaly.com

​

Related Integrations

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