DTCMVP MCP Server for Claude Desktop

Access your DTCMVP meeting data directly in Claude Desktop with role-based access control! Partner users see their own data, admin users see cross-partner insights.

🎯 Super Quick Start (2 steps!)

1. Run the Installer

Open your terminal and run:

npx @dtcmvp/mcp-server-install

The installer will:

• Prompt you for your API key (get one at dtcmvpete.com → Settings → API Keys)
• Automatically configure Claude Desktop for you
• Set up everything needed!

2. Restart Claude Desktop

1. Quit Claude Desktop completely (don't just close the window)
2. Reopen Claude Desktop
3. You're done! 🎉

Manual Installation (if you prefer)

If you want to configure Claude Desktop manually:

macOS: Edit ~/Library/Application Support/Claude/claude_desktop_config.json Windows: Edit %APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "dtcmvp": {
      "command": "npx",
      "args": ["-y", "@dtcmvp/mcp-server"],
      "env": {
        "DTCMVP_API_KEY": "dtc_your_api_key_here"
      }
    }
  }
}

Then restart Claude Desktop.

✅ Verify It's Working

In Claude Desktop, try asking:

What meetings do I have access to?

Claude should use the DTCMVP tools and show your partner's meetings!

🛠️ Available Tools

The tools you see depend on your role:

Partner Users (11 tools)

Transcript Tools (2)

• get_compressed_transcripts - Get compressed transcripts (~6000 tokens each)
• get_full_transcript - Get full original transcript (~6500 tokens)

Anonymized Data Tools (6) - Your partner's anonymized data only

• get_anonymized_pain_points - Pain points with NO identifying info
• get_anonymized_summaries - Summaries with NO identifying info
• get_anonymized_quotes - Quotes with NO identifying info
• search_anonymized_pain_points - Search pain points (anonymized)
• get_anonymized_stats - Statistics about anonymized data
• get_anonymized_meeting_metadata - Meeting metadata (anonymized)

Partner-Specific Tools (3)

• get_partner_meetings - List your partner's meetings (25 per page)
• get_meeting_summaries - Get extractive summaries (~2100 tokens each)
• get_meeting_stats - Get statistics about your meetings

Admin Users (13 tools)

Transcript Tools (2) - Same as partner users

• get_compressed_transcripts
• get_full_transcript

Anonymized Data Tools (6) - ALL partners' anonymized data

• get_anonymized_pain_points
• get_anonymized_summaries
• get_anonymized_quotes
• search_anonymized_pain_points
• get_anonymized_stats
• get_anonymized_meeting_metadata

Admin-Only Cross-Partner Tools (5)

• list_all_meetings - Get ALL meetings across all partners with filters
• get_all_insights - Get ALL insights (pain points, summaries, quotes) across partners
• search_meetings - Search ALL meetings across all partners
• get_meeting_insights - Get specific meeting insights by Airtable ID
• get_partner_summary - Get aggregated summary data for a specific partner

💡 Example Usage

Partner Users

Analyze Recent Meetings

Show me my most recent 10 meetings and summarize the key pain points

Create LinkedIn Post

Based on my anonymized pain points, create a LinkedIn post about common DTC challenges

Get Meeting Statistics

What are the statistics for my meetings this month?

Admin Users

Cross-Partner Analysis

Show me all meetings from the last 30 days across all partners

Partner Comparison

Compare pain points across different partners - which issues are most common?

Search All Meetings

Search all meetings across partners for discussions about "attribution"

Partner Summary

Give me a summary of all data for partner XYZ

🐛 Troubleshooting

"API key authentication failed"

• Check your API key is correct
• Regenerate a new key in the web app
• Make sure there are no extra spaces

Tools not appearing in Claude Desktop

• Restart Claude Desktop completely (Quit, not just close window)
• Check your config file syntax is valid JSON
• Look at Claude Desktop logs:
  • macOS: ~/Library/Logs/Claude/mcp*.log
  • Windows: %APPDATA%\Claude\logs\mcp*.log

"WebSocket connection failed"

• Check your internet connection
• Verify the backend is online at dtcmvpete.com

"Authentication required: No partner context found"

• Your API key might be invalid or revoked
• Generate a new API key in the web app

🔒 Security

• API Key Authentication: Your API key is linked to your user account
• Role-Based Access Control: Tools and data access depend on your is_admin flag
• Partner Users: All queries scoped to your airtable_company_id (partner ID)
• Admin Users: Can access cross-partner data via admin-specific tools
• Same Security as Web App: Uses identical access control

Keep your API key secret! Don't commit it to git or share it.

📚 What's Different from the Python Version?

This Node.js version is much easier to use:

| Feature | Python Version | Node.js Version | |---------|---------------|-----------------| | Installation | Install Python, uv, clone repo, manual config | One npx command | | Configuration | Edit JSON with absolute paths | Auto-configured | | Updates | Git pull, reinstall | Automatic (npx always uses latest) | | Dependencies | Python 3.10+, uv, manual setup | Node.js only (usually pre-installed) | | Platform | Requires Python environment | Works anywhere Node.js runs |

🆘 Support

• MCP Server Issues: Create a GitHub issue
• Account/API Key Issues: Contact DTCMVP support
• Claude Desktop Issues: Check Anthropic docs

📄 License

MIT