@prsna_ai/mcp-proxy v1.0.7

PRSNA MCP Proxy

A local MCP (Model Context Protocol) proxy server that bridges Claude Desktop and other MCP clients to the remote PRSNA personality profiles server.

Overview

This package allows you to use PRSNA's personality profile tools in Claude Desktop and other MCP clients that only support local servers. The proxy forwards all requests to PRSNA's remote MCP server with proper authentication.

Quick Start

1. Get Your PRSNA API Token

1. Visit PRSNA Profile Settings
2. Navigate to the "MCP Tokens" tab
3. Generate a new MCP token
4. Copy the token (starts with prsna_mcp_)

2. Configure Claude Desktop

Add this configuration to your Claude Desktop MCP settings:

File: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "prsna": {
      "command": "npx",
      "args": ["-y", "@prsna/mcp-proxy"],
      "env": {
        "PRSNA_API_TOKEN": "your_token_here"
      }
    }
  }
}

3. Restart Claude Desktop

After saving the configuration, restart Claude Desktop to activate the PRSNA integration.

Available Tools

Once configured, you'll have access to these PRSNA tools in Claude Desktop:

• list_personality_profiles - List all your saved personality profiles
• search_personality_profiles - Search profiles by name, company, or job title
• get_personality_context - Get AI-ready personality data for communication
• get_communication_tips - Get specific communication recommendations
• mention_person - Find and get context for a person by name (@mention functionality)
• prsna_login - Alternative email/password authentication (not recommended)

Usage Examples

List All Personality Profiles

Can you show me all my personality profiles?

Get Communication Tips

Get communication tips for person ID 6840e3b5185ba2e4fb7bc322 for an email context

Search for Someone

Search for profiles containing "Mark Penn"

@Mention Functionality

Get personality context for Josh Beatty for our upcoming meeting

Configuration Options

Environment Variables

• PRSNA_API_TOKEN (required) - Your PRSNA MCP token from profile settings

Alternative Configuration

You can also run the proxy directly with Node.js:

# Install globally
npm install -g @prsna/mcp-proxy

# Set your token
export PRSNA_API_TOKEN="your_token_here"

# Run the proxy
prsna-mcp-proxy

Troubleshooting

Common Issues

"PRSNA_API_TOKEN environment variable is required"

• Make sure you've set your API token in the Claude Desktop configuration
• Verify the token starts with prsna_mcp_

"Network error"

• Check your internet connection
• Verify your API token is valid and hasn't expired

Tools not appearing in Claude Desktop

• Restart Claude Desktop after configuration changes
• Check the configuration file syntax is valid JSON

Debug Mode

To see detailed logs, you can run the proxy manually:

PRSNA_API_TOKEN="your_token" npx @prsna/mcp-proxy

Check the console output for connection and authentication status.

Getting Help

• Visit PRSNA Support
• Check the GitHub repository for issues
• Email support@prsna.ai for assistance

Security

• Your API token is transmitted securely via HTTPS
• The proxy only forwards requests to the official PRSNA server
• No data is stored locally by the proxy

License

MIT License - see LICENSE file for details.

Contributing

Contributions welcome! Please see the GitHub repository for contribution guidelines.