npm package: @prsna_ai/mcp-proxy
Description: MCP proxy server for PRSNA personality profiles integration
Author: PRSNA
Latest version: 1.0.7
Deprecated: This package has been replaced by @prsna_ai/mcp-server. Please use the new package instead.

# 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](https://persona-4idu0goix-joshs-projects-c8160a4e.vercel.app/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`

```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:

```bash
# 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:

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

Check the console output for connection and authentication status.

### Getting Help

- Visit [PRSNA Support](https://persona-4idu0goix-joshs-projects-c8160a4e.vercel.app/support)
- Check the [GitHub repository](https://github.com/your-username/prsna-mcp-proxy) 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.