@onbreeze/affinity-mcp-connector

Local stdio bridge that connects Claude Desktop to the Affinity MCP Cloud backend.

Latest Version: Automatically updated with each release.

Quick Start

npx @onbreeze/affinity-mcp-connector@latest

Claude Desktop Configuration

Add this to your Claude Desktop config file:

{
  "mcpServers": {
    "affinity-v1": {
      "command": "npx",
      "args": ["-y", "@onbreeze/affinity-mcp-connector@latest"],
      "env": {
        "BIFROST_API_URL": "https://bifrost-v7eqq3533a-uc.a.run.app",
        "BIFROST_API_KEY": "<your-pat-from-frontend>"
      }
    }
  }
}

Environment Variables

• BIFROST_API_URL - Cloud backend URL (required)
• BIFROST_API_KEY - Personal Access Token from frontend (required)
• DEBUG - Set to 1 to enable debug logging to stderr

Getting Your API Key

1. Visit the Bifrost frontend
2. Log in or create an account
3. Add your Affinity API key in Integrations
4. Generate a Personal Access Token (PAT)
5. Copy the PAT to your Claude config

Available Tools

Phase 1

• whoami - Get information about your Affinity account

Coming Soon (Phase 2+)

• Full Affinity CRM tool suite
• Lists, fields, persons, organizations
• Notes and interactions

Troubleshooting

401 Unauthorized

• Check that your PAT is valid
• Ensure the token hasn't expired
• Verify you're using the correct API URL

424 Failed Dependency

• Add your Affinity API key in the frontend Integrations page
• Ensure your Affinity key is valid

Connection Issues

• Verify the backend is accessible
• Check your internet connection
• Try with DEBUG=1 for more details

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm run dev

Support

Report issues at: https://github.com/mikeOnBreeze/obz-bifrost/issues

License

MIT