How to Use the Affinity MCP in Claude

Bring your team's relationship intelligence straight into Claude Desktop to draft emails and brief documents using real MCP tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Affinity MCP to Claude Desktop

Create your Vinkius account to connect Affinity to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Affinity with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map networks inside Claude Desktop

Your agent needs context before writing a pitch or prepping a briefing doc. Instead of manually copying details from your CRM, you just ask it to check `list_organizations` for a target company. It immediately pulls up the relevant institutions. You can then tell it to run `list_persons` to find exactly who your team knows there. The agent reads the paginated results and drafts your outreach based on actual human connections.

Read the room with this MCP Server

Context is everything when dealing with investors or enterprise buyers. You need to know what was said last week before you hit send today. Calling `list_interactions` dumps the chronological logs of emails, meetings, and calls directly into your chat window. You get the raw history of who talked to whom, letting your AI client summarize the entire relationship history in seconds.

Track pipeline movement live

Deal flow lives in pipelines. You want to see who moved to the next stage without opening another tab. Hit `list_smart_lists` to grab your configured pipelines. Then feed that ID into `list_list_entries` to see exactly which people or companies sit in that specific bucket right now.

Setup guide

Set up Affinity MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Affinity MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Affinity MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under affinity-mcp.

json

{
  "mcpServers": {
    "affinity-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Affinity. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Affinity now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Affinity MCP in Claude Desktop

Open your browser and head to claude.ai settings. Add a custom connector under Integrations by pasting your Vinkius MCP server URL and authenticating.

Yes. The agent uses the interactions tool to read synced email logs and meeting notes. It summarizes that history so you know exactly where a deal stands.

You need the correct list ID first. Ask your client to run the smart lists tool to get the catalog, then use that ID to pull the specific entries.

It works across Free, Pro, Team, and Enterprise tiers. You just need a valid Vinkius MCP endpoint token.

Vinkius routes your API requests through a V8 Isolate Sandbox. Your synced emails, call logs, and meeting notes hit an ephemeral environment that dies immediately after the request finishes. Zero trust means nothing gets stored.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript