Model Context Protocol (MCP)
Connect AI assistants like Claude Desktop to your Vistaly workspace
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:
- Log into your Vistaly workspace at https://app.vistaly.com
- Go to
Settings
โ>API Keys
- 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
3. Restart Claude Desktop
After saving the configuration, restart Claude Desktop 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:
- ๐ฆ 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