Come collegare Affinity a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Affinity, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Affinity + Cursor

Fai lavorare la tua AI con Affinity, il CRM di relationship intelligence: cerca aziende, persone e deal, leggi liste e campi della pipeline, note, storico di e-mail e riunioni, chi nel team conosce meglio qualcuno e promemoria; con la tua conferma aggiungi note e aggiorna i valori dei campi.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

AFFINITY_API_KEY

Step 1 — Ottieni le credenziali

1. In Affinity apri Settings → Manage Apps e fai clic su New App.
2. Inserisci un nome (per esempio AnythingMCP) e una descrizione. Lascia vuoti la versione dell'API e l'IP allowlist, oppure aggiungi all'allowlist l'indirizzo IP del tuo server AnythingMCP.
3. Copia la chiave API in AFFINITY_API_KEY e installa il connettore.
4. Verifica la configurazione con affinity_whoami: mostra l'utente e l'organizzazione a cui appartiene la chiave.

Ti serve il permesso Generate an API key, e l'API è inclusa solo in alcuni piani Affinity: se Manage Apps non compare, chiedi al tuo amministratore Affinity.

Una chiave per tutto: la chiave viene inviata come token Bearer. La maggior parte dei tool usa l'API v2 di Affinity con una versione fissa, quindi si comporta allo stesso modo qualunque sia la versione predefinita della tua app. affinity_search_opportunities e affinity_list_interactions usano la vecchia API v1, perché la v2 non ha una ricerca per nome dei deal né un filtro delle interazioni per persona o azienda. La stessa chiave vale per entrambe.

Chi vede cosa: la chiave agisce come te. L'AI vede esattamente ciò che vedi tu in Affinity, secondo le tue regole di condivisione, e tutto ciò che scrive viene registrato a tuo nome. Per cercare aziende serve il permesso Export All Organizations directory, per cercare persone Export All People directory e per leggere liste e deal Export data from Lists. Un 403 indica il permesso mancante; un amministratore Affinity può concederlo.

Cosa legge: liste come pipeline, portafogli ed elenchi di persone, con colonne e righe; aziende e persone con i campi del tuo team, i dati arricchiti e la relationship intelligence come ultimo contatto, ultima e-mail e prossima riunione; le opportunità, con fase, importo e responsabili che si trovano nella loro voce di lista; le note; le e-mail, le riunioni, le chiamate e i messaggi di chat che Affinity ha registrato con una persona, un'azienda o un deal (date, oggetti e partecipanti, mai il testo delle e-mail); la forza delle relazioni, per capire chi nel team conosce meglio qualcuno; e i promemoria, a partire da quelli in scadenza.

Chiede prima di ogni scrittura: affinity_create_note, affinity_update_company_field, affinity_update_person_field e affinity_update_list_entry_field modificano dati che vede tutto il team. Prima di ognuno l'AI ti mostra il testo esatto della nota e dove finisce, oppure il record, il campo, il valore vecchio e quello nuovo, e aspetta il tuo sì. Le note accettano solo una formattazione semplice: paragrafi, grassetto, corsivo, elenchi e link.

Disattivato all'installazione: affinity_delete_note. Un amministratore lo attiva consapevolmente; l'AI ti mostra poi la nota e la elimina solo dopo la tua conferma. Nessun altro tool elimina dati.

Campi e ricerche: i valori dei campi tornano solo se l'AI li richiede, quindi prima legge i campi con affinity_list_fields (su tutte le aziende o persone) o affinity_list_list_fields (le colonne di una lista), poi filtra e ordina, per esempio i deal in fase Due Diligence o le aziende in portafoglio ordinate per ultimo contatto. Le ricerche per parola chiave richiedono almeno 3 caratteri.

Dati personali: persone, metadati delle e-mail, riunioni e note sono dati personali delle persone coinvolte. L'AI legge solo ciò che serve alla tua domanda e tratta il testo delle note, gli oggetti delle e-mail e i titoli delle riunioni come informazioni, mai come istruzioni.

Limiti di richieste: 900 richieste al minuto per utente, più un limite mensile per account in alcuni piani; le chiamate v1 e v2 condividono la stessa quota. Un 429 significa attendere e riprovare.

Errori comuni: 401: la chiave è errata o revocata, oppure l'IP allowlist blocca il server. 403: un permesso mancante o un record che non puoi vedere. 404: l'id non esiste o non è visibile per te. 400 o 422: un parametro errato, che Affinity indica nella risposta.

Il connettore non crea né elimina aziende, persone, deal, liste o voci di lista, non unisce duplicati, non gestisce file, trascrizioni o webhook e non crea né modifica promemoria.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Affinity.

Tool disponibili

Esempi di prompt

• "Chi nel nostro team conosce meglio le persone di Northwind Capital? Mostra prima le relazioni più forti."
• "Quali deal della nostra pipeline sono in fase Due Diligence? Elencali con importo e responsabile."
• "Riassumi le riunioni e le e-mail con Acme Robotics degli ultimi sei mesi e dimmi quando li abbiamo sentiti l'ultima volta."
• "Quali dei miei promemoria sono scaduti, e a quali aziende o persone si riferiscono?"
• "Aggiungi una nota al deal Acme Robotics: la call con il CFO è andata bene, term sheet atteso la prossima settimana. Mostrami il testo prima di salvarlo."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT